Ghid

Conectează Claude Code la traficul tău de rețea

O comandă în terminal și o autentificare în browser. După aceea, Claude Code poate citi ce tocmai a capturat telefonul tău, poate explica un flux de autentificare cu secretele mascate și poate acționa pe dispozitivele tale — fiecare instrument limitat la rolul tău și fiecare acțiune riscantă protejată de o confirmare.

Busymate își expune întregul dashboard — 454 instrumente care acoperă dispozitivele, traficul capturat, setările, regulile, exporturile și ferma de telefoane — ca server MCP pe un singur hostname. Claude Code vorbește MCP peste HTTP nativ, așa că conectarea înseamnă o singură comandă. Autentificarea este OAuth 2.1 standard: clientul se înregistrează singur, îți deschide browserul, te autentifici cu contul tău obișnuit Busymate și aprobi o dată, iar tokenul rezultat este cel purtat de fiecare apel de instrument. Nu există nicio cheie API de creat, lipit sau rotit.

Acest ghid parcurge conectarea de la un capăt la altul, apoi arată cele trei tipuri de prompturi care aduc valoare primele: citirea fluxului live, explicarea unui flux API capturat și acțiunea pe un dispozitiv. Acoperă și singurul obicei de întreținere care îți scutește un drum în browser — reconectarea după o actualizare a serverului, niciodată reautorizarea.

Înainte de a începe

De ce ai nevoie

Claude Code pe mașina ta, un cont Busymate și — ca să ai despre ce întreba — un dispozitiv care a capturat trafic.

  • Claude Code instalat, cu un terminal în care rulează comanda lui.

  • Un cont Busymate cu care te poți autentifica într-un browser — același cont pe care îl folosește dashboard-ul.

  • Cel puțin un dispozitiv asociat cu trafic recent: un iPhone, un Android, un client al proxy-ului sau un Chrome capturat. Ghidul pentru iPhone este drumul cel mai rapid.

  • Un rol cu capabilitățile pe care intenționezi să le folosești. Citirile au nevoie de acces de vizualizare; acțiuni precum retrimiterea unei cereri sau schimbarea setărilor unui dispozitiv au nevoie de acces de editare pe dispozitivele pe care le deții.

Pas cu pas

Urmează ordinea

Doi pași pentru conectare, unul pentru verificare, trei pentru a obține valoare, unul pentru a păstra totul sănătos.

  1. 01

    Adaugă serverul din terminal

    Rulează comanda de mai jos. Ea înregistrează Busymate ca server MCP la distanță pentru Claude Code, folosind transportul HTTP și endpoint-ul canonic. Nimic altceva nu este necesar în comandă — niciun token, niciun header, niciun id de client. Descoperirea instrumentelor este servită înainte de autentificare, așa că Claude Code poate deja lista ce oferă serverul.

    Singura comandă
    bash
    # Claude Code — add the server, then authorize in your browser on the first tool call
    claude mcp add --transport http busymate-devtools https://mcp.busymate.dev
  2. 02

    Autorizează în browser la primul apel de instrument

    Cere-i lui Claude Code orice are nevoie de un instrument și fluxul OAuth pornește: clientul se înregistrează la server, îți deschide browserul pe pagina de autentificare Busymate cu o provocare PKCE, te autentifici și aprobi, iar browserul returnează clientului un cod de unică folosință, pe care îl schimbă cu un token de acces. Claude Code confirmă conexiunea. Nu faci nimic din toate acestea manual; vezi pagina de autentificare o singură dată.

    Acel token este de același tip cu cel folosit de consolele integrate ale dashboard-ului și autentifică fiecare serviciu Busymate, nu doar MCP. Fiecare client pe care îl conectezi primește propria autorizare pe contul tău — revocabilă individual, toate acționând sub unicul tău rol, toate vizibile în jurnalul de audit.

  3. 03

    Verifică cu o întrebare doar de citire

    Începe cu ceva care doar citește. Întreabă ce dispozitive sunt online și ce a capturat recent unul dintre ele, sau ce hosturi au returnat un anumit status în ultima oră. Claude Code alege instrumentele potrivite, iar răspunsul vine din datele tale reale — nume de dispozitive, hosturi, căi, statusuri — nu dintr-o presupunere.

    Două prompturi inițiale care dovedesc conexiunea
    text
    Which of my devices are online right now, and what did the iPhone capture in the last 10 minutes?
    
    Across all my devices, which hosts returned 401 in the last hour?
  4. 04

    Cere-i să explice un flux API capturat

    Acesta este promptul pentru care există conexiunea. Numește un host pe care l-ai capturat de pe telefon — folosește hostname-ul complet cu punct, nu doar un nume de brand — și întreabă cum se autentifică aplicația. Claude Code citește headerele și corpurile reale ale cererilor și răspunsurilor, reconstituie fluxul și îți poate scrie o reproducere executabilă. Tokenurile, cookie-urile și credențialele din traficul capturat sunt tratate ca secrete și înlocuite cu substituenți în tot ce returnează.

    Explică fluxul de autentificare pe care telefonul tocmai l-a făcut
    text
    Look at the captured traffic for identity.example.com and tell me exactly how the app authenticates — the endpoint, the headers it needs, and the request body shape. Then write a curl command that reproduces the login call.
  5. 05

    Lasă-l să acționeze — în spatele unei confirmări

    Instrumentele care schimbă ceva — retrimiterea unei cereri, comutarea VPN-ului unui dispozitiv, rutarea traficului lui printr-un proxy din altă țară, editarea regulilor de blocare — sunt protejate de confirmare pe server: Claude Code îți arată ce urmează să facă și așteaptă acordul tău. Totul rulează în numele tău, limitat la capabilitățile rolului tău și la dispozitivele pe care le deții, așa că un client nu poate face niciodată mai mult decât ai putea tu în dashboard.

    Un prompt de acțiune — fiecare scriere întreabă înainte de a rula
    text
    Resend the last failed checkout request from my iPhone, then route that phone through a proxy in Germany and confirm its public IP changed.
  6. 06

    Combină-l cu restul seriei

    Tot ce fac celelalte ghiduri manual este aici o propoziție: cere un export HAR pentru un host de azi, un mock 401 de unică folosință pe un endpoint de autentificare, tiparele curente de breakpoint sau o captură de ecran de pe fiecare telefon din fermă. Claude Code mapează cuvintele pe instrumente; se aplică aceleași reguli de rol și confirmare.

  7. 07

    După o actualizare a serverului: reconectează, nu reautoriza niciodată

    Serverul este redesfășurat des și apar instrumente noi. Un client conectat înainte de o desfășurare poate ține o listă de instrumente învechită — un instrument pare să lipsească sau o descriere este depășită. Majoritatea clienților preiau schimbarea singuri pentru că serverul o anunță; dacă al tău nu o face, repornește sesiunea Claude Code. Nu te deconecta și nu șterge serverul: tokenul tău supraviețuiește desfășurărilor, iar reconsimțirea te costă doar un drum în browser. Dacă vrei vreodată o readăugare curată, șterge mai întâi intrarea și adaug-o din nou — autorizarea supraviețuiește, așa că nu ți se va cere să te autentifici a doua oară.

    O readăugare curată păstrează autorizarea existentă
    bash
    claude mcp remove busymate-devtools
    claude mcp add --transport http busymate-devtools https://mcp.busymate.dev

