Conectează-ți asistentul AI la Unbox

Prezentare generală

Unbox MCP este destinat proprietarilor de conturi personale care doresc un asistent AI — în Cursor, Workbuddy, OpenClaw sau orice gazdă compatibilă MCP — care să lucreze cu e-mailul lor găzduit. Nu este o API pentru dezvoltatori pentru a construi aplicații pe Unbox; pentru trimiteri tranzacționale de pe domeniul tău, consultă documentația HTTP API.

Ce pot face agenții

După ce te autentifici, agentul tău poate apela instrumentele Unbox în numele tău:

• Citește inbox-ul și firele — Listează conversații, deschide un fir și preia mesaje individuale.
• Caută e-mailuri — Găsește mesaje în inbox-ul tău folosind interogări în limbaj natural.
• Trimite și răspunde — Redactează un e-mail nou sau răspunde la un fir de pe adresele tale Unbox, în limita limitelor de trimitere ale planului tău.
• Organizează — Marchează ca spam, recuperează din spam, mută în coșul de gunoi sau restaurează — un mesaj pe rând.

Golirea în masă a spamului sau a coșului, generarea cheilor API și acțiunile în spațiul de lucru al echipei nu sunt disponibile prin MCP în v1.

Cum funcționează

Clientul tău AI se conectează la serverul MCP Unbox. Serverul apelează API-urile contului Unbox folosind o sesiune web normală — același tip pe care îl obții când te autentifici pe unbox.im.

1. Adaugă Unbox în configurația clientului tău MCP (vezi Configurare mai jos).
2. Solicită agentului tău să se autentifice — se deschide un link de browser unde aprobi accesul cu contul tău Unbox.
3. Odată conectat, solicită agentului să citească emailuri, să redacteze răspunsuri sau să organizeze mesaje.

Autentificare

Unbox folosește autentificarea prin browser pentru a aproba întotdeauna accesul. Agentul tău începe fluxul cu instrumentele de autentificare, apoi tu finalizezi autentificarea în browser:

1. Agentul tău apelează unbox_login_start și îți afișează un URL de browser.
2. Deschide linkul, autentifică-te în Unbox dacă este necesar, și copiază codul unic al linkului afișat pe pagină.
3. Lipește codul înapoi agentului tău (unbox_login_complete).
4. Sesiunea ta rămâne activă pentru perioada normală a sesiunii web Unbox — autentifică-te din nou când expiră.

URL de autentificare (pentru referință)

https://unbox.im/ro/auth/desktop/link?source=mcp

Ai nevoie mai întâi de un cont? Creează-ți ID-ul Unbox, apoi revino pentru a conecta agentul.

Configurare

Adaugă Unbox ca server MCP în clientul tău AI. Transportul HTTP remote este cea mai simplă modalitate de a te conecta la cloud-ul Unbox:

HTTP remote (recomandat)

Configurează-ți clientul MCP către endpoint-ul MCP Unbox. După adăugarea serverului, folosește instrumentele de autentificare pentru a te autentifica:

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

HTTP MCP poate fi dezactivat pe unele implementări până când este activat de operator. Dacă conexiunea eșuează, încearcă din nou mai târziu sau contactează suportul.

Instrumente comune

Odată autentificat, agentul tău poate folosi instrumente precum:

• unbox_login_start — deschide autentificarea în browser
• unbox_login_complete — schimbă codul linkului pentru sesiune
• unbox_list_threads — fluxul de inbox
• unbox_search_inbox — caută mesaje
• unbox_reply_to_email — răspunde la un mesaj
• unbox_send_email — trimite un email nou

Clienți suportați

Orice gazdă de agent compatibilă MCP se poate conecta la Unbox. Testăm și documentăm:

• Cursor — Adaugă Unbox sub serverele MCP în setările Cursor, apoi autentifică-te prin fluxul din browser.
• Workbuddy — Configurați un URL de server MCP la distanță care indică către Unbox, apoi autentificați-vă cu contul dvs.
• OpenClaw — Conectați OpenClaw la punctul final HTTP MCP Unbox și finalizați autentificarea în browser.

Securitate

• Autentificare în browser — Vă autentificați prin Unbox în browser — agenții nu vă văd niciodată parola.
• Doar proprietarul contului — Accesul MCP este limitat la proprietarul contului personal, nu la membrii echipei sau spațiile de lucru partajate.
• Aceleași limite ca în aplicația web — Cotele de trimitere, regulile de spam și politica tranzacțională se aplică acțiunilor agenților la fel ca în interfața inbox-ului.
• Fără ștergere în masă — Agenții nu pot goli spamul, coșul de gunoi sau roti cheile API prin MCP în v1.