前言¶
运维和安全团队日常要在 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 服务。
-
标准化 MCP 接口
外部 MCP 宿主连到 Kibana，使用你在 Agent Builder 中配置的工具（内置与自定义工具；部分仅适用于 Agent Builder 聊天的工具可能无法通过 MCP 暴露，以官方 built-in tools 说明为准）。 -
固定端点形态
- 默认 Space：{KIBANA_URL}/api/agent_builder/mcp
- 自定义 Kibana Space：{KIBANA_URL}/s/{SPACE_NAME}/api/agent_builder/mcp
可在 Kibana Tools 界面复制 MCP 服务器 URL。 -
鉴权路径
- API Key：适用于 Elastic Stack 与 Serverless，适合自动化、无人值守的机机访问。
- OAuth 2.1（应用连接）：Serverless 场景下适合 Claude Desktop、Cursor 等交互式宿主；多用户各自授权。
缺少feature_agentBuilder.read等 Kibana 应用权限时，连接端点会得到403 Forbidden（见 API Key 文档）。 -
跨项目数据
若通过 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 均已就绪的前提下，工作流通常分两层：
-
Agent（Skill）层
根据用户意图选择是否走 Kibana MCP：确认目标 Space、索引范围、是否适合 API Key 还是 OAuth，并提醒最小权限（例如生产环境将 API Key 限制到logs-*、metrics-*等索引，官方 best practices 有完整 JSON 示例）。 -
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
