Verbind je AI-assistent met Unbox

Overzicht

Unbox MCP is bedoeld voor eigenaren van een persoonlijk account die een AI-assistent willen — in Cursor, Workbuddy, OpenClaw of een andere MCP-compatibele host — om met hun gehoste e-mail te werken. Het is geen ontwikkelaars-API voor het bouwen van apps op Unbox; voor transactionele verzendingen vanaf je domein, zie onze HTTP API-documentatie.

Wat agents kunnen doen

Nadat u bent ingelogd, kan uw agent Unbox-tools namens u aanroepen:

• Postvak IN en gesprekken lezen — Gesprekken weergeven, een gesprek openen en afzonderlijke berichten ophalen.
• E-mail doorzoeken — Vind berichten in uw postvak IN met natuurlijke taalquery's.
• Verzenden en beantwoorden — Stel een nieuwe e-mail op of beantwoord een gesprek vanaf uw Unbox-adressen, onder voorbehoud van de verzendlimieten van uw abonnement.
• Organiseren — Markeren als spam, herstellen uit spam, naar prullenbak verplaatsen of herstellen — één bericht tegelijk.

Bulksgewijs spam of prullenbak legen, API-sleutelgeneratie en teamwerkruimteacties zijn niet beschikbaar via MCP in v1.

Hoe het werkt

Uw AI-client maakt verbinding met de Unbox MCP-server. De server roept Unbox-account-API's aan via een normale websessie — dezelfde als wanneer u inlogt op unbox.im.

1. Voeg Unbox toe aan uw MCP-clientconfiguratie (zie Setup hieronder).
2. Vraag uw agent om in te loggen — er wordt een browserlink geopend waar u toegang goedkeurt met uw Unbox-account.
3. Zodra de verbinding tot stand is gebracht, vraag uw agent om e-mail te lezen, antwoorden op te stellen of berichten te ordenen.

Inloggen

Unbox gebruikt browserinloggen zodat u altijd toegang goedkeurt. Uw agent start de stroom met de inlogtools, waarna u de inlogprocedure in de browser voltooit:

1. Uw agent roept unbox_login_start aan en toont u een browser-URL.
2. Open de link, log indien nodig in op Unbox en kopieer de eenmalige linkcode die op de pagina wordt weergegeven.
3. Plak de code terug naar uw agent (unbox_login_complete).
4. Uw sessie blijft actief gedurende de normale Unbox-websessieperiode — log opnieuw in wanneer deze verloopt.

Inlog-URL (ter referentie)

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

Eerst een account nodig? Maak uw Unbox ID aan en keer dan terug om uw agent te verbinden.

Instellen

Voeg Unbox toe als MCP-server in uw AI-client. Remote HTTP-transport is de eenvoudigste manier om verbinding te maken met Unbox cloud:

Remote HTTP (aanbevolen)

Richt uw MCP-client op het Unbox MCP-eindpunt. Gebruik na het toevoegen van de server de inlogtools om te authenticeren:

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

HTTP MCP kan op sommige implementaties zijn uitgeschakeld totdat de beheerder het inschakelt. Als de verbinding mislukt, probeer het dan later opnieuw of neem contact op met ondersteuning.

Veelgebruikte tools

Zodra u bent ingelogd, kan uw agent tools gebruiken zoals:

• unbox_login_start — Inloggen via browser
• unbox_login_complete — Linkcode omwisselen voor sessie
• unbox_list_threads — Inboxfeed
• unbox_search_inbox — Berichten doorzoeken
• unbox_reply_to_email — Reageren op een bericht
• unbox_send_email — Nieuwe e-mail verzenden

Ondersteunde clients

Elke MCP-compatibele agent-host kan verbinding maken met Unbox. Wij testen en documenteren:

• Cursor — Voeg Unbox toe onder MCP-servers in de Cursor-instellingen en log vervolgens in via de browserflow.
• Workbuddy — Configureer een externe MCP-server-URL die naar Unbox verwijst en verifieer vervolgens met je account.
• OpenClaw — Verbind OpenClaw met het Unbox MCP HTTP-eindpunt en voltooi de browserlogin.

Beveiliging

• Browserlogin — Je logt in via Unbox in je browser — agents zien nooit je wachtwoord.
• Alleen accounteigenaar — MCP-toegang is beperkt tot de persoonlijke accounteigenaar, niet voor teamleden of gedeelde werkruimtes.
• Dezelfde limieten als de webapp — Verzendquota, spamregels en transactiebeleid gelden voor agentacties op dezelfde manier als in de inbox-UI.
• Geen bulkverwijdering — Agents kunnen in v1 geen spam legen, prullenbak legen of API-sleutels roteren via MCP.