Elasticemail MCP Server

🚀 Copilotとの統合ツール

このプロジェクトは、Elastic Email APIと連携したCopilot統合ツールです。.NET SDK 10以上が必要で、特定のポート設定と設定ファイルを使用してサーバーと接続します。様々なツールを提供し、キャンペーン管理やメール送信などの操作を行うことができます。

🚀 クイックスタート

必要条件

• .NET SDK 10以上
• Elastic Email APIへの接続が必要です。
• HTTP用にポート5001を開放してください。

Copilot統合手順

1. VS Codeを使用します。
2. チャットウィンドウを開きます。
3. 'Agent'モードを選択します。
4. settings.jsonファイルを使用してmcpサーバーに接続します（このファイルを含むフォルダを開きます）。
5. "servers"の近くに小さなコントロールが表示されるはずです。
6. 設定ファイルをエージェントのコンテキストとして追加します。
7. "Select tools..."ウィンドウを開きます（ドライバーとレンチのアイコンをクリック）。
8. mcpサーバーを見つけ、すべてのツールが選択されていることを確認します。
9. "Start"をクリックします。

エージェントの設定例

"my-server-unique-number": {
    "url": "http://localhost:5001/",
    "headers": {
        "X-Auth-Token": <api_key>
    }
}

💻 使用例

基本的な使用法

上記の手順に従って、Copilotとの統合を行い、各ツールを使用してキャンペーン管理やメール送信などの操作を行います。

📚 ドキュメント

ツール一覧

• HealthCheck.IsReady - Elastic Email APIサーバーが利用可能で応答しているかを確認するツール
• CampaignManagement.CreateCampaign - システム内にキャンペーンを作成します。
• CampaignManagement.ListCampaigns - 既存のキャンペーンを一覧表示します。
• CampaignManagement.GetCampaign - キャンペーンの詳細を取得します。
• CampaignManagement.Pause - キャンペーンの処理を停止します。
• CampaignManagement.UpdateCampaign - キャンペーンのデータを変更します（ステータス編集により再開可能）。
• CampaignManagement.GetAllCampaignStatistics - すべてのキャンペーンの統計情報（開封メール数など）を取得します。
• CampaignManagement.GetCampaignStatistics - キャンペーン（名前で指定）の統計情報（開封、クリックなど）を取得します。
• SegmentsManagement.CreateSegment - 新しいセグメントを作成します。
• SegmentsManagement.GetSegments - 既存のセグメントの一覧を取得します。
• SegmentsManagement.GetSegment - 名前でセグメントを取得します。
• TemplateManagement.FetchTemplate - テンプレートの詳細を取得します。
• TemplateManagement.FetchTemplates - テンプレートの一覧を取得し、タイプとアクセシビリティでフィルタリングします。
• EmailSending.SendBulkEmails - 複数のユーザーにメールを送信します（コンタクトリストを使用可能）。コンテンツを提供するか、テンプレートを使用します。
• EmailSending.SendTransactionalEmail - コンタクトにメールを送信します。テンプレートを提供できます。
• ContactsManagement.FetchContacts - コンタクトの一覧を取得します。
• ContactsManagement.FetchContactHistory - コンタクトの履歴を取得します（有効になっている場合）。
• ContactsManagement.FetchLists - すべてのコンタクトリストを取得します。
• ContactsManagement.FetchList - コンタクトリストの詳細を取得します。
• ContactsManagement.FetchListContacts - リスト内のコンタクト（名前で指定）を取得します。
• ContactsManagement.AddContactToList - コンタクトをリストに追加します。
• ContactsManagement.RemoveContactsToList - 提供されたコンタクトをリストから削除します（名前で指定）。
• ContactsManagement.CreateList - 新しいコンタクトリストを作成します。
• ContactsManagement.AddContact - 新しいコンタクトを追加します。
• ContactsManagement.DeleteContacts - コンタクトを削除します（メールアドレスを提供）。
• ContactsManagement.UploadContacts - ファイルから新しいコンタクトをアップロードして追加します。