Depanare

Ce poate merge prost

Fiecare dintre acestea arată ca o pană și este de fapt protocolul funcționând exact conform specificației.

  • Endpoint-ul răspunde 401 când îl deschid în browser

    Așa spune specificația. O cerere simplă returnează 401 cu provocarea OAuth care îi spune clientului unde să găsească fluxul de autentificare. Clienții MCP continuă automat de la acea provocare; nimic nu este căzut.

  • Fereastra browserului nu s-a deschis niciodată

    Claude Code afișează și URL-ul de autorizare. Copiază-l în orice browser; fluxul este o autentificare web obișnuită și redă controlul clientului la final.

  • Instrumentele sunt listate, dar fiecare apel este refuzat

    Descoperirea este servită înainte de autentificare; apelarea oricărui instrument necesită autorizarea OAuth. Finalizează autorizarea în browser pe care a pornit-o clientul, sau declanșeaz-o din nou dacă tokenul a fost revocat, apoi reîncearcă.

  • Un instrument pe care îl văd în documentație lipsește

    Listă de instrumente învechită după o desfășurare. Repornește sesiunea ca clientul să redescopere suprafața. Dacă lipsește în continuare, rolul tău s-ar putea să nu aibă capabilitatea din spatele acelui instrument.

  • O acțiune a fost refuzată pentru un dispozitiv pe care îl văd

    Acțiunile sunt limitate la dispozitivele pe care le deții și la capabilitățile de editare ale rolului tău. Cere unui administrator al spațiului de lucru să îți acorde capabilitatea, sau rulează acțiunea pe propriul dispozitiv.

Întrebări frecvente

Întrebări frecvente

Există o cheie API pe care ar trebui să o păstrez undeva?

Nu. Accesul este o autorizare OAuth legată de contul tău și de acel client. Revoc-o din dashboard dacă pierzi o mașină; nimic nu trebuie rotit.

Funcționează la fel în Cursor, VS Code sau Claude Desktop?

Da — orice client care vorbește transportul HTTP și OAuth 2.1 cu înregistrare dinamică a clientului se conectează la același endpoint. Pagina de instalare are configurația de copiat-lipit și linkuri cu un singur clic pentru fiecare.

Poate scurge tokenurile pe care le vede în traficul meu?

Credențialele capturate sunt mascate în explicații și în fragmentele de reproducere, citirile sunt limitate la rolul și dispozitivele tale, iar scrierile sunt protejate de confirmare. Tratează un export HAR brut ca sensibil; răspunsurile agentului nu sunt.

O comandă, apoi doar întreabă

Adaugă serverul, aprobă o dată în browser și dă traficul capturat de telefonul tău agentului care îl poate explica.

Ask your mate