配置 MCP - Kept AI Docs

将兼容 MCP 的客户端连接到您的 Kept 项目。

开始之前#

在设置 → API 密钥中创建个人令牌，并使用包含 geo_ 前缀的完整值。读取项目分析需要相应访问权限；账号没有可见项目时，项目列表为空。

配置客户端#

Claude Desktop

{
  "mcpServers": {
    "kept": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.keptai.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${KEPT_AUTH_HEADER}"
      ],
      "env": {
        "KEPT_AUTH_HEADER": "Bearer <geo_token>"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "kept": {
      "url": "https://app.keptai.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KEPT_API_TOKEN}"
      }
    }
  }
}

Claude Code

claude mcp add --transport http kept https://app.keptai.com/mcp \
  --header "Authorization: Bearer $KEPT_API_TOKEN"

**Claude Desktop：**先安装 Node.js，在本地配置文件中使用 mcp-remote 桥接。替换占位令牌，保存后重启客户端。**Cursor：**确保客户端进程可读取 KEPT_API_TOKEN 环境变量；变量值只包含令牌，不包含 Bearer 前缀。**Claude Code：**运行命令前，先在终端设置 KEPT_API_TOKEN。

验证连接#

重新连接客户端，要求它列出 Kept 工具。服务共有 10 个只读工具。先调用 list_projects，再将返回的 host 用于 get_overview 或其他项目工具。

接口为 POST https://app.keptai.com/mcp，使用 Streamable HTTP 和 Authorization: Bearer。不支持 OAuth。通过普通浏览器打开接口地址不能验证 MCP 连接。

排查问题#

**401：**核对令牌、请求头和撤销状态。
**没有项目：**确认令牌所属账号可以访问哪些项目。
**429：**遵循 Retry-After。每个令牌每个 UTC 自然小时最多接受 600 条已鉴权 POST 消息，包括初始化与通知。
**工具错误：**重试前检查 isError 和错误信息，核对 host 与参数。

准确参数请参考可用工具。