Sendmux Email MCP
公式Sendmuxは、AIエージェント向けのメール受信トレイAPIおよびメールAPIです。
Sendmux Email MCPで何ができますか？
- Sendmux ドキュメントを検索 — AI に
search_sendmux（Doc Search MCP の機能）を使ってガイドや API リファレンスを探してもらいます。 - メールボックスを管理 —
mailbox_list_granted_mailboxesで許可されたメールボックスを一覧表示し、特定のメールボックス内のメールを検索、閲覧、整理します。 - トランザクションメールを送信 — 送信可能な接続を承認した後、Sending 画面から単一またはバッチのメールを送信します。
- チームリソースを管理 — Management 画面からドメイン、メールボックス、送信アカウント、ログ、メトリクス、請求、Webhook を管理します。
- ローカル MCP サーバーを実行 —
sendmux-mcpパッケージをローカルで起動し、メールボックス、管理、または送信ツール用の画面固有の 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 | 管理、メールボックス、送信ツールを使用します。 | 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は、あなたが許可した製品サーフェスを公開します。
| サーフェス | 用途 | アクセス |
|---|---|---|
| メールボックス | 許可されたメールボックスを検索、閲覧、整理、送信します。 | メールボックスアクセス権を持つホスト型許可、smx_mbx_ キー、またはスコープ付き smx_agent_ トークンをローカルで使用 |
| 管理 | ドメイン、メールボックス、送信アカウント、ログ、メトリクス、請求、Webhookなどのチームリソースを管理します。 | 管理アクセス権を持つホスト型許可、または smx_root_ キーをローカルで使用 |
| 送信 | 単一またはバッチメールを送信します。 | 送信アクセス権を持つホスト型許可、smx_mbx_ キー、または所有者承認済みの送信リソース 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
サーバーは起動前にキープレフィックスを検証します。管理には smx_root_ が必要です。送信は、送信可能な smx_mbx_ キーまたは所有者承認済みの送信リソース smx_agent_ トークンを受け入れます。メールボックスは、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` | なし | | メールボックスAPIキー | `SENDMUX_MAILBOX_API_KEY` | なし | | 管理APIキー | `SENDMUX_MANAGEMENT_API_KEY` | なし | | 送信APIキー | `SENDMUX_SENDING_API_KEY` | なし | | 管理およびメールボックスAPIベースURL | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | 送信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クライアントのツールピッカーを開いて、その接続で利用可能なツールを確認します。ホスト型接続では、選択した製品サーフェス、権限、およびメールボックス許可によって許可されたツールのみが表示されます。ローカルサーバーでは、起動時に指定したサーフェスとキーのツールが表示されます。