Sendmux Email MCP

公式

Sendmuxは、AIエージェント向けのメール受信トレイAPIおよびメールAPIです。

sendmux.ai で表示このMCPを試すスポンサー

Sendmux Email MCPで何ができますか？

Sendmuxドキュメントを検索 — AIアシスタントにsearch_sendmuxを使ってSendmuxガイドとAPIリファレンスを調べてもらいます。
メールボックスを管理 — AIアシスタントにMailboxサーフェスを使って、許可されたメールボックスの検索、閲覧、整理、メール送信を実行させます。
チームリソースを監督 — AIアシスタントにManagementサーフェスを通じて、ドメイン、メールボックス、送信アカウント、ログ、メトリクス、請求、ウェブフックを管理させます。
メールを送信 — AIアシスタントにSendingサーフェスのツールを使って、単一または一括メールを送信するよう指示します。

ドキュメント

MCP

AIツールをSendmuxのドキュメントやプロダクトツールに接続します。

Sendmuxには2つのMCP接続があります。AIツールにSendmuxのドキュメントを検索させたい場合はDoc Search MCPを使用してください。承認したSendmuxツールでエージェントを操作させたい場合はMCPを使用してください。

接続	用途	サーバー
Doc Search MCP	SendmuxガイドとAPIリファレンスを検索します。	`https://sendmux.ai/docs/mcp`
MCP	Management、Mailbox、Sendingツールを使用します。	`https://mcp.sendmux.ai/mcp` またはローカルの `sendmux-mcp` パッケージ

情報

MCPは厳選されたエージェントツールセットを公開しており、すべてのAPIエンドポイントを公開しているわけではありません。完全なエンドポイントカバレッジが必要な場合は、SDK、CLI、またはAPIリファレンスを使用してください。

Doc Search MCP

Doc Search MCPは search_sendmux を公開します。

```bash theme={null} claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp ``` このサーバーを `.cursor/mcp.json` に追加して1つのプロジェクトに、または `~/.cursor/mcp.json` に追加してすべてのプロジェクトに適用します。

```json theme={null}
{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}
```

このサーバーをユーザーまたはワークスペースの `mcp.json` に追加します。

```json theme={null}
{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}
```

このサーバーを `~/.codex/config.toml` または信頼できるプロジェクトの `.codex/config.toml` に追加します。

```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```

MCP

MCPは、付与したプロダクトサーフェスを公開します。

サーフェス	用途	アクセス
Mailbox	付与されたメールボックスを検索、閲覧、整理、送信します。	Mailboxアクセス付きのホステッドグラント、`smx_mbx_` キー、またはローカルのスコープ付き `smx_agent_` トークン
Management	ドメイン、メールボックス、送信アカウント、ログ、メトリクス、請求、ウェブフックなどのチームリソースを管理します。	Managementアクセス付きのホステッドグラント、またはローカルの `smx_root_` キー
Sending	単一またはバッチのメールを送信します。	Sendingアクセス付きのホステッドグラント、`smx_mbx_` キー、またはオーナー承認済みのSendingリソース `smx_agent_` トークンをローカルで使用

ホステッドMCPは、クライアントがブラウザOAuthを使用したリモートMCPをサポートしている場合のデフォルトです。Sendmuxを認証フローに組み込み、手動のAPIキーをエージェントに配布することを避け、グラントで許可されたツールのみを表示します。

情報

パッケージID: sendmux-mcp

パッケージバージョン: 2.1.2

ホステッドリソース: https://mcp.sendmux.ai/mcp

ホステッドトランスポート: Streamable HTTP

厳選ツール数: 54

認定プロトコルバージョン: 2025-11-25、2026-07-28

ランタイム受け入れプロトコルバージョン: 2024-11-05、2025-03-26、2025-06-18、2025-11-25、2026-07-28。ランタイム受け入れは互換性を提供しますが、各バージョンを認定するものではありません。

設定	値
サーバーURL	`https://mcp.sendmux.ai/mcp`
認証サーバー	`https://app.sendmux.ai`
ヘルスチェック	`https://mcp.sendmux.ai/health`

PostmanからMCPリクエストをテストしたい場合は、Postmanコレクションを使用してください:

接続すると、Sendmuxはチーム、プロダクトサーフェス、および関連するメールボックスアクセスを選択するよう求めます。アクセストークンは短命です。リフレッシュトークンは使用時にローテーションされ、接続が切断または期限切れにならない限り最大30日間有効です。

注記

複数のメールボックスを付与する場合は、mailbox_list_granted_mailboxes でメールボックスのワークフローを開始し、返された mailbox_id を1つのメールボックスに作用するツールに渡します。

接続モード

