ツールリファレンス

接続済みのアシスタントが呼び出せるすべてのツールを、サーバーが登録しているのと同じ単位でグループ化しています。ツールは、あなたの接続がそのツールに必要なスコープを保持している場合にのみアシスタントに提示されます——存在はするが常にエラーになる書き込みツール、というものはありません。contacts:writeを許可していなければ、アシスタントにはupsert_contacts自体がまったく見えません。各スコープが何を意味するかはスコープと権限を参照してください。

以下の表のDestructiveは、Claude自身のレビュープロセスが要求している同じMCPアノテーションで、その効果が簡単には元に戻せないツール(プロジェクトの削除、ツリーの上書き、連絡先の削除)を示すものであり、あいまいな意味での「危険」ではありません。どの書き込みツールも、想定されるフィールドしか受け付けません——モデルが任意の変更を持ち込めるような、生のペイロードを受け付けるツールは1つもありません。

検出

| ツール | スコープ | 補足 | | --- | --- | --- | | search | projects:read / templates:read / contacts:read のいずれか | プロジェクト、テンプレート、連絡先リストを名前で検索します。fetch用の不透明なidを返します。ディープリサーチ対応クライアントが自動的に呼び出すツールです。 | | fetch | searchと同じ | searchから得た1つのidを、その完全な内容に解決します。 |

メールデザイン

| ツール | スコープ | Destructive | 補足 | | --- | --- | :-: | --- | | list_projects | projects:read | | すべてのプロジェクトのid、名前、用途。 | | get_email | projects:read | | プロジェクトの現在のブロックツリーとテーマ。 | | preview_email | projects:read | | 実際の送信用HTMLパイプラインを通してレンダリングします——送信された場合に生成される文書そのものです。ウィジェットが添付されます(下記参照)。 | | list_block_types | projects:read | | 実際のレジストリから生成される44種類のブロックカタログ全体——常に最新で、手動で維持されているものではありません。 | | list_templates | projects:read | | あなたの保存済みテンプレート、または承認済みのコミュニティギャラリー。 | | create_project | projects:write | | 組み込みの用途別テンプレートから任意でシード可能。 | | add_block / update_block / move_block | projects:write | | ツリーの編集で、スタジオ内コパイロットの編集と同じ方法でcanPlace/フィールドの検証が行われます。 | | remove_block | projects:write | ✓ | ブロックとその子要素を削除します。 | | set_theme | projects:write | | ブランドカラー、フォント、ボタンの角丸。 | | rename_project | projects:write | | | | delete_project | projects:write | ✓ | 永久に削除されます。 | | apply_template | projects:write | ✓ | プロジェクトのツリーとテーマ全体を上書きします。 | | save_as_template | templates:write | | 現在のプロジェクトを再利用可能なテンプレートとしてスナップショットします。 |

オーディエンス

| ツール | スコープ | Destructive | 補足 | | --- | --- | :-: | --- | | list_data_sources | contacts:read | | 連絡先リストを含むすべてのデータソース。認証情報の値は決して返されません。 | | list_contact_lists | contacts:read | | 連絡先リストのみ——id、名前、フィールド、行数。 | | get_contact_list_summary | contacts:read | | 件数とサプレッションの合計——個々の連絡先データは含みません。 | | find_contacts | contacts:read | | 上限付きの検索(最大25行、カーソルによるページネーション)。すべての呼び出しは、ダッシュボードでの連絡先読み取りと同じく、個人データアクセスログに記録されます。 | | upsert_contacts | contacts:write | | 行を追加または更新します。プランの連絡先上限を適用します。 | | remove_contact | contacts:write | ✓ | 1行を永久に削除します。 | | add_suppression / remove_suppression | contacts:write | | アドレスをアカウント全体でブロックまたはブロック解除します。受信者自身の配信停止リンクと同じ効果です。 |

結果

| ツール | スコープ | Destructive | 補足 | | --- | --- | :-: | --- | | get_campaign_results | analytics:read | | 開封/クリック/回答/収益、A/Bバリアントの比較、クリックヒートマップ。要約のみで、受信者ごとの生イベントは決して含みません。ウィジェットが添付されます。 | | get_form_responses | analytics:read | | 質問ごとの集計。自由記述の回答は、件数を制限した上でフェンス処理されたサンプルです。 | | list_orders | analytics:read | | 商品ブロックのチェックアウトによる注文。 | | list_campaign_sends | analytics:read | | 過去の一括送信を、直近のものから順に。 | | list_schedules | analytics:read | | プロジェクトに設定された繰り返し送信。 | | mark_order_fulfilled | commerce:write | | 物理商品の注文を発送済みにし、購入者にメールを送ります。 | | create_schedule | campaigns:send | | 新しい繰り返し送信を設定します。 | | set_schedule_enabled | campaigns:send | ✓ | 稼働中のスケジュールを無効化すると、今後の送信が黙って止まるため、破壊的とマークされています。 |

送信

| ツール | スコープ | Destructive | 補足 | | --- | --- | :-: | --- | | send_test_email | campaigns:read | | 指定した1つのアドレスに[Test]が先頭に付いた1件のコピーを送るだけで、実際のオーディエンスには触れず、campaigns:sendも不要です。 | | prepare_send | campaigns:send | | アノテーション上は読み取り専用——オーディエンスを解決し、プレビューをレンダリングするだけで、何も送信しません。confirmationTokenを返します。ウィジェットが添付されます(送信確認カード)。 | | confirm_send | campaigns:send | ✓ | prepare_sendが返したconfirmationTokenと完全に一致するものを、10分以内に必要とします。理由はセキュリティを参照してください。 |

メールボックスとチケット

| ツール | スコープ | 補足 | | --- | --- | --- | | list_mailbox_threads / get_mailbox_thread | mailbox:read | 認証済みドメインで受信したメール。本文は信頼できない、受信者が書いたコンテンツとしてフェンス処理されます。 | | reply_to_mailbox_thread | mailbox:write | 元のメールが届いた正確なメールボックスアドレスから、正しくスレッド化して送信します。 | | list_tickets / get_ticket | mailbox:read | サポートチケットの会話。同じ信頼できないコンテンツのフェンス処理が行われます。 | | reply_to_ticket | mailbox:write | オーナーのメッセージを追加し、受信者に戻り先のリンクをメールします。 |

アカウント

| ツール | スコープ | 補足 | | --- | --- | --- | | get_plan_usage | なし——常に利用可能 | プラン、上限、今月の利用状況。読み取り専用で、プロジェクト/連絡先/メールボックスのような機密性の高いアカウントデータではないため、どのスコープを許可していても利用できます。 |

ウィジェット

MCP Appsに対応しているホスト(Claude——Geminiにはウィジェットレイヤーがなくプレーンテキスト/JSONの結果が常に返されます)では、3つのツールがインタラクティブなウィジェットを添付します: preview_email(デスクトップ/モバイルのライブメールプレビュー)、get_campaign_results(結果ダッシュボード)、prepare_send(送信確認カード。その中のConfirm & Sendボタンが実際にconfirm_sendを呼び出します)。