MCP 経由で Elasticsearch を Microsoft Copilot に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Elasticsearch をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Elasticsearch + Microsoft Copilot

AI に、Elastic Cloud、Serverless、自社サーバー上の Elasticsearch クラスターを探索、照会させます。インデックスとデータストリームの一覧、マッピングの読み取り、検索、集計、件数カウント、ES|QL の実行ができ、確認のうえでドキュメントの書き込みも行います。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

ELASTICSEARCH_URL, ELASTICSEARCH_API_KEY

ステップ 1 — 認証情報を取得

1. Elasticsearch のエンドポイントを確認します。Elastic Cloud Hosted: https://cloud.elastic.co でデプロイメントを開き、Elasticsearch endpoint をコピーします（例: https://my-deployment.es.europe-west3.gcp.cloud.es.io）。Serverless: プロジェクトを開き、Elasticsearch のエンドポイントをコピーします。セルフマネージド: クラスターが応答する HTTPS アドレスとポートです（例: https://search.example.com:9200）。末尾のスラッシュを付けずに ELASTICSEARCH_URL に貼り付けます。Kibana のアドレスではなく、Elasticsearch のエンドポイントを使ってください。
2. Kibana の Stack Management → API keys → Create API key（Serverless ではプロジェクト設定 → API keys）で API キーを作成します。anythingmcp などの名前と有効期限を付け、Control security privileges をオンにして権限を絞ります（下記参照）。
3. Encoded の値（base64）をコピーします。Elastic はこの値を 1 回しか表示しません。ELASTICSEARCH_API_KEY に貼り付けて、コネクタをインストールします。id や api_key の値だけでは動作せず、ユーザー名とパスワードによる認証には対応していません。
4. elasticsearch_whoami で設定を確認します。権限は不要で、キーの所有者を表示します。

対応するクラスター: Elastic Cloud Hosted、Elastic Cloud Serverless、バージョン 8 以降のセルフマネージドクラスター。AnythingMCP Cloud からはインターネット経由で到達できるクラスターが必要です。セルフホストの AnythingMCP なら、管理者がそのホストを許可すれば社内ネットワークのクラスターにも接続できます。

読み取り専用キー（推奨）: Kibana のフォームで次のロール記述子を使うか、Kibana の Dev Tools でリクエストを実行し、応答の encoded をコピーします。

POST /_security/api_key
{
  "name": "anythingmcp-read",
  "expiration": "365d",
  "role_descriptors": {
    "anythingmcp_read": {
      "cluster": ["monitor"],
      "indices": [
        { "names": ["*"], "privileges": ["read", "view_index_metadata", "monitor"] }
      ]
    }
  }
}

"*" は、AI に見せてよいインデックスパターン（例: ["products", "logs-*"]）に置き換えてください。read は検索、件数、集計、ES|QL、単一ドキュメントを、view_index_metadata はマッピング、エイリアス、データストリームを、monitor はインデックス一覧とクラスターの状態をカバーします。キーが作成したユーザー以上の権限を持つことはありません。

AI ができること: インデックス、エイリアス、データストリームの一覧表示、クエリ前のフィールドマッピングの確認、Query DSL による検索（既定 10 件、1 回あたり最大 100 件）、値ごとの件数、合計、平均、日付ヒストグラムなどの集計、一致件数のカウント、表形式の回答のための ES|QL クエリ（最大 500 行）、単一ドキュメントの読み取り。一般的なベクトルフィールドは検索結果から除外されます。Elastic がクラスターを運用する Serverless では、クラスターの状態は取得できません。

書き込みは先に確認します: elasticsearch_index_document はドキュメント全体を作成または置き換え、elasticsearch_update_document はドキュメントの一部のフィールドを変更します。どちらの場合も、AI はインデックス、_id、内容を示してから、あなたの同意を待ちます。両方とも write 権限が必要なため、上の読み取り専用キーでは 403 で失敗します。これは意図した安全策です。

インストール時はオフ: elasticsearch_delete_document と elasticsearch_delete_by_query。削除は元に戻せず、delete by query は数百万件のドキュメントを消すこともあります。管理者が意図して有効にします。有効にした後も、AI はまず対象ドキュメントの件数を数え、削除の前に確認します。

よくあるエラー: 401: キーが間違っている、期限切れ、無効化されている、または Encoded の値ではなく id が貼り付けられています。403 security_exception: メッセージに書かれた権限がキーにありません。404 index_not_found_exception: インデックス名が存在しません。400 parsing_exception または verification_exception: クエリに誤りがあります。メッセージにフィールドや位置が示されます。429: クラスターが過負荷です。少し待ってから再試行してください。

このコネクタが通信するのは Elasticsearch だけで、Kibana には接続しません。インデックスの作成や削除、マッピングや設定の変更、スナップショット、インジェストパイプライン、セキュリティ管理、Bulk API には対応していません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Microsoft Copilot にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Elasticsearch のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

• 「どんなインデックスがあり、それぞれのドキュメント数とサイズはどれくらいですか？」
• 「products インデックスで 100 ユーロ未満のワイヤレスヘッドホンを検索し、名前、ブランド、価格を見せてください。」
• 「ES|QL で、logs- の過去 24 時間のエラー数をホストごとに数え、上位 10 件を見せてください。」*
• 「9 月の 1 日あたりの注文数は？orders インデックスで日付ヒストグラムを使ってください。」
• 「products インデックスの商品 4711 の stock フィールドを 0 にしてください。変更する前に内容を見せてください。」

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続