Sendmux Email MCP Server
公式Sendmuxは、AIエージェント向けのメール受信トレイAPIおよびメールAPIです。
ドキュメント
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 パッケージ |
Doc Search MCP
Doc Search MCP は search_sendmux を公開します。
```json theme={null}
{
"mcpServers": {
"sendmux-docs": {
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```json theme={null}
{
"servers": {
"sendmux-docs": {
"type": "http",
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```
MCP
MCP は、あなたが許可した製品サーフェスを公開します。
| サーフェス | 用途 | アクセス |
|---|---|---|
| Mailbox | 許可されたメールボックスを検索、閲覧、整理、送信します。 | Mailbox アクセス権を持つホスト型許可、smx_mbx_ キー、またはスコープ付き smx_agent_ トークンをローカルで使用 |
| Management | ドメイン、メールボックス、送信アカウント、ログ、メトリクス、請求、Webhook などのチームリソースを管理します。 | Management アクセス権を持つホスト型許可、または smx_root_ キーをローカルで使用 |
| Sending | 単一またはバッチメールを送信します。 | Sending アクセス権を持つホスト型許可、smx_mbx_ キー、または所有者承認済みの Sending リソース smx_agent_ トークンをローカルで使用 |
ホスト型 MCP は、クライアントがブラウザ OAuth を使用したリモート MCP をサポートしている場合のデフォルトです。Sendmux を認可フローに維持し、手動 API キーをエージェントに配布することを避け、許可によって許可されたツールのみを表示します。
| 設定 | 値 |
|---|---|
| サーバー 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_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 \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```ツール検出
ツール名は現在の公開 API サーフェスから生成されます。認可後、MCP クライアントのツールピッカーを開いて、その接続で利用可能なツールを確認してください。ホスト型接続では、選択された製品サーフェス、権限、およびメールボックス許可によって許可されたツールのみが表示されます。ローカルサーバーでは、起動時に指定したサーフェスとキーのツールが表示されます。