English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

AIアシスタントでAdapty Mailを管理する（MCP）

Adapty Mail はMCPサーバーを実行しており、AIアシスタントがあなたのプロジェクト内でダッシュボード上と同じように作業できます。具体的には、キャンペーンの生成とローカライズ、フローの起動、送信ドメインの設定、プロファイルの検索、アナリティクスの閲覧などが可能です。アシスタントはあなた自身のAdapty Mailアカウントでサインインし、ダッシュボードで接続を承認すると権限が付与されます。APIキーは不要です。

サーバー URLhttps://api-mail.adapty.io/mcp
プロトコルMCP over Streamable HTTP、OAuth 2.1 サインイン
対応クライアントClaude（web・デスクトップ）、ChatGPT、Claude Code、Codex CLI、GitHub Copilot CLI、Gemini CLI、Cursor、Windsurf、および OAuth 対応のリモート MCP サーバーをサポートするすべてのクライアント
Tip

コーディングエージェントで最良の結果を得るには、Adapty Mail スキルも追加してください。サーバーへの接続を代行し、実際のユーザーにメールを送信する前に確認を取り、配信結果・A/B テスト・未受信の原因分析など、リリース後の作業もサポートします。

アシスタントでできること

サーバーのツールはダッシュボードを反映しています：

エリア例
オリエンテーション会社とプロジェクトの確認、不足しているセットアップ手順の把握
ブランドストアリストからブランドを構築し、内容を確認・編集する
送信ドメインドメインの追加、DNS レコードの取得、確認状況のチェック、ドメインの健全性の確認
送信先メールのリンク先ページを作成・更新する
キャンペーンブリーフからキャンペーンを生成し、メールの編集・翻訳・テスト送信を行う
フローとセグメントセグメントの作成、フローの開始・変更
A/B テストテストの作成・開始・終了
プロファイルプロファイルとそのジャーニーを検索し、配信停止を行う
アナリティクスキャンペーンの指標の時系列推移、内訳、A/B テストのファネル
設定送信者名、返信先アドレス、ダブルオプトイン、画像アップロード

ガイド付きワークフローは、対応クライアントでプロンプトとして利用できます。Claude Codeでは /mcp__adaptymail__campaign_to_flow のようなスラッシュコマンドとして表示されます。

  • campaign_to_flow: ブリーフからキャンペーンを生成し、配信先とセグメントを選択して、フローを起動します。
  • campaign_localization: 保存済みのキャンペーンを他の言語に翻訳します。
  • domain_onboarding: 送信ドメインを追加し、DNSレコードを公開して確認します。

セットアップの一部はダッシュボードのみで行う手順です：会社住所の設定、Webチェックアウトの設定、データ送信の有効化です。

始める前に

  • プロジェクトのメンバーシップ: Adapty Mail アカウントが、作業対象のプロジェクトのメンバーであること。アシスタントが参照できるのは、あなたのアカウントでアクセス可能な企業とプロジェクトのみです。
  • クライアントのサポート: クライアントが OAuth 対応のリモート MCP サーバーをサポートしていること。
Warning

アシスタントはあなたと同じ権限を持ち、その操作はすべて実際に反映されます。フローを保存すると、実際のユーザーへのメール送信が開始されます。サーバーは破壊的なツールにマークを付けており、テストしたアシスタントは実行前に確認を求めます。承認する前に、アシスタントの実行計画をよく確認してください。

アシスタントを接続する

Claude（claude.ai およびクロードデスクトップ）

  1. サーバーを追加するには、Settings → Connectors を開き、Add custom connector をクリックします。
  2. 名前（例：Adapty Mail）と URL https://api-mail.adapty.io/mcp を入力します。
  3. Authentication は Sign in now のままにし、OAuth クライアントは検出されたデフォルトのままにして、Add をクリックします。
  4. 開いた Adapty Mail タブでログインを求められた場合はログインし、Approve をクリックします。

ワークスペース管理者は、組織全体に対して一度だけコネクタを追加できます。各メンバーは初回使用時に自分の Adapty Mail アカウントでサインインします。

ChatGPT

