Elastic Email MCP

公式

Elastic Email MCPサーバーを使用すると、GitHub Copilot、ChatGPT、Claude、その他の互換性のあるアシスタントなどのAIエージェントが、Elastic Emailアカウントとシームレスに統合できるようになります。

Elastic Email MCPで何ができますか?

  • 連絡先をリストに追加 — アシスタントに、特定の連絡先リストに購読者を追加するよう依頼します。
  • キャンペーンの作成と管理create_campaignupdate_campaignpause_campaignlist_campaigns を使用して、メールキャンペーンの作成、更新、一時停止、一覧表示を行います。
  • 一括メールとトランザクションメールの送信 — AIに指示して、Elastic Emailアカウントを通じて直接メールを送信します。
  • アカウントリソースの取得 — 既存の連絡先、リスト、セグメント、テンプレートを取得し、現在の設定内容を確認します。
  • 連絡先の削除 — 特定のリストから、またはアカウント全体から連絡先を削除します。
  • 接続状態の確認 — ヘルスチェックにより、MCPサーバーが接続され正常に動作していることを確認します。

ドキュメント

MCPを実装することで、Elastic EmailはAIエージェントがセキュリティと適切な認証を維持しながら、メール操作にアクセスして制御できるようにします。

当社のMCPが実行できる利用可能なアクション

  • リストに連絡先を追加
  • 連絡先をアップロードして追加
  • リストを作成
  • セグメントを作成
  • キャンペーンを作成
  • キャンペーンを取得
  • キャンペーンを更新
  • キャンペーンを一時停止
  • キャンペーンを一覧表示
  • メール送信:トランザクションメールと一括メールの両方
  • 連絡先、連絡先一覧、リスト内の連絡先を取得
  • リストを取得
  • テンプレートを取得
  • セグメントを取得
  • 準備完了(ヘルスチェック、接続および準備状態の確認)
  • リストから連絡先を削除
  • アカウントから連絡先を削除

記載されているすべてのエンドポイントが、すべてのElastic Email料金プランで利用できるわけではないことにご注意ください。たとえば、キャンペーンと連絡先のエンドポイントはEmail APIプランでは利用できません。上記の機能に関する利用可能な記事の完全なリストは次のとおりです:

https://help.elasticemail.com/en/articles/4984897-contact-lists-and-segments

https://help.elasticemail.com/en/articles/5472509-how-to-send-your-first-campaign

http://help.elasticemail.com/en/articles/2300606-how-to-manage-templates

セットアップ

当社のMCPサーバーに接続するには、MCPをサポートする任意のAIエージェントを使用できます。セットアップの重要な要件は「エージェントモード」のサポートです。これにより、AIエージェントが外部サービスとプログラム的に安全にやり取りできるようになります。

VS CodeとGithub Copilotツールを使用した段階的なセットアップ例を用意しました。

次に、GithubアカウントをVS Codeに接続する必要があります

  • VS Codeをインストールして実行
  • 左メニューで拡張機能を開き、Github CopilotとGithub Copilot Chat拡張機能をインストール
  • 前の手順で作成したアカウントを使用してGithubにサインイン
  • Github CopilotでVisual Studio Codeを承認
  • 次のステップでVS Codeの実行を許可
  • チャットウィンドウを表示するには、VS Codeの上部メニューでView → Chatに移動します。チャットは右側に表示されます。
  • チャットをエージェントモードに切り替えます
  • Elastic EmailでAPIキーを作成します。表示および変更に必要な権限は次のとおりです:Account、Templates、Campaigns、Contacts、Files、Send HTTP。これに加えて、Access Tokensへの少なくとも「表示」アクセスが必要です。APIキーを許可のない第三者と決して共有しないでください!
  • VS Codeの上部バーで検索機能を使用して、_Show and run commands_を見つけます
  • 検索フィールドに「MCP」と入力して利用可能なオプションを絞り込み、「MCP: Open user configuration」を選択します。
  • 以下のような設定テキストを貼り付けます(すでにサーバーがある場合は、elasticemail.mcpデータだけで十分です)

{
"servers": {
"elasticemail.mcp": {
"url": "https://mcp.elasticemail.com",
"headers": {
"X-Auth-Token": "your_api_key"
}
}
}
}

ここで最も重要な手順は、上記の権限を持つ実際のAPIキーを入力することです。また、このフィールドを変更した後は、先に進む前に変更を保存する必要があります。変更を保存しないと、統合を「開始」するオプションが表示されません。

  • これでMCPサーバーへの接続を開始できます:設定ファイルのelasticemail.mcpの上にあるStartをクリックします。
  • 代替方法:左メニューからExtensionsを選択し、下部のMCP SERVERS INSTALLEDからサーバーを選択し、右クリックしてStart serverを選択します

これ以降、チャットウィンドウ内でElastic Email MCPサーバーが提供するアクションを使用できます。これらのアクションは、この記事の冒頭で概説されています。

統合が機能することを確認するために、最初のコマンドを試すことができます。例として「Is MCP working」というプロンプトを入力すると、すべてが機能していれば確認応答が返ってきます。

この種の統合がElastic Email側でどのように機能するかをより深く理解するには、APIドキュメントもご確認ください:

https://elasticemail.com/developers/api-documentation/rest-api

ヒント

  1. AIエージェントが以前の指示を記憶して再試行し続けることがあります。このような問題を解決するには、新しいチャットセッションを開始すると便利です。また、エージェントにツールを再取得するよう指示し、サーバーに変更があったことを伝えて、実際に新しいデータを再取得するようにしてください。
  2. プロンプトが正確であればあるほど、LLMに解釈の余地を残さず、幻覚に関連する問題を減らすことができます。
  3. リクエストを送信する前に確認すると便利です。LLMがリクエストをAPI呼び出しに変換する際の潜在的な不整合に気付くことができるからです。