MCP 経由で Mailtrap を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Mailtrap をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Mailtrap + Gemini

Mailtrap のアカウントをあらゆる AI エージェントから操作：トランザクション、バルク、バッチのメール送信、Email Sandbox でのテストとスパム・HTML レポート、送信ドメイン、抑制リスト、テンプレートの管理、送信した各メッセージのメールログでの追跡、送信統計の確認、Email Marketing の連絡先、リスト、キャンペーンの運用。API トークン 1 つで使えます。元に戻せない削除はインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

MAILTRAP_API_TOKEN

ステップ 1 — 認証情報を取得

設定は約 3 分です。Mailtrap のアカウントが必要です。

1. Mailtrap で Settings、API Tokens（https://mailtrap.io/api-tokens）を開き、トークンを作成します。送信ドメイン（送信、統計、ログ、抑制リスト用）、サンドボックスまたはプロジェクト（Email Sandbox 用）、使う場合は Email Marketing へのアクセスを付与します。抑制リストの変更には管理者アクセスが必要です。
2. それを MAILTRAP_API_TOKEN に貼り付けます。Authorization: Bearer <token> として送られ、リセットするまで失効しません。
3. コネクタをインストールして mailtrap_list_accounts を実行します。アクセスレベル（1000 owner、100 admin、10 viewer）付きでアカウントが表示され、トークンを確認できます。トークンは 1 つのアカウントに属し、すべての呼び出しがそのアカウントに対して動くので、アカウント ID は不要です。
4. 実際の送信には検証済みの送信ドメインが必要です（mailtrap_list_sending_domains）。Email Sandbox はドメインなしで使えます。

Mailtrap は機能ごとに別のホストを使い、コネクタはツールごとに正しいホストを選びます。管理とレポートは https://mailtrap.io、トランザクション送信は https://send.api.mailtrap.io、Bulk ストリームは https://bulk.api.mailtrap.io、サンドボックスへのテスト送信は https://sandbox.api.mailtrap.io です。

送信: mailtrap_send_email は 1 通のトランザクションメールを最大 1000 人の宛先に送り、mailtrap_send_batch_emails は 1 回の呼び出しで最大 500 通の異なるメール（最大 50 MB）を送ります。マーケティングメールなどの一斉送信は、プロモーションの配信をトランザクションメールと分ける Bulk ストリームを使い、mailtrap_send_bulk_email と mailtrap_send_bulk_batch_emails で送ります。本文は text、html またはその両方か、保存済みテンプレートです。テンプレートの場合は template_uuid（数値 ID ではなく mailtrap_list_templates の uuid）と template_variables を渡し、subject、text、html、category は省きます。from_email は検証済み送信ドメインのアドレスでなければならず、to、cc、bcc は {"email", "name"} のリスト、添付ファイルは content に Base64 で入れます。送信はすべて実際の受信箱に届くため、AI は宛先、送信者、件名、本文を示してあなたの同意を待ちます。送信すると宛先ごとに 1 つずつ message_ids が返ります。バッチ呼び出しは一部のメッセージが失敗しても 200 を返すため、AI は responses の各エントリの success と errors を確認します。

Email Sandbox: mailtrap_send_sandbox_email はテストメールを送り、それはサンドボックスで受け止められて配信されることはありません。テンプレートや新しい内容を安全に試す方法です。その後 AI は受け止めたメッセージ（mailtrap_list_sandbox_messages、mailtrap_get_sandbox_message）、テキスト、プレビュー用 HTML、HTML ソース、生の MIME としての本文、ヘッダー、添付ファイル、スコアと該当ルール付きの SpamAssassin レポート、どの要素や CSS プロパティがどのメールクライアントで非対応かを示す HTML チェックを読みます。プロジェクトとサンドボックスの一覧表示とサンドボックスの作成もできます。SMTP の認証情報はどの応答にも含まれません。

