Cursor își citește serverele MCP dintr-un fișier JSON. Majoritatea ghidurilor petrec apoi o mie de cuvinte explicând cum să rulezi acele servere — câte un proces pentru fiecare integrare, fiecare cu propria aplicație OAuth și propriul token de ținut în viață.
Aceasta este varianta în care adaugi o singură intrare și te oprești.
Configurația
{
"mcpServers": {
"spinrun": {
"url": "https://spinrun.ai/mcp",
"headers": {
"x-spinrun-client": "cursor"
}
}
}
}Repornește Cursor. Nu există nicio cheie în acel bloc, intenționat: Cursor deschide un browser la prima conectare, alegi un spațiu de lucru acolo, iar instrumentele apar.
Dacă preferi să nu editezi JSON de mână, spinrun install cursor scrie același
bloc în același fișier — CLI-ul și pagina asta sunt generate dintr-o singură
definiție, deci nu pot fi în dezacord despre cum arată o configurație care merge.
Singurul antet
x-spinrun-client nu poartă niciun secret. Îi spune jurnalului de activitate ce
client a făcut un apel, ceea ce îți permite să răspunzi la „am fost eu în Cursor
sau jobul programat?” fără să ghicești. Nimic altceva nu trebuie să fie în acel
bloc: Cursor se autorizează în browser, iar instrumentele pe care le vede apoi
sunt conexiunile pe care le vezi tu, pentru că acționează ca tine.
Ce primește Cursor
Fiecare instrument pe care spațiul tău l-a conectat, denumit
TOOLKIT_VERB_OBJECT: GITHUB_CREATE_ISSUE, SLACK_SEND_MESSAGE,
NOTION_CREATE_PAGE. Cursor le listează sub numele serverului înregistrat și le
poți apela din panoul de agent ca pe orice alt instrument.
Partea interesantă nu este vreun instrument anume. Este că Cursor avea deja codul și acum are și contextul din jurul codului — tichetul care descrie bugul, firul în care cineva l-a raportat, înregistrarea din CRM a clientului care l-a lovit.
Stabilește regulile înainte să deschizi ușa
Cursor este un editor cu un agent în el, iar agentul e pe cale să poată scrie în
sisteme care nu sunt sub control de versiune. O modificare greșită într-un
depozit este la un git checkout distanță de a fi anulată. O înregistrare
ștearsă din CRM nu este.
Setează întâi politica fiecărei aplicații conectate — citire, scriere și distructiv, fiecare permisă sau blocată. Blocarea acțiunilor distructive peste tot durează aproximativ un minut, iar apoi poți relaxa acolo unde ai un motiv.
Două conturi, un singur editor
Conectează aceeași aplicație de două ori — un Slack de serviciu și unul de
comunitate, două conturi GitHub — și fiecare conexiune își păstrează propriul
credențial. Instrumentele lor sunt adresate separat printr-un sufix:
SLACK_SEND_MESSAGE__work și SLACK_SEND_MESSAGE__community.
Numele simplu continuă să ducă la conexiunea implicită, deci asta nu strică niciodată o configurație care funcționa înainte să adaugi al doilea cont. Iar sufixul este doar rutare: permisiunile și jurnalul de activitate se leagă de instrumentul de bază, deci o regulă setată se aplică pentru amândouă.
Când lista de instrumente se lungește
Fiecare definiție de instrument costă context la fiecare cerere. Dincolo de un anumit număr de aplicații conectate, asta devine costul dominant al faptului că sunt conectate.
Modul compact este răspunsul: gateway-ul nu mai trimite lista completă și oferă în schimb căutare, așa că Cursor caută un instrument când are nevoie de el. Căutarea și citirea schemelor sunt amândouă gratuite, în mod deliberat — calea ieftină trebuie să rămână mai ieftină decât ghicitul, altfel nimeni nu o alege.
Ce urmează
- Configurare MCP în VS Code — aproape același fișier, cu o diferență importantă
- Permisiunile agenților țin de gateway
- Catalogul de kituri