Jithox verbinden · terminal

Verbind de AI die je al gebruikt met Jithox met één opdracht

De Connect Kit herkent Claude Code, Codex CLI, Gemini CLI of Cursor, toont de exacte wijziging, vraagt eerst, maakt een back-up, schrijft alleen het Jithox-blok en vertelt hoe je het ongedaan maakt. Je client meldt zich daarna zelf veilig aan met OAuth — jij keurt de rechten goed op jithox.com — zodat er nooit een credential in een bestand staat. Niets wordt gedownload, niets gebeurt zonder je ja.

Kopieer de opdracht en voer ze uit in een terminal. Node 20 of nieuwer is alles wat nodig is.

npx jithox connect

1 · Installeren en uitvoeren

Eén opdracht; npx haalt de kit op en voert ze uit. Ze herkent je client en toont het plan voor er iets gebeurt. Daarna meld je je veilig aan met OAuth: de client opent jithox.com, jij keurt goed welke controles hij mag gebruiken, en de client bewaart zijn eigen kortlevende tokens.

npx jithox doctor
npx jithox connect
npx jithox auth login

Geen download en geen account voor de doctor en het voorbeeld. Aanmelden vraagt je Jithox-account, meer niet.

2 · Wat het verandert

Alleen het jithox-blok in het configuratiebestand dat je client al leest — en met OAuth is dat blok alleen het eindpunt. Al de rest — andere servers, commentaar, volgorde, inspringing — blijft byte voor byte gelijk.

Claude Code: ~/.claude.json → mcpServers.jithox, daarna `claude mcp login jithox`
Codex CLI: ~/.codex/config.toml → [mcp_servers.jithox], daarna `codex mcp login jithox`
Gemini CLI: ~/.gemini/settings.json → mcpServers.jithox, daarna `/mcp auth jithox`
Cursor: .cursor/mcp.json in het project, of ~/.cursor/mcp.json, daarna “Needs login”
Claude Desktop en elke andere MCP-client: het eindpunt; de client meldt zich aan wanneer hij daarom vraagt
Elke HTTP-agent: `npx jithox auth login` geeft een token van tien minuten dat zichzelf vernieuwt
Compatibiliteitsfallback — minder aanbevolen: een statische verbindingscredential van je accountpagina (`--auth static`), bewaard in ~/.jithox/connection, alleen door jou leesbaar

Eindpunt

https://jithox.com/api/agent-connection/v1/mcp

3 · Eerst een voorbeeld

Voor er iets wordt geschreven zie je de client, het bestand, de servernaam, het eindpunt, de authenticatiemethode (standaard OAuth), de scopes, de bestanden die veranderen, het back-uppad, de test die volgt en de terugdraaiopdracht — daarna een diff. Met OAuth bevat die diff geen enkel geheim.

CLIENT            Gemini CLI
CONFIG_PATH       ~/.gemini/settings.json
SERVER_NAME       jithox
ENDPOINT          https://jithox.com/api/agent-connection/v1/mcp
AUTH_METHOD       OAuth 2.1 — the client signs in itself (Authorization Code + PKCE S256); no credential in any file
REQUESTED_SCOPES  tools:discover
FILES_CHANGED     ~/.gemini/settings.json
BACKUP_PATH       ~/.gemini/settings.json.jithox-backup-<timestamp>
TEST_AFTER_WRITE  initialize; tools/list; sign-in accepted (nothing executed)
ROLLBACK_COMMAND  npx jithox disconnect --client gemini

Apply this Jithox connection? [y/N]

Het standaardantwoord is Nee. Er is geen --yes voor iets dat een credential opslaat, je afmeldt of geld kan kosten.

4 · Testen

Na het schrijven voert de kit initialize en tools/list uit, en dan één sonde die bewijst dat je aanmelding aanvaard wordt zonder iets uit te voeren of aan te rekenen. Elke fout noemt een herstelstap. De statusregel zegt wat echt bewezen is:

npx jithox test

CONFIG_VALIDATED: het bestand klopt; de gateway werd niet met een aanmelding bereikt
OAUTH_FLOW_TESTED: de aanmeldflow liep tegen de provider van het lab
RUNTIME_TESTED: de gateway aanvaardde de aanmelding op deze machine
FIXTURE_ONLY: de lokale sandbox, nooit productie

5 · Ongedaan maken

disconnect verwijdert alleen het jithox-blok (eerst een back-up) en controleert wat de gateway nu antwoordt. auth logout trekt je aanmelding in op jithox.com, wist de lokale tokens en bewijst dat het oude token dood is. --restore zet een eerdere back-up terug.

npx jithox disconnect
npx jithox auth logout

Eén ding dat alleen een persoon doet

Een verbinding intrekken kan ook altijd op de accountpagina; één ingetrokken client breekt nooit een andere. Accountpagina

Wat de kit nooit doet

Geen token of credential is ooit een argument, staat in de shellgeschiedenis, wordt getoond, staat in logs of crashuitvoer of in een back-up, of gaat ergens heen behalve naar jithox.com.
Geen aankoop, geen opwaardering, geen betaalde oproep, geen automatische herhaling, geen ruimere rechten dan je goedkeurde.
Geen bestand wordt volledig overschreven; geen symlink wordt gevolgd; geen bestand van een andere gebruiker wordt aangeraakt.
Geen telemetrie.

Details voor ontwikkelaars

Welke clients · Voor agents

Claude Code, Codex CLI, Gemini CLI en Cursor melden zich zelf aan met OAuth. Claude Desktop-connectors ook. Gewone HTTP-agents gebruiken de aanmelding van de kit. Elke client draagt wat echt getest is; niets heet gecertificeerd zonder echte uitvoering tegen productie.

npx jithox connect --prepare --client <client> --json schrijft niets, heeft geen aanmelding nodig en geeft het plan terug: de voorgestelde wijzigingen met een diff, de vereiste eigenaarsactie, de rechten, het terugdraaiplan, een hash en een vervaltijd. Geef het aan een persoon; die voert connect uit en meldt zich aan.

npx jithox connect --prepare --client <client> --json

LOCAL_SIMULATION · NOT_PRODUCTION · NO_REAL_DATA · NO_REAL_CHARGE

npx jithox connect --sandbox

Compatibiliteitsfallback — minder aanbevolen

npx jithox connect --auth static

Aanmelden en de rechten goedkeuren op het Jithox-toestemmingsscherm. De kit automatiseert nooit een browser en maakt nooit zelf een verbinding. Ook de statische credential (compatibiliteitsfallback) vraagt een persoon die ze op de accountpagina aanmaakt. Je verbindingen op de accountpagina

Quickstart voor ontwikkelaars · Wat moet je AI doen?