前言¶

运维和安全团队日常要在 Kibana 里查日志、跑 ES|QL、用 Agent Builder 工具。若希望 Cursor、Claude Desktop 等 MCP 宿主直接调用同一套能力，需要知道 Kibana 暴露的 MCP 端点、鉴权方式和客户端配置格式，而不是每次手工翻文档拼 JSON。

下面介绍的 Skill 来自 SkillHub 社区坐标 @user_3c6cb52e/elastic-kibana-mcp-server（v1.0.0，分类 it-ops-security）。它本身不单独实现 MCP 服务，而是把 Agent 引导到 Elastic 官方的 Agent Builder MCP 能力与文档；Skill 包内的 SKILL.md 也写明未能自动抽取完整安装步骤，敏感环境应先核对上游再启用。

这是什么¶

一句话定位： 面向大模型 Agent 的 Skill 条目，主题是通过 Model Context Protocol 连接 Kibana 上的 Elastic Agent Builder MCP 服务器。

维护与来源： SkillHub 页面显示发布者为 user_3c6cb52e，来源为 community；Skill 元数据将上游指向 elastic/elasticsearch，并引用 Elasticsearch 参考文档。实际 MCP 行为由 Elastic Stack / Elastic Cloud 中的 Kibana Agent Builder 提供，而非 Skill 目录里再装一个独立二进制。

解决的问题： 让 Agent 在对话中遵循统一说明——端点路径、Space、鉴权选项——去配置 MCP 宿主，从而在外部客户端里使用 Agent Builder 工具（官方文档举例：在 Claude Desktop 中执行 ES|QL 而无需打开 Kibana UI）。

核心功能¶

以下能力来自 Elastic Agent Builder MCP server 官方说明，Skill 的作用是把这些约束写进 Agent 的工作流，而不是替代 Kibana 服务。

1. 标准化 MCP 接口
   外部 MCP 宿主连到 Kibana，使用你在 Agent Builder 中配置的工具（内置与自定义工具；部分仅适用于 Agent Builder 聊天的工具可能无法通过 MCP 暴露，以官方 built-in tools 说明为准）。

2. 固定端点形态
   - 默认 Space：{KIBANA_URL}/api/agent_builder/mcp
   - 自定义 Kibana Space：{KIBANA_URL}/s/{SPACE_NAME}/api/agent_builder/mcp
   可在 Kibana Tools 界面复制 MCP 服务器 URL。

3. 鉴权路径
   - API Key：适用于 Elastic Stack 与 Serverless，适合自动化、无人值守的机机访问。
   - OAuth 2.1（应用连接）：Serverless 场景下适合 Claude Desktop、Cursor 等交互式宿主；多用户各自授权。
   缺少 feature_agentBuilder.read 等 Kibana 应用权限时，连接端点会得到 403 Forbidden（见 API Key 文档）。

4. 跨项目数据
   若通过 cross-project search 关联多个项目，工具调用会使用 MCP URL 对应 Space 的默认跨项目搜索范围；URL 不含 /s/{SPACE} 时使用 default space。

SkillHub 标签 requires_api_key=false 表示安装该 Skill 时不需要 SkillHub 的 API Key；连接 Kibana MCP 仍须按 Elastic 文档配置 API Key 或 OAuth。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

按 SkillHub 安装说明 检查或安装：

command -v skillhub && skillhub --version

未安装时可执行完整安装脚本（文档中的推荐方式）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 将 Skill 装入当前 Agent 的 skills 目录¶

SkillHub 页面给出的安装提示为：依据上述安装文档，安装坐标 @user_3c6cb52e/elastic-kibana-mcp-server。命令形态如下（--dir 必须指向当前宿主识别的 skills 目录，否则默认落在 ./skills/ 且可能不被加载）：

skillhub install @user_3c6cb52e/elastic-kibana-mcp-server --dir <skills 目录>

常见路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后按你所用客户端要求重启或刷新 Agent，使 SKILL.md 生效。

3. 在 MCP 宿主侧配置 Kibana（与 Skill 并列的必要步骤）¶

