שרת ה-MCP של Elasticsearch, הרצנו אותו חי על Mac אמיתי.

• כלים

  4, נספרו בריצה חיה

• אישורי גישה

  נדרשים כתובת אשכול ומפתח [5]

• ערוץ תקשורת

  stdio, רץ על ה-Mac שלכם [5]

• מתחזק

  Elastic, רשמי אך הוצא משימוש [1][6]

• הורדות

  1.7 אלף בשבוע האחרון [2]

• רישיון

  Apache-2.0 [4][1]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם npx על גבי stdio, השלמנו את לחיצת היד של MCP, קראנו ל-tools/list וביצענו ארבע קריאות tools/call אמיתיות, אחת לכל כלי. טבלת הכלים למטה היא הלכידה הזו, מילה במילה. קריאות שעובדות ממתינות לאישור גישה שאין לנו: אשכול Elasticsearch שאפשר להגיע אליו, כלומר ES_URL שעונה יחד עם ES_API_KEY עבורו, או צמד ES_USERNAME ו-ES_PASSWORD. הפעלנו את השרת עם כתובת דמה על פורט מת במקום, ולכן כל ארבע הקריאות חזרו עם שגיאת החיבור המודפסת למטה. זה מוכיח שהשרת עולה, מדבר MCP וסופר את מלוא ערכת הכלים שלו בלי שום אשכול באופק. זה לא מוכיח שכלי כלשהו מסוגל לקרוא נתונים, ואיננו טוענים זאת. ריצה שנייה עם ארגומנטים שגויים במתכוון וריצה שלישית עם ES_URL ריק נתנו לנו עוד שתיים מהשגיאות שבעמוד, ריצה רביעית עם מטמון npm נקי נתנה לנו את הודעת ההוצאה משימוש ש-npm מדפיס בהתקנה, וריצה חמישית בלי OTEL_LOG_LEVEL ספרה את אותם ארבעה כלים, וכך אנחנו יודעים שהמשתנה הזה אופציונלי.

{"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"elasticsearch-mcp","version":"0.3.1"}},"jsonrpc":"2.0","id":1}

tools/call list_indices {"indexPattern": "*"}

Error: connection failed (http://localhost:9201/)

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 4 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

{
  "mcpServers": {
    "elasticsearch-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@elastic/mcp-server-elasticsearch"
      ],
      "env": {
        "ES_URL": "<your-elasticsearch-url>",
        "ES_API_KEY": "<your-api-key>",
        "OTEL_LOG_LEVEL": "none"
      }
    }
  }
}

claude mcp add --env ES_URL=https://your-cluster.example:9243 --env ES_API_KEY=your_api_key --transport stdio elasticsearch -- npx -y @elastic/mcp-server-elasticsearch

{
  "mcpServers": {
    "elasticsearch-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@elastic/mcp-server-elasticsearch"
      ],
      "env": {
        "ES_URL": "<your-elasticsearch-url>",
        "ES_API_KEY": "<your-api-key>"
      }
    }
  }
}

Name        Elasticsearch
Command     npx
Arguments   -y @elastic/mcp-server-elasticsearch
Environment ES_URL = https://your-cluster.example:9243
            ES_API_KEY = your_api_key

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Elasticsearch בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים כמה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.

1. 01

   התקינו את Routines

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

2. 02

   אספו את כתובת האשכול ומפתח API

   השרת הזה צריך שני דברים לפני שהוא מסוגל לענות על משהו: כתובת של אשכול Elasticsearch שאפשר להגיע אליו, כתובה במלואה עם ‎https://‎ ועם הפורט, ואישור גישה עבורו. ההנחיה של Elastic עצמה היא ליצור מפתח API ייעודי במקום להשתמש במפתח ניהולי: הרשאת האשכול monitor, ולצדה read ו-view_index_metadata רק על האינדקסים שתרצו שהעוזר יראה.

3. 03

   פתחו את הגדרות ה-MCP

   לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

4. 04

   בחרו Command (stdio)‎

   העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה, לא כתובת אינטרנט. Name: Elasticsearch. Command: npx. Arguments: ‎-y @elastic/mcp-server-elasticsearch. הערך בשדה ה-Arguments מתפצל לפי רווחים, ולכן שתי המילים האלה נכנסות בדיוק כפי שהן כתובות.

