Elastic Email MCP

公式

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

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

  • Manage contact lists — Ask your assistant to create lists, add contacts, upload contacts in bulk, or remove contacts from a list or account.
  • Build and run campaigns — Have your assistant create, list, update, or pause email campaigns, and fetch existing campaign details.
  • Send transactional and bulk emails — Direct your assistant to send individual or mass emails through your Elastic Email account.
  • Retrieve account data — Ask your assistant to fetch contacts, contact lists, templates, or segments for review or reporting.
  • Verify server connectivity — Ask your assistant to run a health check to confirm the MCP connection and readiness before starting tasks.

ドキュメント

MCPサーバーのアドレス https://mcp.elasticemail.com は、AIエージェントの接続にのみ使用されます。これはElastic Email REST APIのアドレスではなく、他の統合でAPIホストとして使用することはできません。APIアドレスについては、記事「API設定」を参照してください。

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に接続する必要があります

  • Github CopilotでVisual Studio Codeを承認します

  • 次のステップでVS Codeを実行することを許可します

  • チャットウィンドウを表示するには、VS Codeの上部メニューで表示→チャットに移動します。チャットは右側に表示されます。

  • チャットをエージェントモードに切り替えます

  • Elastic EmailでAPIキーを作成します。表示および変更に必要な権限は次のとおりです:アカウント、テンプレート、キャンペーン、連絡先、ファイル、HTTP送信。これに加えて、アクセストークンへの少なくとも「表示」アクセスが必要です。APIキーを許可のない第三者と決して共有しないでください。
  • VS Codeの上部バーで検索機能を使用して、コマンドの表示と実行を見つけます
  • 検索フィールドに「MCP」と入力して利用可能なオプションを絞り込み、「MCP: ユーザー設定を開く」を選択します。
  • 以下のような設定テキストを貼り付けます(すでにサーバーがある場合は、elasticemail.mcpのデータだけで十分です)
{
    "servers": {
        "elasticemail.mcp": {
            "url": "https://mcp.elasticemail.com",
            "headers": {
                "X-Auth-Token": "your_api_key"
            }
        }
    }
}

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

  • これでMCPサーバーへの接続を開始できます:設定ファイル内のelasticemail.mcpの上にある「開始」をクリックします。

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

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

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

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

ヒント

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