Claude Code se descurcă foarte bine cu depozitul din fața lui și nu știe nimic despre restul. Tichetul pe care îl repari trăiește într-un tracker, raportul care l-a pornit trăiește în Slack, iar deployment-ul care l-a stricat trăiește într-un dashboard — și nimic din toate astea nu este pe disc.
MCP este felul în care închizi golul, și e nevoie de o singură comandă.
Comanda
claude mcp add --transport http spinrun https://spinrun.ai/mcp \
--header "x-spinrun-client: claude-code"Trei lucruri de acolo merită numite.
--transport http nu este opțional. Claude Code folosește implicit stdio, care
așteaptă un proces local pe care să îl pornească; gateway-ul este un endpoint
HTTP la distanță, iar flagul este cel care îi spune asta. Fără el, înregistrarea
reușește și apoi nu se conectează niciodată.
spinrun este numele sub care se înregistrează serverul. Îl vei vedea în /mcp
în Claude Code și este numele pe care îl așteaptă restul uneltelor Spinrun, deci
merită păstrat.
x-spinrun-client este atribuire, nu autentificare. Nu poartă niciun secret și
este motivul pentru care jurnalul de activitate îți poate spune că un apel a
venit din Claude Code, nu dintr-un editor — util prima dată când doi agenți de-ai
tăi nu sunt de acord despre ce s-a întâmplat.
Autorizează în browser
Prima cerere a lui Claude Code 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. Claude Code îl urmează, deschide o fereastră de
browser și continuă de acolo. Te autentifici, alegi la ce spațiu de lucru are
voie să ajungă și ai terminat — fără nicio cheie de copiat, iar accesul poate fi
revocat oricând din Settings → Applications.
Sau lasă agentul să o facă
Există o cale mai scurtă, care i se potrivește mai bine unui agent de terminal decât copiatul de comenzi. Lipește asta în Claude Code:
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.Înregistrează serverul, deschide browserul ca să autorizezi și îți spune ce a găsit — ceea ce este și cel mai rapid mod de a confirma că a mers, pentru că o listă de instrumente este o dovadă, iar un mesaj de succes nu este.
La ce ajunge
La ce a conectat spațiul tău de lucru. Instrumentele vin denumite
TOOLKIT_VERB_OBJECT — GITHUB_CREATE_ISSUE, SLACK_SEND_MESSAGE,
LINEAR_LIST_ISSUES — ceea ce se citește destul de bine încât rareori trebuie să
cauți ceva.
Dacă ai conectat aceeași aplicație de două ori, instrumentele celei de-a doua
conexiuni poartă un sufix care o numește: GITHUB_CREATE_ISSUE__work alături de
GITHUB_CREATE_ISSUE__oss. Numele simplu se rezolvă în continuare către
conexiunea implicită, așa că adăugarea unui al doilea cont nu strică niciodată o
configurație care funcționa.
Stabilește regulile mai întâi
Claude Code este un agent cu un shell, iar tu ești pe cale să îi dai o a doua pereche de mâini. Înainte de asta, deschide fiecare aplicație conectată și stabilește-i politica — citire, scriere și distructiv, fiecare permisă sau blocată.
Cea la care merită să te gândești este „distructiv”. Într-un depozit, „fă curățenie” este o instrucțiune rezonabilă; într-un tracker poate însemna închiderea a treizeci de tichete. Blocarea acțiunilor distructive per aplicație durează un minut și elimină întreaga clasă de probleme, iar agentul primește un refuz clar care numește regula, nu un eșec misterios.
O primă sarcină care merită încercată
Ceva care se întinde peste depozit și peste lumea din afara lui:
Uită-te la ultimele trei commit-uri de pe branch-ul ăsta, găsește tichetul Linear pe care îl referă și postează un rezumat al schimbărilor în canalul #eng din Slack.
Claude Code citește singur commit-urile, folosește LINEAR_GET_ISSUE pentru
tichet și SLACK_SEND_MESSAGE pentru postare. Nimic din toate astea nu cere să
ieși din terminal și nimic nu a cerut să scrii o integrare.
Cum ții lista de instrumente scurtă
Un spațiu cu multe aplicații conectate trimite multe definiții de instrumente, iar Claude Code le plătește în context la fiecare sesiune. Dacă începe să deranjeze, treci gateway-ul în mod compact: nu mai trimite lista completă și îi dă agentului instrumente de căutare, ca să găsească ce îi trebuie când îi trebuie. Ambele instrumente de descoperire sunt gratuite.
Ce urmează
- Permisiunile agenților țin de gateway — ce face de fapt clasificatorul citire/scriere/distructiv
- Catalogul de kituri — ce poți conecta
- Cazuri de utilizare — sarcini care deja merită predate