Skill 包内未提供可自动验证的一键安装脚本；真正打通查询能力的是 MCP 宿主对 Kibana 的配置。Elastic 文档给出的 API Key 方式示例（适用于 Claude Desktop、Cursor、VS Code 等）如下。

先创建具备 Agent Builder 读权限的 API Key（节选，完整字段见官方文档）：

POST /_security/api_key
{
  "name": "my-mcp-api-key",
  "expiration": "30d",
  "role_descriptors": {
    "mcp-access": {
      "cluster": ["monitor_inference"],
      "indices": [
        {
          "names": ["*"],
          "privileges": ["read", "view_index_metadata"]
        }
      ],
      "applications": [
        {
          "application": "kibana-.kibana",
          "privileges": ["feature_agentBuilder.read", "feature_actions.read"],
          "resources": ["space:default"]
        }
      ]
    }
  }
}

在 MCP 配置中加入远程端点（通过 mcp-remote 转发请求头）：

{
  "mcpServers": {
    "elastic-agent-builder": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "${KIBANA_URL}/api/agent_builder/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "KIBANA_URL": "${KIBANA_URL}",
        "AUTH_HEADER": "ApiKey ${API_KEY}"
      }
    }
  }
}

环境变量示例：

export KIBANA_URL="your-kibana-url"
export API_KEY="your-api-key"

若使用自定义 Space，将 URL 中的路径替换为 /s/{SPACE_NAME}/api/agent_builder/mcp。Serverless 且需要多人各自身份时，可改用文档中的 OAuth 2.1 应用连接流程。

典型用法¶

在 Skill 与 MCP 均已就绪的前提下，工作流通常分两层：

1. Agent（Skill）层
   根据用户意图选择是否走 Kibana MCP：确认目标 Space、索引范围、是否适合 API Key 还是 OAuth，并提醒最小权限（例如生产环境将 API Key 限制到 logs-*、metrics-* 等索引，官方 best practices 有完整 JSON 示例）。

2. MCP 工具层
   宿主连上 {KIBANA_URL}/api/agent_builder/mcp 后，调用 Elastic Agent Builder 暴露的工具。官方文档举例：在外部客户端中对你的数据运行 ES|QL，而无需打开 Kibana。

具体工具名称与参数以当前 Elastic 版本和项目中启用的 Agent Builder 工具为准；Agent 应先读 Skill 与 Elastic 文档，避免臆造索引名或字段名。

适用场景与注意¶

适合谁

• 已部署 Elastic Stack 9.3+（或 9.2 预览）或 Elastic Cloud Serverless，并启用 Agent Builder 的团队。
• 希望在 Cursor / Claude Desktop / VS Code 等 MCP 宿主里复用 Kibana 侧工具，同时用 Skill 约束 Agent 的配置与合规检查步骤。
• SkillHub 分类 it-ops-security 所覆盖的观测、安全运维类对话场景。

限制与坑

• Skill 正文明确：没有自动抽取、未经上游背书的安装与用法不应在敏感流程中直接执行；生产前务必对照 MCP server 与 API Key 鉴权 原文。
• MCP 与 Skill 是两层：只装 Skill 不会自动出现 Kibana 连接；只配 MCP 而不装 Skill，Agent 也可能缺少索引权限与端点格式的提醒。
• API Key 需包含 feature_agentBuilder.read，并建议设置过期时间与最小索引权限。
• SkillHub 统计（抓取时）：评分 100000，下载 1209，安装计数 0；以页面实时数据为准。

结尾¶

Elastic / Kibana MCP 服务器 Skill 的价值在于：把 Kibana Agent Builder MCP 的端点、鉴权与客户端配置收敛成 Agent 可执行的说明，并与 SkillHub 安装流程 @user_3c6cb52e/elastic-kibana-mcp-server 对齐。能力本身仍由 Elastic 官方 MCP 服务提供。

• SkillHub API 条目：https://api.skillhub.cn/user_3c6cb52e/elastic-kibana-mcp-server
• SkillHub 页面：https://www.skillhub.cn/skills/user_3c6cb52e/elastic-kibana-mcp-server
• Elastic MCP 文档：https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/mcp-server