ドメインと到達率: 公開すべき DNS レコード（SPF、DKIM、DMARC、リターンパス）と検証状況付きで送信ドメインを一覧表示、取得し、ドメインを追加し、DNS 設定手順を DNS 担当者にメールで送ります。抑制されたアドレス（ハードバウンス、配信停止、迷惑メール報告、手動インポート）は原因となったメッセージ付きで一覧でき、mailtrap_create_suppression であるアドレスへの送信を止められます。個々のメールについては、mailtrap_list_email_logs が宛先、ステータス、イベント、カテゴリ、送信時刻で絞り込み、mailtrap_get_email_log がプロバイダの応答付きで配信、開封、クリック、バウンスのイベントを示します。mailtrap_get_sending_stats は期間の合計を、mailtrap_get_sending_stats_grouped はドメイン、カテゴリ、メールボックスプロバイダ、日別の内訳を、mailtrap_get_billing_usage はプランに対する使用量を返します。

テンプレート: テンプレートの一覧、取得、作成、更新ができます。変数は Handlebars で、例えば {{user_name}} です。更新後に送るメールは新しい版を使います。

Email Marketing: ステータス、リスト、フィールド付きの連絡先（ID またはメールアドレスでの作成、取得、更新。オートメーションやセグメント用の purchase などのカスタムイベント。メールアドレスで照合する最大 50,000 件のインポートと mailtrap_get_contact_import での進捗確認）、連絡先リスト、連絡先フィールド（fields のキーになるマージタグ）。キャンペーン：mailtrap_create_campaign は常に下書きを作り、mailtrap_update_campaign は下書きを変更し、mailtrap_schedule_campaign は最大 1 か月先までの日時を設定し、mailtrap_start_campaign はすぐに送信し、mailtrap_cancel_campaign は予約済みキャンペーンを下書きに戻し、mailtrap_get_campaign_stats は結果を示します。予約と開始は配信対象の全員にメールを送るため、AI は先にキャンペーン、配信対象、日時をあなたに確認します。メール受信に同意した連絡先だけを追加し、送るのをやめたい相手は削除せずに配信停止（unsubscribed: true）にしてください。

インストール時はオフ: mailtrap_delete_suppression（そのアドレスに再びメールが届くようになります）、mailtrap_clean_sandbox（サンドボックスのメッセージをすべて削除）、mailtrap_delete_contact です。元に戻せないため、チームに必要になったらワークスペースの管理者がオンにします。

データ形式: ドメイン、サンドボックス、メッセージ、テンプレート、リスト、キャンペーンの ID は整数、連絡先、抑制、メールログのメッセージは UUID です。日時は UTC の ISO 8601 です。統計の率は小数（0.25 = 25%）、統計の日付は YYYY-MM-DD です。

ページング: 連絡先は null になるまで pagination.next_token を token に渡し、キャンペーンは pagination.next_token のページ番号を token に使います。メールログは next_page_cursor を search_after に渡します。抑制は 1 ページ 1000 件で、最後の項目の id を last_id に渡します。サンドボックスのメッセージは 1 ページ 30 件で、page か最後のメッセージ ID を last_id に使います。

制限: トークンごとに 10 秒あたり 150 リクエスト。連絡先は 1 分 200 回、統計と抑制は 1 分 10 回、メールログの一覧はアカウントごとに 1 分 60 回です。

よくあるエラー: 401 Incorrect API token はトークンが間違っているか、そのドメインやサンドボックスへのアクセスがありません。403 は権限不足なので、Settings、API Tokens でトークンを編集してください。404 は不明な ID です。422 は無効な入力で、理由が errors に入ります（例えば検証済みドメインにない送信者や、すでに下書きではないキャンペーン）。429 はレート制限なので、待ってから再試行します。

このコネクタは送信ドメイン、サンドボックス、テンプレート、キャンペーンを削除せず、サンドボックスの SMTP 認証情報も返しません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Mailtrap のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「今朝 [email protected] に送った注文確認メールは届いた？イベントを見せて。」
• 「この新しいウェルカムテンプレートをテスト用サンドボックスに送って、スパムスコアと HTML に問題があるメールクライアントを教えて。」
• 「先週の配信率、バウンス率、迷惑メール率をメールボックスプロバイダ別に見せて。」
• 「うちの送信ドメインでまだ検証されていない DNS レコードはどれ？」
• 「顧客リスト向けに 11 月ニュースレターのテンプレートでキャンペーン下書きを作って、予約する前に配信対象を見せて。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続