Kosa MCP Server

什么是 Kosa MCP Server？

Kosa MCP Server 将 Claude 和其他 MCP 客户端连接到风险投资机构的 Kosa 记录，让智能体可以查询交易、公司、人员、基金、投后动态、关系强度和会议简报。

Kosa 将自己描述为一个能自我构建的、AI 原生的风险投资记录系统。它连接机构的邮件、日历、会议和文档，无需手动录入即可提取人员、公司、交易、投后动态和关系。Kosa 称自己“由智能体构建，为智能体服务”，而托管在 https://api.getkosa.ai/tools 的 Kosa MCP 服务器正是外部智能体访问这些记录的方式。每次调用都限定在已认证的机构范围内；没有公开数据集。

如何使用 Kosa MCP Server？

你需要一个 Kosa 账号。Kosa 目前处于早期访问阶段，新机构需要通过官网的候补名单申请访问。

服务器通过无状态的 Streamable HTTP 运行，地址为：

https://api.getkosa.ai/tools

认证采用带 PKCE 和动态客户端注册的 OAuth 2.1，因此客户端会自动发现授权流程，登录在浏览器中完成。早期访问机构也可以获得 API 密钥，以 Authorization: Bearer 请求头发送。

Claude Code

claude mcp add --transport http kosa https://api.getkosa.ai/tools

首次连接时，Claude Code 会在浏览器中打开 Kosa 授权流程。

如果你的机构获得了 API 密钥，也可以改用请求头传递：

claude mcp add --transport http kosa https://api.getkosa.ai/tools --header "Authorization: Bearer ${KOSA_API_KEY}"

Claude Desktop 和 claude.ai

进入 Settings > Connectors，选择 Add custom connector，粘贴 https://api.getkosa.ai/tools，并在提示时登录。

Cursor

将以下内容添加到 ~/.cursor/mcp.json 或 .cursor/mcp.json：

{
  "mcpServers": {
    "kosa": {
      "url": "https://api.getkosa.ai/tools"
    }
  }
}

VS Code

将以下内容添加到 .vscode/mcp.json：

{
  "servers": {
    "kosa": {
      "type": "http",
      "url": "https://api.getkosa.ai/tools"
    }
  }
}

Kosa MCP Server 的主要功能

• 按机构隔离的记录：来自你自己 Kosa 工作区的交易、公司、人员、基金和投资机构，绝不会在机构之间共享。
• 管道与投后分析：Kosa 文档列出了按阶段、轮次和行业团队拆分交易流、基金部署、QSBS 资格日期以及投后财务数据的工具。
• 关系洞察：lookup-connection-strength 和 lookup-cross-team-overlap 等工具会评估团队与某人的熟悉程度，以及谁已经联系过对方。
• 会议准备：get-upcoming-meetings、get-meeting-brief 和 prep-board-meeting 会为即将召开的会议汇集背景信息。
• 跨机构内容搜索：文档、用户本人的邮件、会议记录，以及语义搜索。
• 权限等级：每个凭据带有 read_only、read_write 或 full 等级。创建或移动交易等写操作需要 read_write；机构管理员的评分规则工具需要 full。超出等级的调用会返回 PERMISSION_DENIED。
• 发现类资源：schema 和枚举资源（例如 kosa://schema/deals 和 kosa://enums/deal.stage）会在写入前说明字段和工作区词汇。

根据 Kosa 的文档，其工具注册表共有 86 个工具：56 个读取工具和 30 个写入工具。

Kosa MCP Server 的使用场景

• 会议准备：“为我的下一场会议做个简报：我要见谁、过去的对话，以及我们与他们的交易历史。”
• 放弃记录：“我们去年为什么放弃了这家公司？”
• 熟人引荐：“团队里谁最熟悉这位创始人？”或“哪些投资机构适合这一轮，我们和他们有多熟？”
• 管道复盘：“按阶段显示活跃交易，并标出停滞的交易。”
• 投后报告：“为我的投资组合公司写一份周报”或“显示我负责的公司的 ARR、跑道和员工人数。”
• 更新记录：持有 read_write 凭据时，“把这些交易移到下一阶段”或“为这家公司创建一笔交易”。

Kosa MCP Server 常见问题排查

• 写操作返回 PERMISSION_DENIED：你的凭据等级太低。修改记录需要 read_write，管理评分规则需要 full。
• HTTP 429：MCP 和 REST 调用共享每个凭据的每分钟请求额度。请等待 Retry-After 请求头中给出的秒数后再重试。
• 返回未授权：该端点需要登录。请在客户端中完成 OAuth 流程，或确认 API 密钥以 Authorization: Bearer 发送。
• 工具上限：部分工具有额外限制，例如 onboarding_start 每位用户每小时 10 次，外部数据补全和网页调研有每次对话的额度。