AIアシスタントをUnboxに接続

概要

Unbox MCPは、個人アカウント所有者がAIアシスタント（Cursor、Workbuddy、OpenClaw、またはMCP互換のホスト）を利用して、ホストされたメールを操作するためのものです。これはUnbox上でアプリを構築するための開発者向けAPIではありません。ドメインからのトランザクションメール送信については、HTTP APIのドキュメントをご覧ください。

エージェントが実行できる操作

サインイン後、エージェントがお客様に代わってUnboxツールを呼び出せるようになります。

• 受信トレイとスレッドの閲覧 — 会話の一覧表示、スレッドの開封、個別メッセージの取得が可能です。
• メールの検索 — 自然言語クエリを使用して、受信トレイ全体からメッセージを検索します。
• 送信と返信 — Unboxアドレスから新規メールを作成したり、スレッドに返信したりできます。プランの送信制限が適用されます。
• 整理 — スパムマーク、スパムからの復元、ゴミ箱への移動、復元を1メッセージずつ実行できます。

スパムやゴミ箱の一括空っぽ化、APIキーの生成、チームワークスペースの操作は、v1のMCPでは利用できません。

仕組み

AIクライアントがUnbox MCPサーバーに接続します。サーバーは通常のWebセッション（unbox.imにサインインするときと同じもの）を使用してUnboxアカウントAPIを呼び出します。

1. MCPクライアントの設定にUnboxを追加します（下記の「セットアップ」を参照）。
2. エージェントにサインインを依頼します。ブラウザリンクが開き、Unboxアカウントでアクセスを承認します。
3. 接続後、エージェントにメールの読み取り、下書きの作成、メッセージの整理を依頼できます。

サインイン

Unboxはブラウザログインを使用するため、常にお客様がアクセスを承認します。エージェントがログインツールでフローを開始し、ブラウザでサインインを完了します。

1. エージェントがunbox_login_startを呼び出し、ブラウザURLを表示します。
2. リンクを開き、必要に応じてUnboxにサインインし、ページに表示されたワンタイムリンクコードをコピーします。
3. コードをエージェントに貼り付けます（unbox_login_complete）。
4. セッションは通常のUnbox Webセッション期間中アクティブな状態を保ちます。期限切れになったら再度サインインしてください。

ログインURL（参考用）

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

アカウントが必要ですか？ Unbox IDを作成してから、エージェントを接続してください。

セットアップ

AIクライアントにUnboxをMCPサーバーとして追加します。リモートHTTPトランスポートがUnboxクラウドに接続する最も簡単な方法です。

リモートHTTP（推奨）

MCPクライアントをUnbox MCPエンドポイントに向けます。サーバー追加後、ログインツールを使用して認証します。

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

一部の環境では、オペレーターが有効化するまでHTTP MCPが無効になっている場合があります。接続に失敗した場合は、後でもう一度試すか、サポートにお問い合わせください。

共通ツール

サインイン後、エージェントは以下のツールを使用できます：

• unbox_login_start — ブラウザログインを開く
• unbox_login_complete — リンクコードをセッションと交換
• unbox_list_threads — 受信トレイフィード
• unbox_search_inbox — メッセージ検索
• unbox_reply_to_email — メッセージに返信
• unbox_send_email — 新規メール送信

対応クライアント

MCP対応のエージェントホストはUnboxに接続できます。以下はテスト済みでドキュメント化されています：

• Cursor — Cursorの設定でMCPサーバーにUnboxを追加し、ブラウザフローでサインインします。
• Workbuddy — Unboxを指すリモートMCPサーバーのURLを設定し、アカウントで認証します。
• OpenClaw — OpenClawをUnboxのMCP HTTPエンドポイントに接続し、ブラウザログインを完了します。

セキュリティ

• ブラウザログイン — ブラウザでUnboxを通じてサインインします。エージェントがパスワードを閲覧することはありません。
• アカウント所有者のみ — MCPへのアクセスは個人アカウントの所有者のみに制限されており、チームメンバーや共有ワークスペースは対象外です。
• Webアプリと同じ制限 — 送信クォータ、スパムルール、トランザクションポリシーは、受信トレイUIと同様にエージェントのアクションにも適用されます。
• 一括削除不可 — v1では、エージェントはMCP経由でスパムを空にする、ゴミ箱を空にする、APIキーのローテーションを行うことはできません。