Kapa MCP Server已验证已精选

什么是 Kapa MCP Server？

Kapa MCP Server 是 Kapa 官方的平台 MCP 服务器，地址为 https://mcp.kapa.ai/mcp。它让编码智能体设置、检查和查询 Kapa 知识库；该知识库会索引来自 Zendesk、Confluence、Notion、GitHub、Slack 等来源的文档、工单、维基和代码。

Kapa 是一个检索平台。它把公司的技术知识索引成统一的知识库，并基于知识库给出带引用的回答。Kapa 插件会把平台 MCP 服务器接入你的智能体，并附带 19 个设置技能（每种来源类型一个）以及三个命令。你只需用 Kapa 账号登录一次，工具就会以你的身份、按你的真实权限运行。这个连接无需配置 API key。此外，Kapa 还支持为每个项目部署托管 MCP 服务器，地址为 <subdomain>.mcp.kapa.ai，同事或客户可以在自己的 AI 工具中检索同一份知识。

如何使用 Kapa MCP Server？

你需要一个 Kapa 账号，并在 app.kapa.ai 上拥有团队。推荐安装插件，因为它会带上为每种来源规定正确调用顺序的技能。

Claude Code

在 Claude Code 中：

/plugin marketplace add kapa-ai/kapa-plugin
/plugin install kapa@kapa

或在终端中：

claude plugin marketplace add kapa-ai/kapa-plugin
claude plugin install kapa@kapa

然后用 /mcp 登录。

Codex

codex plugin marketplace add kapa-ai/kapa-plugin
codex plugin add kapa@kapa

也可以在 Codex 中运行 /plugins，选择 Add Marketplace，输入 kapa-ai/kapa-plugin，然后安装 kapa。

Cursor

在 Cursor 的智能体聊天中运行 /add-plugin kapa，或从 Cursor Marketplace 页面安装。

Gemini CLI

gemini mcp add kapa https://mcp.kapa.ai/mcp --transport http

Claude Desktop、VS Code 及其他客户端

任何 MCP 客户端都可以直接添加该服务器：

{ "mcpServers": { "kapa": { "url": "https://mcp.kapa.ai/mcp" } } }

在 VS Code 中，将其添加到 .vscode/mcp.json，设置 "type": "http" 和相同的 url。在 Claude Desktop 或 claude.ai 中，用该 URL 添加自定义连接器。首次连接时会在浏览器中登录。然后把插件的 skills/ 文件夹复制到客户端读取技能的位置，这样智能体获得的不只是工具列表，还有调用顺序。

连接后，可以使用命令，或者直接提问，例如“把我们的文档站点添加到 Kapa”。

Kapa MCP Server 的主要功能

• 托管服务，无需 API key。 登录一次后，每个工具都按你自己的 Kapa 权限运行。
• 19 个设置技能。 每个技能对应一种来源类型，并包含人们常遗漏的额外步骤，例如把 Slack 机器人邀请进频道，或把 Notion 页面共享给集成。
• 三个命令。 /kapa-setup 连接知识来源，/kapa-check 查看项目包含什么以及能否回答问题，/kapa-gaps 找出用户在问但内容尚未覆盖的问题。
• 广泛的来源覆盖。 网页抓取、GitHub（文件、issue、discussion、pull request）、Zendesk（帮助中心、工单）、Confluence、Jira、Jira Service Management、Notion、Slack、Discord、Discourse、Google Drive、OpenAPI、YouTube、S3 以及手写答案。
• 安全的抓取。 网页抓取可以先预览并调整内容选择器，再消耗导入配额。
• 在智能体中查看分析。 覆盖缺口和热门问题都以工具形式提供。

Kapa MCP Server 工具

插件的智能体指南和技能列出了主要工具。

• 项目与来源： list_projects 无需参数，返回你的团队及其项目。list_sources 显示项目的来源及状态。每种来源类型都有一个返回 id 的 create_*_source 调用，然后是配置调用。保存配置即开始导入。
• 网页抓取： create_web_crawl_source、set_crawl_config、preview_crawl、list_preview_pages、inspect_content_selector、set_content_selector 和 start_crawl。只有 start_crawl 会消耗配额。
• 检索： search_project_knowledge 针对项目运行测试问题。search_kapa_docs 检索 Kapa 自己的文档。
• 分析： get_coverage_gaps、get_top_questions、list_coverage_gaps_periods 和 list_top_questions_periods。

按项目部署的托管 MCP 服务器则不同。它提供 search_<PRODUCT_NAME>_knowledge_sources、可选的 get_<PRODUCT_NAME>_knowledge_documents 工具，以及 give_feedback。

Kapa MCP Server 的使用场景

• 接入来源：“把我们的文档站点添加到 Kapa”，并在导入前预览抓取结果。
• 连接支持数据：“把我们的 Zendesk 帮助中心和工单设为来源。”
• 检查回答质量：运行 /kapa-check 列出来源，并通过 search_project_knowledge 测试一个问题。
• 发现文档缺口：运行 /kapa-gaps 汇总覆盖缺口和热门问题，然后起草缺失内容。
• 在 GitHub、Jira 和工程 Slack 频道之上构建内部知识服务器，分享给用 Kapa 账号登录的同事。

Kapa MCP Server 常见问题排查

• 工具因认证错误而失败： 重新登录 kapa 服务器。在 Claude Code 中使用 /mcp，其他客户端会提示登录。
• 某个来源没有导入任何内容： 保存前先使用该来源的验证和发现工具。否则凭据错误只会表现为一个默默不导入任何内容的来源。
• 网页抓取没有开始： 在运行 start_crawl 之前，抓取不会导入任何内容。先用 preview_crawl 和 list_preview_pages 预览。
• 智能体只看到工具，看不到设置步骤： 如果没有通过插件安装，请把仓库中的 skills/ 复制到客户端的技能文件夹。