Kanbox MCP

坎博克斯mcp


MCP服务器 坎博克斯 LinkedIn CRM API。显示两个调度程序工具-- kanbox_read （4项行动）和 kanbox_write （5个动作）-用于Claude Code和其他MCP客户端。

用例

• CRM分类 --搜索未读收件箱邮件，阅读对话，然后起草和发送回复——所有这些都来自你的编辑器。
• 管道管理 --按管道/步骤查询联系人，根据对话上下文更新标签或在步骤之间移动联系人。
• 外联自动化 --建立潜在客户列表，向破冰者发送个性化的连接请求，并在连接后跟进消息。
• 铅富集 --通过LinkedIn URL添加潜在客户，以全面丰富背景，然后调查处理状态，直到完成。
• 联系人查询 --向内部解决LinkedIn个人资料问题 linkedin_id 无需离开您的工作流程，即可进行消息传递。

设计

此服务器使用 双刀具调度模式 而不是暴露9个单独的MCP工具。灵感源自 Jesse Vincent关于MCP API设计的文章，目标是：

• 最小的上下文占用空间 --LLM客户端将每个工具定义加载到其上下文窗口中。两个带有动作路由的工具的上下文成本远低于九个单独的工具定义，为实际对话留下了更多空间。
• 自我记录 --每个工具的描述都包括带有参数名称和陷阱的完整操作目录。LLM从工具定义本身获得所需的一切，而不需要系统提示中的外部文档。
• 读/写权限拆分 --MCP客户端可以使用两个工具而不是一个工具自动批准 kanbox_read 同时要求明确确认 kanbox_write.
• 平淡的回答 -Kanbox API将联系人数据嵌套在 lead.* 和 lnuser.* 钥匙。此服务器将响应扁平化，因此字段如下 linkedin_id, firstname, email 出现在顶层，减少LLM解析嵌套结构所花费的令牌。

关键响应字段

search_members 返回最丰富的数据——这些是您的收件箱/连接联系人：

id, linkedin_id, linkedin_public_id, firstname, lastname, email, phone, company, job, location, labels, pipeline, step, icebreaker, custom, conversations （与 id, last_message, unread_count)

search_leads 返回抓取的潜在客户数据（否 linkedin_id --通过解决 search_members):

linkedin_public_id, firstname, lastname, email, phone, company, job, location

list_lists 返回列表元数据：

name, count, is_processing

设置

在Kanbox设置中，在“API”部分启用“启用API密钥”，然后在您的环境中设置令牌：

export KANBOX_API_TOKEN=your_api_key

Claude代码配置

添加 ~/.claude/settings.json:

{
  "mcpServers": {
    "kanbox": {
      "command": "npx",
      "args": ["-y", "github:flacoste/kanbox-mcp"],
      "env": {
        "KANBOX_API_TOKEN": "${KANBOX_API_TOKEN}"
      }
    }
  }
}

不需要本地克隆——npx获取仓库，安装依赖项，并自动构建。

本地安装

如果您更喜欢本地副本：

git clone https://github.com/flacoste/kanbox-mcp.git
cd kanbox-mcp
npm install  # also builds via prepare script

然后将配置指向本地构建：

{
  "command": "node",
  "args": ["/path/to/kanbox-mcp/dist/index.js"],
  "env": {
    "KANBOX_API_TOKEN": "${KANBOX_API_TOKEN}"
  }
}

工具

kanbox_read

对Kanbox数据的只读查询。

search_members

搜索收件箱、连接或未读邮件。

search_leads

按列表名称或查询搜索抓取的潜在客户。

get_messages

获取对话消息。

list_lists

列出可用的Kanbox潜在客户名单。

kanbox_write

写入操作。所有写入都是异步的（HTTP 202接受）。

update_member

更新成员字段。

send_message

发送LinkedIn消息。

send_connection

发送连接请求。

add_lead

将结构化潜在客户添加到列表中（仅部分丰富）。

add_lead_url

通过LinkedIn URL添加潜在客户，以实现全面丰富（需要几分钟）。

主要惯例

• linkedin_id vs公共蛞蝓 — search_members 返回a linkedin_id 字段（内部ID以开头 ACoAAA...).使用此ID send_message 和 send_connection，而不是公众形象。
• 标签完全替换 — update_member 标签将替换整个标签集。首先阅读现有标签，然后传递完整的所需列表。
• 异步写入 --所有写入操作都返回HTTP 202。更改可能需要几秒钟才能在后续读取中显示。
• 领导vs成员 — search_leads 不返回 linkedin_id.使用 search_members 和 linkedin_public_ids 以解析消息传递所需的内部ID。

发展

npm run build       # tsc -> dist/
npm run dev         # tsx src/index.ts
npm test            # vitest run
npm run test:watch  # vitest (watch mode)

许可证

麻省理工学院