Conectează o aplicație la Claude în vreo cinci minute

de The Spinrun team5 min de cititGhiduri

Claude vorbește MCP, ceea ce înseamnă că poate folosi orice instrument îi oferă un server MCP. Obstacolul obișnuit nu este Claude. Este că cineva trebuie să ruleze acel server, să înregistreze o aplicație OAuth la fiecare furnizor ale cărui date vrei să le atingi, să păstreze token-urile într-un loc sigur și să le reînnoiască înainte să expire.

Exact partea asta dispare aici. Claude se conectează la un singur URL, iar tot ce se află în spatele lui este deja autorizat.

De ce ai nevoie

Un cont și o aplicație la care vrei să ajungă Claude. Nu ai nimic de instalat local și niciun server de pus în funcțiune — gateway-ul este un endpoint HTTP găzduit, așa că singurul lucru care se schimbă pe calculatorul tău este o linie de configurare.

1. Conectează aplicația

Din spațiul tău de lucru, deschide Apps, caută kitul dorit și apasă Connect. Vei fi trimis la ecranul de consimțământ al furnizorului — al Google, al Notion, al Slack — și vei aproba permisiunile.

Merită știute două lucruri despre ce se întâmplă mai departe.

Autorizarea este legată de spațiul de lucru care a creat-o și nu devine niciodată o valoare pe care trebuie să o manipulezi tu. Pentru conectorii pe care Spinrun îi rulează el însuși, credențialul ajunge într-un seif criptat pe care doar rolul de server îl poate decripta; pentru restul rămâne la furnizorul de conexiuni, iar Spinrun păstrează doar o referință. În ambele cazuri, nu există niciun token într-un fișier de configurare de pe laptopul tău.

Iar conectarea aceleiași aplicații de două ori îți dă două conexiuni, nu una. Două spații Slack sau două conturi Google au credențiale separate, deci rămân separate și aici — ceea ce contează mai mult decât pare din momentul în care un agent poate ajunge la amândouă.

2. Stabilește regulile înainte să predai accesul

Fă asta înainte ca un agent să primească acces, nu după. Deschide setările aplicației și stabilește-i politica — trei rânduri pentru fiecare aplicație, fiecare permis sau blocat:

AplicațieCitireScriereDistructiv
GmailPermisPermisBlocat
NotionPermisPermisBlocat

Regula este verificată în gateway, la fiecare apel, înainte să ajungă la Google sau la Notion. Nu este un sfat pentru model și nu este un prompt din care modelul se poate scuza. Instrumentele blocate nici măcar nu apar în lista pe care o primește Claude.

Clasificatorul citește verbul din numele fiecărui instrument — GMAIL_SEND_EMAIL este scriere, GMAIL_LIST_MESSAGES este citire, GMAIL_TRASH_MESSAGE este distructiv — iar ce nu poate încadra tratează ca scriere, nu ca citire. Mai multe despre cum funcționează și unde greșește, în Permisiunile agenților țin de gateway.

3. Îndreaptă Claude spre gateway

Deschide setările din Claude, adaugă un server MCP la distanță și lipește URL-ul gateway-ului:

URL server MCP la distanță
https://spinrun.ai/mcp

Asta este toată configurarea. Nu există un al doilea câmp de completat.

Nu ai nicio cheie API de lipit, pentru că Claude este unul dintre clienții care pot finaliza o autorizare în browser: prima dată când ajunge la gateway primește un 401 cu antetul WWW-Authenticate, îl urmează până la pagina de autentificare și te întreabă la ce spațiu de lucru are voie să ajungă.

4. Cere ceva real

Nu un test. Ceva ce altfel ai fi făcut de mână:

Găsește fiecare email din săptămâna trecută în care cineva a cerut o prezentare și adaugă un rând în baza Notion „Inbound” pentru fiecare, cu numele, compania și data la care a scris.

Claude se uită la instrumentele la care ajunge, caută în Gmail și scrie rândurile. Dacă încearcă ceva ce ai blocat, îți va spune ce regulă l-a oprit, în loc să eșueze misterios.

Când sunt mai multe instrumente decât vrea Claude să citească

Un spațiu cu o duzină de aplicații conectate oferă multe instrumente, și fiecare costă context înainte ca discuția să înceapă. Două lucruri ajută.

Gateway-ul are un mod compact care nu mai trimite deloc lista completă. În schimb, Claude primește câteva instrumente de căutare și caută ce îi trebuie — spinrun_search_tools ca să găsească un instrument descriind sarcina, spinrun_get_tool_schemas ca să îi citească argumentele. Ambele sunt gratuite: un spațiu care caută înainte să apeleze trebuie să iasă mai ieftin decât unul care ghicește, altfel funcția ar pleda împotriva ei înseși.

Rezultatele mari sunt tratate la fel. Ce depășește un prag este scris în stocare sub un identificator opac și păstrat o zi, iar Claude îl citește pagină cu pagină, în loc să înghită un CSV de 4 MB dintr-odată.

Ce urmează

Uită-te la jurnalul de activitate. Fiecare apel făcut de agent este un rând — instrumentul, rezultatul, durata, ce conexiune a folosit și în numele cui a acționat. Citirea lui după prima sarcină reală este cel mai rapid mod de a-ți face o imagine corectă despre ce face agentul tău, iar imaginea aceea e de obicei și mai puțin misterioasă, și mai interesantă decât te aștepți.

Apoi conectează a doua aplicație. Aproape tot ce merită automatizat se întinde peste două — biblioteca de cazuri de utilizare este în mare parte exact asta.

Înainte să se încarce ceva

Am vrea să activăm analiza traficului, ca să vedem ce pagini merită păstrate. Nu s-a încărcat încă nimic și nu se va încărca nimic până nu alegi. Cookie-urile care te țin autentificat și îți rețin limba nu fac parte din asta.

Citește Politica de cookie-uri