5. 05

   הוסיפו את שני המשתנים, בדקו, ואז הוסיפו

   ב-Environment Variables הוסיפו את ES_URL עם כתובת האשכול, ואחריו את ES_API_KEY עם המפתח. לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, ארבעה עבור השרת הזה. שווה לדעת מהריצה שלנו: ארבעת הכלים נספרים גם כשהכתובת לא מובילה לשום מקום, ולכן התייחסו לבדיקה שעברה כהוכחה שהשרת עלה, לא כהוכחה שהאשכול ענה. אחר כך לחצו Add Server.

6. 06

   השתמשו בו

   הכלים עובדים בצ׳אט מיד, כך שאפשר לשאול אילו אינדקסים יש באשכול בלי לצאת מהשיחה. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

Error: connection failed (http://localhost:9201/)

Server error: [
  {
    "code": "too_small",
    "minimum": 1,
    "type": "string",
    "inclusive": true,
    "exact": false,
    "message": "Elasticsearch URL cannot be empty",
    "path": [
      "url"
    ]
  },
  {
    "validation": "url",
    "code": "invalid_string",
    "message": "Invalid Elasticsearch URL format",
    "path": [
      "url"
    ]
  }
]

MCP error -32602: Invalid arguments for tool list_indices: [
  {
    "code": "invalid_type",
    "expected": "string",
    "received": "undefined",
    "path": [
      "indexPattern"
    ],
    "message": "Required"
  }
]

npm warn deprecated @elastic/mcp-server-elasticsearch@0.3.1: This package is deprecated. Please see the README at https://github.com/elastic/mcp-server-elasticsearch for details on how to run v0.4.0 or later.

שאלות נפוצות

שאלות שאנשים שואלים.

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

1. [1]

   npm registry: @elastic/mcp-server-elasticsearchנקרא בתאריך 2026-08-03

   Latest version 0.3.1, published 2025-07-01, license Apache-2.0, engines node >=18, and a deprecated field carrying the notice npm prints on install. Five versions in total, from 0.1.0 in March 2025.

2. [2]

   npm downloads API: last weekנקרא בתאריך 2026-08-03

   1,717 downloads for the week ending 2026-08-01, and 6,184 for the month ending the same day.

3. [3]

   GitHub: elastic/mcp-server-elasticsearchנקרא בתאריך 2026-08-03

   701 stars, 144 forks, 5 open issues and 10 open pull requests, not archived, license detected as Apache-2.0, and a push dated 2026-07-31 at access time, per the GitHub API. The same API shows the main branch tree holding Cargo.toml, Cargo.lock and a Dockerfile with no package.json.

4. [4]

   LICENSE at tag v0.3.1נקרא בתאריך 2026-08-03

   The plain Apache License, Version 2.0 text.

5. [5]

   README at tag v0.3.1, the version on npmנקרא בתאריך 2026-08-03

   The npx config block we ran, the four-tool list, the environment variable table (ES_URL required, ES_API_KEY or ES_USERNAME and ES_PASSWORD for auth), the least-privilege API key recipe, and the line stating the features are experimental and not production-ready.

6. [6]

   README on the main branch, after deprecationנקרא בתאריך 2026-08-03

   The caution banner naming the Agent Builder MCP endpoint as the successor, available in Elastic 9.2.0 and later and in Serverless projects, plus container image instructions that apply to 0.4.0 and later.

7. [7]

   Elastic docs: Agent Builder MCP serverנקרא בתאריך 2026-08-03

   The endpoint at {KIBANA_URL}/api/agent_builder/mcp, the space-scoped variant, and the API key versus OAuth 2.1 comparison.

8. [8]

   modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

   Where claude_desktop_config.json lives and how Claude Desktop loads it.

9. [9]

   Claude Code docs: MCPנקרא בתאריך 2026-08-03

   The claude mcp add syntax, the repeatable --env flag and the rule that a server name must not follow it directly, and why the double dash separates Claude Code options from the server command.

10. [10]

    Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

    The mcp.json shape and file locations.

11. [11]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את Elasticsearch כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.