MailInApp
Documentation menu

ツールリファレンス

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

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

検出

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

メールデザイン

ツールスコープDestructive補足
list_projectsprojects:readすべてのプロジェクトのid、名前、用途。
get_emailprojects:readプロジェクトの現在のブロックツリーとテーマ。
preview_emailprojects:read実際の送信用HTMLパイプラインを通してレンダリングします——送信された場合に生成される文書そのものです。ウィジェットが添付されます(下記参照)。
list_block_typesprojects:read実際のレジストリから生成される44種類のブロックカタログ全体——常に最新で、手動で維持されているものではありません。
list_templatesprojects:readあなたの保存済みテンプレート、または承認済みのコミュニティギャラリー。
create_projectprojects:write組み込みの用途別テンプレートから任意でシード可能。
add_block / update_block / move_blockprojects:writeツリーの編集で、スタジオ内コパイロットの編集と同じ方法でcanPlace/フィールドの検証が行われます。
remove_blockprojects:write✓ブロックとその子要素を削除します。
set_themeprojects:writeブランドカラー、フォント、ボタンの角丸。
rename_projectprojects:write
delete_projectprojects:write✓永久に削除されます。
apply_templateprojects:write✓プロジェクトのツリーとテーマ全体を上書きします。
save_as_templatetemplates:write現在のプロジェクトを再利用可能なテンプレートとしてスナップショットします。
publish_landing_pageprojects:writeメールを /lp/<slug> の公開ウェブページとして公開し、その URL を返します。送信と同じく、アシスタントはまずメールを見せてあなたの了承を得るよう指示されています。
unpublish_landing_pageprojects:writeページを非公開にします。アドレスは引き続きあなた用に予約されます。

オーディエンス

ツールスコープDestructive補足
list_data_sourcescontacts:read連絡先リストを含むすべてのデータソース。認証情報の値は決して返されません。
list_contact_listscontacts:read連絡先リストのみ——id、名前、フィールド、行数。
get_contact_list_summarycontacts:read件数、サプレッションの合計、メールアドレスの確認の内訳、直近の再確認の状態——個々の連絡先データは含みません。
find_contactscontacts:read上限付きの検索(最大25行、カーソルによるページネーション)。sortBy: "engagementScore" を指定すると、リストの有望な連絡先をスコアと今週の変化とともに上位から返します。すべての呼び出しは、ダッシュボードでの連絡先読み取りと同じく、個人データアクセスログに記録されます。
upsert_contactscontacts:write行を追加または更新します。プランの連絡先上限を適用します。
remove_contactcontacts:write✓1行を永久に削除します。
add_suppression / remove_suppressioncontacts:writeアドレスをアカウント全体でブロックまたはブロック解除します。受信者自身の配信停止リンクと同じ効果です。

結果

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

送信

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

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

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

ジャーニーとセグメント

ツールスコープDestructive補足
list_journeysjourneys:read各ジャーニーの ID、名前、オン／オフ、トリガーの種類、ステップ数。
get_journeyjourneys:readジャーニーのフロー全体（メール・リスト・セグメントの名前付き）と、実行を妨げる問題。オフで実行可能なジャーニーには enableToken も返します。
list_segmentsjourneys:read保存済みセグメントと、その連絡先リストおよびルール。
create_segmentjourneys:write1つの連絡先リスト上にセグメントを保存します。プランのセグメント上限が適用されます。
build_journeyjourneys:write自然な言葉のリクエストから、ジャーニービルダーの AI コパイロットで新しいジャーニーを作成、またはオフのジャーニーを編集します。AI コパイロットを1ターン消費します。結果は常にオフの状態で保存され、オンのジャーニーは変更されません。
set_journey_enabledjourneys:write（オンにするには + campaigns:send）✓オンにするには、get_journey が返した enableToken を変更せず、10分以内かつその後の編集前に渡す必要があります。prepare_send/confirm_send と同じ2段階の考え方です。一時停止にはどちらも不要です。

アカウント

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

ウィジェット

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