# Tellnod MCP サーバー

> Tellnod は `https://mcp.tellnod.com/mcp` で提供するリモートのメールマーケティング用 MCP サーバーです。OAuth 2.1 と Streamable HTTP を使い、ブランド、連絡先、セグメント、下書き、プレビュー、送信、結果のツールを提供します。MCP Apps に対応したクライアントでは、インタラクティブなカードを表示します。

Canonical: https://tellnod.com/ja/mcp-server  
Last updated: 2026-10-17  
Author: Tellnod team

## エンドポイントとトランスポート

- **アドレス：** `https://mcp.tellnod.com/mcp`
- **トランスポート：** Streamable HTTP。ローカルにインストールしたり実行したりするものはありません。
- **クライアント：** Claude（カスタムコネクタ）と ChatGPT（カスタム MCP サーバー）。設定手順は[接続](https://tellnod.com/ja/connect)をご覧ください。
- **インタラクティブなカード：** MCP Apps に対応したクライアントでは、ツールが `ui://tellnod/…` のカードを添付します。その他のクライアントには、同じ結果がテキストで返されます。

## 認証

サインインには、動的クライアント登録に対応した OAuth 2.1 を使います。クライアントは自動で登録され、あなたはブラウザで Google にサインインします。アクセストークンは MCP サーバーのアドレスに紐づいており、ほかの宛先では拒否されます。

接続したクライアントは、読み取りと作成ができます。**送信は OAuth の権限には含まれません。** 送信を予約するには、人がカードまたは Web の確認ページで「Confirm」を押す必要があるため、トークンだけでメールが送信されることはありません。

## ツール

すべてのツールが `readOnlyHint`、`destructiveHint`、`idempotentHint`、`openWorldHint` を宣言しているため、クライアントはどの呼び出しがデータを変更するかを表示できます。

### 読み取り専用

- `get_workspace`、`get_overview`：アカウント、プラン、上限、次に行うこと。
- `fetch_brand`：サイトからロゴ、色、フォントを読み取ります。
- `search_contacts`、`get_contact`、`list_segments`、`estimate_audience`：連絡先を探し、保存する前に配信対象の規模を見積もります。
- `render_preview`、`preview_inbox`、`preview_channels`、`list_templates`：実際のメール、受信トレイでの表示、ひな形となるテンプレート。
- `check_domain`：送信ドメインの DNS の状態。
- `get_send`、`list_sends`、`get_campaign_results`、`compare_campaigns`：送信の状態と結果。

### 書き込み

- `save_brand`、`confirm_brand`：すべてのメールに使うブランドを保存します。
- `import_contacts`、`tag_contacts`、`create_segment`：同意の状態を含む連絡先と、保存した配信対象。
- `create_message_draft`、`update_message_draft`、`apply_template`：メールの作成と修正。
- `add_domain`、`remove_domain`：ご自身のドメインからの送信。
- `send_test`：自分宛てのテストメール（1 日 20 通まで）。
- `prepare_send`、`prepare_resend`：配信対象を確定し、確認カードを表示します。
- `cancel_send`：予約した送信のキャンセル。

> `confirm_send` はカードからのみ見え、モデルからは見えません。そのため、AI アシスタントが単独で送信を完了させることはできません。

## 2 段階の送信

1. `prepare_send` が配信対象のリストを確定し、ワークスペース、操作する人、メッセージ、そのリストに紐づいた確認を返します。
2. 確認カードに、配信数、除外される連絡先とその理由、配信日時、法令面のチェックリストが表示されます。
3. 「Confirm」を押すと送信が予約されます。確認は 1 回限り有効で、10 分で失効します。もう一度準備すると、新しい確認が発行されます。
4. 「今すぐ送信」の場合も 5 分待ってから送信され、予約した送信は送信されるまでキャンセルできます。

## 上限と安全対策

- 共用の送信ドメイン（hello@yourshop.tellnodmail.com のようなアドレス）：1 回のキャンペーンにつき 500 人まで、1 か月 1,000 通まで。ご自身のドメインを認証すると、この制限はなくなります。
- Free プラン：連絡先 500 件、月 2,000 通まで。
- 苦情率が 0.1%、またはバウンス率が 2% に達すると、送信は自動で一時停止します。
- 配信停止リンク、ワンクリック配信停止のヘッダー、住所が、すべてのキャンペーンに追加されます。

## WhatsApp と LINE のツール

WhatsApp と LINE のツールも、同じ連絡先、プレビュー、2 段階の送信を使います。各チャネルの提供開始にあわせてツール一覧に追加され、次に WhatsApp、その後に LINE の順で提供します。[LINE MCP サーバー](https://tellnod.com/ja/line-mcp-server)もご覧ください。

## FAQ

### Tellnod の MCP サーバーはオープンソースですか？

サーバーはホスティング型のサービスです。メールのプレビューを描画する `preview-kit` は、オープンソースのパッケージとして公開を予定しています。

### 自社の MCP クライアントから使えますか？

OAuth によるサインインと Streamable HTTP に対応し、リモートの MCP サーバーを使えるクライアントであれば接続できます。カードが表示されるのは、MCP Apps に対応したクライアントだけです。

### API キーを使って MCP サーバー経由でメールを送信できますか？

できません。送信の権限を持つ API キーはなく、すべての送信には人が「Confirm」を押す必要があります。