Elastic Email MCP Server
公式Elastic Email MCPサーバーを使用すると、GitHub Copilot、ChatGPT、Claude、その他の互換性のあるアシスタントなどのAIエージェントが、Elastic Emailアカウントとシームレスに統合できるようになります。
ドキュメント
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ツールを使用したステップバイステップのセットアップ例を用意しました。
- https://github.com Githubで無料アカウントを作成する必要があります
- https://code.visualstudio.com/ このウェブサイトからVS Codeをダウンロードしてください
次に、GithubアカウントをVS Codeに接続する必要があります
-
VS Codeをインストールして実行します
-
左側のメニューから拡張機能を開き、Github CopilotとGithub Copilot Chat拡張機能をインストールします
-
前の手順で作成したアカウントを使用してGithubにサインインします
-
Github CopilotでVisual Studio Codeを承認します
-
次の手順でVS Codeの実行を許可します
-
チャットウィンドウを表示するには、VS Codeのトップメニューで「表示」→「チャット」に移動します。チャットは右側に表示されます。
-
チャットをエージェントモードに切り替えます
-
Elastic EmailでAPIキーを作成します。表示および変更に必要な権限は次のとおりです: アカウント、テンプレート、キャンペーン、連絡先、ファイル、HTTP送信。さらに、アクセストークンに対する少なくとも「表示」アクセス権が必要です。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の上にある「開始」をクリックします。
-
別の方法: 左側のメニューから「拡張機能」を選択し、下部の「MCP SERVERS INSTALLED」からサーバーを選択し、右クリックして「Start server」を選択します
これで、チャットウィンドウ内でElastic Email MCPサーバーが提供するアクションを使用できます。これらのアクションは、この記事の冒頭で概説されています。
統合が機能することを確認するために、最初のコマンドを試すことができます。例として「Is MCP working」プロンプトを入力し、すべてが機能していれば、確認の返信が返ってくるはずです。
この種の統合がElastic Email側でどのように機能するかについてより深く理解するには、APIドキュメントもご確認ください:
https://elasticemail.com/developers/api-documentation/rest-api
ヒント
- AIエージェントは以前の指示を記憶して再試行し、行き詰まることがあります。このような問題を解決するには、新しいチャットセッションを開始すると便利です。また、サーバーに変更があったことを伝え、ツールを再取得するようにエージェントに指示することで、実際に新しいデータを再取得するように促すこともできます。
- プロンプトが正確であればあるほど、LLMが解釈する余地が減り、ハルシネーション関連の問題が軽減されます。
- リクエストを送信する前に確認することは有用です。LLMがリクエストをAPI呼び出しに変換する際の潜在的な不整合に気付く可能性があるためです。