Agenții de terminal sunt cei mai ușor de configurat pentru MCP și cei mai ușor de greșit subtil, pentru că respectiva comandă de înregistrare arată asemănător peste tot, iar autentificarea nu.
Codex și Gemini CLI sunt o pereche bună de privit împreună: comenzi aproape identice, iar amândoi deschid implicit un browser în loc să ceară o cheie. Diferența este ce se întâmplă dacă acel flux din browser nu pornește pentru tine — unul dintre ei nu are nimic în plus la care să recurgă, celălalt are.
Codex
codex mcp add spinrun --url https://spinrun.ai/mcpFără antete. Nu este o omisiune — codex mcp add nu le acceptă, iar aici asta se
dovedește un avantaj.
Codex poate finaliza o autorizare în browser. Prima lui cerere ajunge la gateway
fără credențial, primește un 401 cu antetul WWW-Authenticate, îl urmează și
rulează fluxul OAuth. Se deschide un browser o dată, alegi un spațiu de lucru,
iar terminalul continuă de acolo.
Gemini CLI
gemini mcp add --transport http spinrun https://spinrun.ai/mcp \
--header "x-spinrun-client: gemini-cli"--transport http este obligatoriu. Gemini CLI folosește implicit stdio, care
așteaptă un proces local; gateway-ul este HTTP la distanță. Fără flag, serverul
se înregistrează și apoi nu se conectează niciodată, ceea ce arată ca „nu se
întâmplă nimic”, nu ca o eroare.
x-spinrun-client nu poartă niciun secret și există ca jurnalul de activitate
să poată atribui un apel lui Gemini CLI, nu să te lase să ghicești.
Prima cerere a lui Gemini CLI ajunge la gateway fără niciun credențial atașat și
primește înapoi un 401, care poartă un antet WWW-Authenticate ce indică unde
se face autorizarea. Îl urmează, deschide un browser o dată și alegi un spațiu
de lucru — același prompt pe care îl primește și Codex, doar cu încă un antet
în comandă.
Lasă agentul să se înregistreze singur
Amândoi sunt agenți de terminal, ceea ce înseamnă că există o cale mai scurtă decât copiatul de comenzi: spune-i agentului să o facă.
Adaugă serverul MCP Spinrun de la https://spinrun.ai/mcp și finalizează
autorizarea din browser pe care o cere, apoi enumeră instrumentele la care
ajungi acum.Partea utilă este finalul. O listă de instrumente este o dovadă că înregistrarea a funcționat; un mesaj de succes nu este.
Ce se întâmplă dacă browserul nu se deschide
Fiecare client cu care vorbește gateway-ul primește același 401 și același
antet WWW-Authenticate — fluxul din browser nu are un tratament special pentru
niciun client, deci nimic de aici este o promisiune pe care unul o ține și altul
nu. Ce diferă este ce mai rămâne de încercat dacă nu pornește pentru tine.
| Client | Înregistrare | Dacă browserul nu se deschide |
|---|---|---|
| Codex | codex mcp add | Nimic — CLI-ul nu are niciun flag pentru antete |
| Claude, ChatGPT | URL server MCP | Nimic — niciunul dintre clienți nu acceptă antete personalizate |
| Gemini CLI, Claude Code | Comandă CLI | O cheie, din dashboard |
| Cursor, VS Code, Windsurf | Fișier de configurare | O cheie, din dashboard |
Pentru cele două rânduri fără alternativă, absența nu e un bug de ocolit — e motivul pentru care o configurare Codex sau ChatGPT scursă nu poate scurge un credențial: nu a existat niciunul acolo de la bun început.
Stabilește regulile mai întâi
Un agent de terminal are un shell și acum are și conturile tale. Înainte ca acea combinație să existe, stabilește politica fiecărei aplicații conectate: citire, scriere și distructiv, fiecare permisă sau blocată, aplicate în gateway, nu cerute într-un prompt.