ChatGPT は Settings のコネクターページからカスタム MCP サーバーを追加します。ワークスペースで開発者モードが有効になっている必要があります。

  1. サーバーを追加するには、Create をクリックします。
  2. 名前（例：Adapty Mail）とサーバー URL https://api-mail.adapty.io/mcp を入力します。Authentication は OAuth のままにしてください。
  3. カスタム MCP サーバーの警告に同意し、Create をクリックします。
  4. ChatGPT から確認を求められたら、サーバーを接続します。表示された Adapty Mail タブで必要に応じてログインし、Approve をクリックします。

Claude Code

claude mcp add --transport http --scope user adaptymail https://api-mail.adapty.io/mcp

サインインするには、Claude Code で /mcp を実行し、adaptymail を選択して Authenticate をクリックします。その後、ブラウザで Adapty Mail ダッシュボードにログインし、Approve をクリックします。

Codex CLI

codex mcp add adaptymail --url https://api-mail.adapty.io/mcp
codex mcp login adaptymail

ログインコマンドを実行するとブラウザが開き、接続を承認できます。手動でサーバーを設定する場合は、~/.codex/config.toml に追加してからログインコマンドを実行してください：

[mcp_servers.adaptymail]
url = "https://api-mail.adapty.io/mcp"

GitHub Copilot CLI

copilot mcp add --transport http adaptymail https://api-mail.adapty.io/mcp

サーバーへの初回接続時、ブラウザが開いてサインインを求められます。

Gemini CLI

gemini mcp add --transport http --scope user adaptymail https://api-mail.adapty.io/mcp

新しいセッションを開始し、/mcp auth adaptymail を実行してブラウザで接続を承認してください。

Cursor、Windsurf、その他のクライアント

クライアントの MCP 設定ファイル（例：~/.cursor/mcp.json）にサーバーを追加します：

{
  "mcpServers": {
    "adaptymail": {
      "url": "https://api-mail.adapty.io/mcp"
    }
  }
}

初回接続時、クライアントがブラウザを開いてサインインを求めます。リモートサーバーへの OAuth に対応していないクライアントは Adapty Mail に接続できません。

接続を承認する

クライアントはすべて、Adapty Mail ダッシュボードの同じ画面で終了します。この画面には、アクセスを要求しているアプリケーション名と、そのアクセスを受け取るアドレスが表示されます。デスクトップツールの場合、そのアドレスはご自身のコンピューター上（localhost）にあるため、自分で開始した接続のみ承認してください。完了するには、Approve をクリックします。

接続リクエストは 10 分後に期限切れになります。画面に This request has expired と表示された場合は、クライアントから再度やり直してください。

作業を開始する

アシスタントにプロジェクトの一覧を表示するよう頼み、作業したいプロジェクトを指定してください。試してみるリクエストの例:

  • 「プロジェクトのオンボーディングステータスを表示して、何が不足しているか教えて。」
  • 「トライアルが期限切れになったユーザー向けのウィンバックキャンペーンを英語で生成して、最初のメールを見せて。」
  • 「キャンペーン「Trial expired」をドイツ語とフランス語に翻訳して。」
  • 「mail.example.com を送信ドメインとして追加して、DNS レコードを教えて。」
  • 「過去30日間のライブキャンペーンの開封率とクリック率を比較して。」

切断

切断するには、クライアントの設定でコネクタを削除します。Claudeの場合は Settings → Connectors、ChatGPTの場合はコネクタのページから、Claude Codeの場合は claude mcp remove adaptymail を実行してください。

クライアントのアクセストークンは1時間以内に期限切れになります。リフレッシュトークンはクライアントが切断した時点で失効し、未使用の場合は90日後に期限切れになります。再度接続するには、サーバーを追加して接続を承認し直してください。

トラブルシューティング

問題解決策
ダッシュボードに接続リクエストが期限切れと表示されるクライアントから接続を再開し、10 分以内に承認してください。
アシスタントにプロジェクトが見つからないと表示されるアカウントがそのプロジェクトのメンバーではありません。会社のオーナーにアクセスを依頼してください。
アシスタントがログアウトされた長時間アイドル状態が続いた場合、または切断した後にアクセスが期限切れになります。クライアントから再接続してください。
クライアントにツールが表示されないクライアントがサインインせずに接続されています。サインインの手順を実行してください（例：Claude Code の /mcp）。