Připojte svého AI asistenta k Unbox

Přehled

Unbox MCP je určen pro vlastníky osobních účtů, kteří chtějí mít AI asistenta – v prostředí Cursor, Workbuddy, OpenClaw nebo jakémkoli hostiteli kompatibilním s MCP – který bude pracovat s jejich hostovanou poštou. Nejde o vývojářské API pro tvorbu aplikací na Unbox; pro transakční odesílání z vaší domény viz dokumentace HTTP API.

Co agenti umí

Po přihlášení může váš agent volat nástroje Unbox vaším jménem:

• Čtení schránky a vláken — Vypsat konverzace, otevřít vlákno a načíst jednotlivé zprávy.
• Vyhledávání v poště — Najít zprávy ve vaší schránce pomocí dotazů v přirozeném jazyce.
• Odesílání a odpovídání — Napsat nový e-mail nebo odpovědět do vlákna z vašich adres Unbox, v závislosti na limitech odesílání vašeho tarifu.
• Organizace — Označit jako spam, obnovit ze spamu, přesunout do koše nebo obnovit – jednu zprávu po druhé.

Hromadné vyprázdnění spamu nebo koše, generování API klíčů a akce v týmovém pracovním prostoru nejsou v MCP verzi 1 k dispozici.

Jak to funguje

Váš AI klient se připojí k serveru Unbox MCP. Server volá API účtu Unbox pomocí běžné webové relace – stejného typu, jaký získáte při přihlášení na unbox.im.

1. Přidejte Unbox do konfigurace vašeho MCP klienta (viz Nastavení níže).
2. Požádejte svého agenta o přihlášení – otevře odkaz v prohlížeči, kde schválíte přístup svým účtem Unbox.
3. Po připojení požádejte agenta o čtení pošty, psaní odpovědí nebo organizaci zpráv.

Přihlásit se

Unbox používá přihlášení v prohlížeči, takže přístup vždy schvalujete vy. Váš agent spustí tok pomocí nástrojů pro přihlášení, poté dokončíte přihlášení v prohlížeči:

1. Váš agent zavolá unbox_login_start a zobrazí vám URL adresu prohlížeče.
2. Otevřete odkaz, v případě potřeby se přihlaste do Unbox a zkopírujte jednorázový kód odkazu zobrazený na stránce.
3. Vložte kód zpět svému agentovi (unbox_login_complete).
4. Vaše relace zůstává aktivní po standardní dobu webové relace Unbox – po vypršení se přihlaste znovu.

Přihlašovací URL (pro referenci)

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

Nejprve potřebujete účet? Vytvořte si Unbox ID a poté se vraťte pro připojení agenta.

Nastavení

Přidejte Unbox jako MCP server ve svém AI klientovi. Remote HTTP transport je nejjednodušší způsob připojení k Unbox cloudu:

Remote HTTP (doporučeno)

Nasměrujte svého MCP klienta na Unbox MCP endpoint. Po přidání serveru použijte přihlašovací nástroje k autentizaci:

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

HTTP MCP může být na některých nasazeních zakázáno, dokud jej operátor nepovolí. Pokud připojení selže, zkuste to znovu později nebo kontaktujte podporu.

Běžné nástroje

Po přihlášení může váš agent používat nástroje jako:

• unbox_login_start — otevřít přihlášení v prohlížeči
• unbox_login_complete — vyměnit kód odkazu za relaci
• unbox_list_threads — feed doručené pošty
• unbox_search_inbox — hledat zprávy
• unbox_reply_to_email — odpovědět na zprávu
• unbox_send_email — odeslat nový e-mail

Podporovaní klienti

Jakýkoli hostitel agenta kompatibilní s MCP se může připojit k Unbox. Testujeme a dokumentujeme:

• Cursor — Přidejte Unbox pod MCP servery v nastavení Cursoru a poté se přihlaste pomocí toku v prohlížeči.
• Workbuddy — Nakonfigurujte URL vzdáleného MCP serveru směřující na Unbox a poté se autentizujte svým účtem.
• OpenClaw — Připojte OpenClaw k Unbox MCP HTTP endpointu a dokončete přihlášení v prohlížeči.

Bezpečnost

• Přihlášení v prohlížeči — Přihlašujete se přes Unbox ve svém prohlížeči – agenti nikdy nevidí vaše heslo.
• Pouze vlastník účtu — Přístup MCP je omezen na osobního vlastníka účtu, nikoli na členy týmu nebo sdílené pracovní prostory.
• Stejné limity jako webová aplikace — Odesílací kvóty, pravidla pro spam a transakční politika se vztahují na akce agenta stejným způsobem jako v rozhraní doručené pošty.
• Žádné hromadné mazání — Agenti nemohou ve verzi v1 prostřednictvím MCP vyprázdnit spam, koš ani otáčet API klíče.