Collega il tuo assistente AI a Unbox

Panoramica

Unbox MCP è pensato per i titolari di account personali che desiderano un assistente AI — in Cursor, Workbuddy, OpenClaw o qualsiasi host compatibile con MCP — per lavorare con la loro posta ospitata. Non è un'API per sviluppatori per creare app su Unbox; per l'invio transazionale dal tuo dominio, consulta la documentazione della nostra API HTTP.

Cosa possono fare gli agenti

Dopo aver effettuato l'accesso, il tuo agente può chiamare gli strumenti di Unbox per tuo conto:

• Leggi casella di posta e conversazioni — Elenca conversazioni, apri una conversazione e recupera messaggi singoli.
• Cerca nella posta — Trova messaggi in tutta la posta in arrivo con domande in linguaggio naturale.
• Invia e rispondi — Componi un nuovo messaggio o rispondi a una conversazione dai tuoi indirizzi Unbox, soggetto ai limiti di invio del tuo piano.
• Organizza — Segna come spam, ripristina dallo spam, sposta nel cestino o ripristina — un messaggio alla volta.

Lo svuotamento in blocco dello spam o del cestino, la generazione di chiavi API e le azioni del team workspace non sono disponibili tramite MCP nella v1.

Come funziona

Il tuo client AI si connette al server MCP di Unbox. Il server richiama le API dell'account Unbox utilizzando una normale sessione web — lo stesso tipo che ottieni quando accedi a unbox.im.

1. Aggiungi Unbox alla configurazione del tuo client MCP (vedi Configurazione sotto).
2. Chiedi al tuo agente di accedere — apre un link nel browser in cui approvi l'accesso con il tuo account Unbox.
3. Una volta connesso, chiedi al tuo agente di leggere la posta, scrivere bozze di risposte o organizzare i messaggi.

Accedi

Unbox utilizza il login tramite browser in modo da approvare sempre l'accesso. Il tuo agente avvia il flusso con gli strumenti di login, poi tu completi l'accesso nel browser:

1. Il tuo agente chiama unbox_login_start e ti mostra un URL del browser.
2. Apri il link, accedi a Unbox se necessario e copia il codice link monouso mostrato sulla pagina.
3. Incolla il codice nel tuo agente (unbox_login_complete).
4. La tua sessione rimane attiva per il periodo normale della sessione web di Unbox — accedi di nuovo quando scade.

URL di login (per riferimento)

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

Prima hai bisogno di un account? Crea il tuo Unbox ID, poi torna per connettere il tuo agente.

Configurazione

Aggiungi Unbox come server MCP nel tuo client AI. Il trasporto HTTP remoto è il modo più semplice per connettersi al cloud Unbox:

HTTP remoto (consigliato)

Punta il tuo client MCP all'endpoint MCP di Unbox. Dopo aver aggiunto il server, usa gli strumenti di login per autenticarti:

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

HTTP MCP potrebbe essere disabilitato su alcune distribuzioni finché non viene attivato dall'operatore. Se la connessione fallisce, riprova più tardi o contatta l'assistenza.

Strumenti comuni

Una volta effettuato l'accesso, il tuo agente può utilizzare strumenti come:

• unbox_login_start — apri login browser
• unbox_login_complete — scambia codice link per sessione
• unbox_list_threads — feed della posta in arrivo
• unbox_search_inbox — cerca messaggi
• unbox_reply_to_email — rispondere a un messaggio
• unbox_send_email — inviare una nuova email

Client supportati

Qualsiasi host agente compatibile con MCP può connettersi a Unbox. Testiamo e documentiamo:

• Cursor — Aggiungi Unbox nella sezione server MCP delle impostazioni di Cursor, quindi accedi tramite il flusso del browser.
• Workbuddy — Configura un URL del server MCP remoto che punti a Unbox, quindi autenticati con il tuo account.
• OpenClaw — Collega OpenClaw all'endpoint HTTP MCP di Unbox e completa l'accesso tramite browser.

Sicurezza

• Accesso tramite browser — Accedi tramite Unbox nel tuo browser: gli agenti non vedono mai la tua password.
• Solo il proprietario dell'account — L'accesso MCP è limitato al proprietario dell'account personale, non ai membri del team o agli spazi di lavoro condivisi.
• Stessi limiti dell'app web — Quote di invio, regole antispam e policy transazionali si applicano alle azioni degli agenti esattamente come nell'interfaccia della posta in arrivo.
• Nessuna eliminazione in blocco — Nella versione v1, gli agenti non possono svuotare lo spam, svuotare il cestino o ruotare le chiavi API tramite MCP.