クライアントがブラウザベースのMCP OAuthフローを開ける場合に使用します。コーディングエージェントがマシン上でローカルコマンドを起動できる場合に使用します。クライアントがURLを必要とするが、MCPパッケージを自分で実行する場合に使用します。

ローカルパッケージ

PyPIからローカルパッケージをインストールします:

pip install sendmux-mcp

1つのサーフェスを実行します:

SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending

すべてのプロダクトサーフェスを実行します:

SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY=smx_mbx_... \
SENDMUX_MANAGEMENT_API_KEY=smx_root_... \
SENDMUX_SENDING_API_KEY=smx_mbx_... \
sendmux-mcp

サーバーは起動前にキープレフィックスを検証します。Managementには smx_root_ が必要です。Sendingは送信可能な smx_mbx_ キーまたはオーナー承認済みのSendingリソース smx_agent_ トークンを受け入れます。Mailboxは smx_mbx_ キーまたはスコープ付きの smx_agent_ トークンを受け入れます。

プライベートHTTP

HTTPモードは、MCPクライアントがサーバーURLに接続するが、パッケージを自分で実行したい場合に便利です。

SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765

エンドポイントはデフォルトで /mcp になります。/health は選択したサーフェスを返します。HTTPモードでは、--allow-unauthenticated-http で明示的に開始しない限り、SENDMUX_MCP_HTTP_BEARER_TOKEN が必要です。

設定リファレンス

| 設定 | 環境変数 | デフォルト | | - | - | - | | ツールサーフェス | `SENDMUX_MCP_SURFACES` | `sendmux-mcp` に必須 | | APIキーフォールバック | `SENDMUX_API_KEY` | なし | | Mailbox APIキー | `SENDMUX_MAILBOX_API_KEY` | なし | | Management APIキー | `SENDMUX_MANAGEMENT_API_KEY` | なし | | Sending APIキー | `SENDMUX_SENDING_API_KEY` | なし | | ManagementおよびMailbox APIベースURL | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | Sending APIベースURL | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | リトライ時間予算（秒） | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | 未設定 | | トランスポート | `SENDMUX_MCP_TRANSPORT` | `stdio` | | HTTPホスト | `SENDMUX_MCP_HOST` | `127.0.0.1` | | HTTPポート | `SENDMUX_MCP_PORT` | `8765` | | HTTPパス | `SENDMUX_MCP_PATH` | `/mcp` | | HTTPベアラートークン | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | HTTPに必須 | | 許可されたブラウザオリジン | `SENDMUX_MCP_ALLOWED_ORIGINS` | ブラウザオリジンなし | ```bash theme={null} SENDMUX_MCP_SURFACES=mailbox,management,sending \ SENDMUX_MAILBOX_API_KEY="$SENDMUX_MAILBOX_KEY" \ SENDMUX_MANAGEMENT_API_KEY="$SENDMUX_ROOT_KEY" \ SENDMUX_SENDING_API_KEY="$SENDMUX_SENDING_KEY" \ sendmux-mcp ```

ツールの検出

ツール名は現在の公開APIサーフェスから生成されます。認証後にMCPクライアントのツールピッカーを開いて、その接続で利用可能なツールを確認してください。

ホステッド接続では、選択したプロダクトサーフェス、権限、およびメールボックスグラントで許可されたツールのみが表示されます。ローカルサーバーでは、起動時に提供したサーフェスとキーのツールが表示されます。

トラブルシューティング

選択したプロダクトサーフェスと付与された権限を確認してください。ホステッド接続では、グラントで許可されたツールのみが表示されます。 APIキーのプレフィックスを確認してください。Managementには `smx_root_` が必要です。Sendingは `smx_mbx_` またはオーナー承認済みのSendingリソース `smx_agent_` を受け入れます。Mailboxは `smx_mbx_` またはスコープ付きの `smx_agent_` を受け入れます。プライベートHTTPに `Authorization: Bearer ` を送信するか、ホステッドMCPのOAuthを完了してください。プライベートHTTPの場合、ブラウザクライアントのオリジンを `SENDMUX_MCP_ALLOWED_ORIGINS` に追加してください。必要なサーフェスのみを接続するか、クライアントで未使用のツールを無効にしてください。

次のステップ

ホステッドOAuthを使用して、A2A 1.0エージェントエンドポイント経由でSendmuxを使用します。 Claude Code、Cursor、Codex、Gemini CLI、Qwen Code、ZedなどでSendmux MCPを設定します。アプリケーションコードからパッケージ管理されたクライアントを使用します。ターミナルアクセスが必要な場合は、Snap、Homebrew、またはnpmでCLIをインストールします。ローカルMCPセットアップ用のスコープ付き認証情報を作成します。