mailinapp
Documentation menu

AIコネクタ

ClaudeまたはGeminiをMailInAppアカウントに接続すれば、チャットからインタラクティブメールのデザイン、送信、結果の確認ができます——「商品ドロップのメールを作って」「先週のアンケートに誰が答えた?」「火曜日のニュースレターをアクティブな登録者リストに送って」といったことも可能です。アシスタントは、スタジオ内のAIコパイロットを動かしているのと同じツール利用の中核部分を通じて、あなたの実際のプロジェクトを編集し、実際のデータを読み取ります。コネクタは、その第二の入口にすぎません——スタジオ自身のサイドパネルの代わりに、あなたに代わってAIプラットフォームがそれを保持している、という違いだけです。

どこでも同じ1つのURL

https://mailinapp.com/api/mcp

どのプラットフォームも、まったく同じこのURLに接続します——Streamable HTTPを介したリモートMCPサーバーです。事前に何かを設定しておく必要はありません。クライアントが接続した瞬間に、サーバーが認証方法(OAuth 2.1、あなたの明示的な同意付き)を通知し、あとはプラットフォーム側が処理します。プラットフォームごとの手順はClaudeとGeminiにあります。

接続すると何が起こるか

  1. 上記のURLを、ClaudeまたはGemini自身のコネクタ設定に貼り付けます。
  2. プラットフォームが、あなたとしてログインした状態でブラウザにMailInAppの同意画面を開きます。
  3. 複数の会社に所属している場合(自分のアカウントに加え、アクティブなメンバーとして参加しているチーム)、この接続がどの会社として動作するかを選びます——1つの接続は常にちょうど1つのアカウントに紐づきます。
  4. どの権限(「スコープ」)を許可するかを選びます——スコープと権限を参照してください。読み取り専用のものはすべて事前にチェックされていますが、メール送信はされていません。
  5. 承認すると、アシスタントはそのアカウントに代わってMailInAppのツールを呼び出せるようになります。

このフローを完了するまで、何も共有されません——接続してもパスワードやAPIキーが渡されるわけではなく、プラットフォームに渡されるのはスコープが限定された、取り消し可能なトークンです。

できること

  • デザイン — プロジェクトのブロックツリーとテーマを読み取り・編集し、44種類のブロックカタログを閲覧し、保存済みまたはコミュニティのテンプレートを適用し、ライブプレビューをレンダリングします。
  • 結果の読み取り — キャンペーンの開封/クリック/回答/収益、フォームの質問ごとの集計、注文、送信履歴、繰り返し送信のスケジュール、プランの利用状況。
  • オーディエンスの管理 — 連絡先リストの一覧表示、連絡先の検索・追加・更新、サプレッションの管理。
  • 返信 — メールボックスのスレッドとサポートチケット。いずれも、受信者が書いた信頼できないコンテンツとして区別されます(セキュリティを参照)。
  • 送信 — prepare_send → confirm_sendという2段階のフローで、何かを送信する前に必ず受信者数とレンダリング済みプレビューを提示します。ツールの全リストはツールリファレンスを、送信がどのように制限されているかの詳細はセキュリティを参照してください。

意図的にできないこと

どのツールも、Stripeや課金には触れません(チャージバックの返金はダッシュボードのみで行います)。APIキーの発行、Webhookシークレットのローテーション、SMTP/決済/ドメイン設定の変更、チーム招待の管理も行いません——これは、editor権限のチームメイトがすでに他のあらゆる場所で制限されているのと同じ範囲です。campaigns:sendはデフォルトでは決して許可されず、許可されていても送信には上記の2段階確認が必要です。

プランでの利用可否

コネクタはFreeを含むすべてのプランで利用できます——プロジェクトや結果を読み取り、新しく作成することには、追加のコストは一切かかりません。計測されるのは、カレンダー月あたりのツール呼び出し回数(Freeでは200、プランに応じて増加)と、別枠として、コネクタが1か月に送信できる受信者数(Freeでは0——送信には少なくともStarterが必要です)です。正確な数値は料金を、今月の利用状況はダッシュボードのConnectionsを参照してください。

接続の管理

ダッシュボードのConnections(/dashboard/connections)には、承認したすべてのアシスタントが——クライアント名、許可したスコープ、最後に呼び出しがあった時刻とともに——一覧表示され、ワンクリックのRevokeがあります。取り消しは即座に反映されます——そのアシスタントが保持しているすべてのトークンは、次の呼び出しから使えなくなります。期限切れを待つ必要はありません。