Połącz swojego asystenta AI z Unbox

Przegląd

Unbox MCP jest przeznaczony dla właścicieli kont osobistych, którzy chcą, aby asystent AI — w Cursor, Workbuddy, OpenClaw lub dowolnym hoście kompatybilnym z MCP — pracował z ich hostowaną pocztą. Nie jest to API dla programistów do tworzenia aplikacji na Unbox; w przypadku wysyłania transakcyjnego z własnej domeny, zapoznaj się z dokumentacją HTTP API.

Co mogą robić agenci

Po zalogowaniu Twój agent może wywoływać narzędzia Unbox w Twoim imieniu:

• Odczyt skrzynki odbiorczej i wątków — Wyświetlaj rozmowy, otwieraj wątki i pobieraj poszczególne wiadomości.
• Wyszukiwanie poczty — Znajduj wiadomości w całej skrzynce odbiorczej za pomocą zapytań w języku naturalnym.
• Wysyłanie i odpowiadanie — Twórz nowe wiadomości lub odpowiadaj na wątki z Twoich adresów Unbox, z zastrzeżeniem limitów wysyłania w Twoim planie.
• Organizowanie — Oznaczaj jako spam, przywracaj ze spamu, przenoś do kosza lub przywracaj — pojedynczo.

Masowe czyszczenie spamu lub kosza, generowanie kluczy API oraz działania w przestrzeni zespołu nie są dostępne przez MCP w wersji 1.

Jak to działa

Twój klient AI łączy się z serwerem Unbox MCP. Serwer wywołuje API konta Unbox przy użyciu zwykłej sesji internetowej — takiej samej, jaką uzyskujesz po zalogowaniu się na unbox.im.

1. Dodaj Unbox do konfiguracji swojego klienta MCP (zobacz Konfiguracja poniżej).
2. Poproś swojego agenta o zalogowanie — otworzy link w przeglądarce, gdzie zatwierdzisz dostęp swoim kontem Unbox.
3. Po połączeniu poproś swojego agenta o odczytanie poczty, napisanie odpowiedzi lub uporządkowanie wiadomości.

Zaloguj się

Unbox używa logowania przez przeglądarkę, abyś zawsze zatwierdzał dostęp. Twój agent rozpoczyna proces za pomocą narzędzi logowania, a następnie kończysz logowanie w przeglądarce:

1. Twój agent wywołuje unbox_login_start i pokazuje Ci adres URL w przeglądarce.
2. Otwórz link, zaloguj się do Unbox, jeśli to konieczne, i skopiuj jednorazowy kod linku wyświetlony na stronie.
3. Wklej kod z powrotem do swojego agenta (unbox_login_complete).
4. Twoja sesja pozostaje aktywna przez standardowy okres sesji internetowej Unbox — zaloguj się ponownie po jej wygaśnięciu.

URL logowania (do wglądu)

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

Potrzebujesz najpierw konta? Utwórz swoje Unbox ID, a następnie wróć, aby podłączyć swojego agenta.

Konfiguracja

Dodaj Unbox jako serwer MCP w swoim kliencie AI. Zdalny transport HTTP to najprostszy sposób na połączenie z chmurą Unbox:

Zdalny HTTP (zalecany)

Skonfiguruj swojego klienta MCP, aby wskazywał na punkt końcowy MCP Unbox. Po dodaniu serwera użyj narzędzi logowania, aby się uwierzytelnić:

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

HTTP MCP może być wyłączone w niektórych wdrożeniach, dopóki nie zostanie włączone przez operatora. Jeśli połączenie nie działa, spróbuj ponownie później lub skontaktuj się z pomocą techniczną.

Typowe narzędzia

Po zalogowaniu Twój agent może korzystać z narzędzi takich jak:

• unbox_login_start — Otwieranie logowania przez przeglądarkę
• unbox_login_complete — Wymiana kodu linku na sesję
• unbox_list_threads — Kanał skrzynki odbiorczej
• unbox_search_inbox — Wyszukiwanie wiadomości
• unbox_reply_to_email — Odpowiadanie na wiadomość
• unbox_send_email — Wysyłanie nowej wiadomości

Obsługiwani klienci

Każdy host agenta zgodny z MCP może połączyć się z Unbox. Testujemy i dokumentujemy:

• Cursor — Dodaj Unbox jako serwer MCP w ustawieniach Cursor, a następnie zaloguj się przez przeglądarkę.
• Workbuddy — Skonfiguruj zdalny adres URL serwera MCP wskazujący na Unbox, a następnie uwierzytelnij się za pomocą swojego konta.
• OpenClaw — Połącz OpenClaw z punktem końcowym HTTP MCP Unbox i ukończ logowanie przez przeglądarkę.

Bezpieczeństwo

• Logowanie przez przeglądarkę — Logujesz się przez Unbox w swojej przeglądarce — agenci nigdy nie widzą Twojego hasła.
• Tylko właściciel konta — Dostęp MCP jest ograniczony do osobistego właściciela konta, a nie do członków zespołu lub współdzielonych przestrzeni roboczych.
• Te same limity co w aplikacji webowej — Limity wysyłania, reguły antyspamowe i polityka transakcyjna dotyczą działań agenta w taki sam sposób, jak w interfejsie skrzynki odbiorczej.
• Brak masowego usuwania — Agenci nie mogą opróżniać spamu, kosza ani rotować kluczy API przez MCP w wersji v1.