Basecamp MCP

Basecamp MCP服务器

一个MCP（模型上下文协议）服务器，为Claude Code提供Basecamp 4 API的完整访问。

特性

• 32工具 涵盖整个Basecamp 4 API：

- 项目（列表、获取、创建、更新、回收） - 待办事项列表和待办事项（CRUD，完成/不完成） - 消息（列表、获取、创建、更新） - 评论（列表、创建、更新） - 人员（列表、获取当前用户、项目成员） - 计划条目（列表、获取、创建、更新） - 文档（列表、获取、创建、更新）

• OAuth 2.0身份验证 具有自动令牌刷新功能

• 速率限制 使用重试指导进行处理

先决条件

• Node.js 18+
• Basecamp 4帐户
• 来自Basecamp的OAuth应用程序凭据

设置

1.注册Basecamp OAuth应用程序

1. 首选 https://launchpad.37signals.com/integrations
2. 点击“注册您的申请”
3. 填写详细信息：

- 名字：Claude Code MCP（或您喜欢的任何名称） - 网站：您的网站或 http://localhost - 重定向URI: http://localhost:9876/callback

1. 保存并记录您的 客户端ID 和 客户端密钥

2.查找您的帐户ID

您的Basecamp帐户ID位于Basecamp URL中：

https://3.basecamp.com/YOUR_ACCOUNT_ID/...

3.设置环境变量

将这些添加到您的shell配置文件中(.bashrc, .zshrc等等）：

export BASECAMP_CLIENT_ID="your-client-id"
export BASECAMP_CLIENT_SECRET="your-client-secret"
export BASECAMP_ACCOUNT_ID="your-account-id"

4.构建MCP服务器

cd basecamp-mcp
npm install
npm run build

5.配置克劳德代码

将MCP服务器添加到您的Claude Code配置中。创建或编辑 .mcp.json 在项目根目录中：

{
  "basecamp": {
    "command": "node",
    "args": ["/path/to/basecamp-mcp/dist/index.js"],
    "env": {
      "BASECAMP_CLIENT_ID": "${BASECAMP_CLIENT_ID}",
      "BASECAMP_CLIENT_SECRET": "${BASECAMP_CLIENT_SECRET}",
      "BASECAMP_ACCOUNT_ID": "${BASECAMP_ACCOUNT_ID}"
    }
  }
}

6.添加权限（可选）

要自动批准Basecamp工具，请添加到 .claude/settings.json:

{
  "allow": [
    "mcp__basecamp__*"
  ]
}

首次运行

首次使用时，MCP服务器将：

1. 打开浏览器进入Basecamp的授权页面
2. 授权后，重定向到 localhost:9876/callback
3. 将代币存储在 ~/.basecamp-mcp/tokens.json

后续运行将使用存储的令牌（自动刷新）。

可用工具

项目

大惊小怪

消息

评论

人们

日程表

文件

使用示例

# List all projects
basecamp_list_projects

# Get project details (includes dock IDs for other tools)
basecamp_get_project project_id:12345

# Create a to-do
basecamp_create_todo project_id:12345 todolist_id:67890 content:"Review PR #123" due_on:"2024-01-20"

# Post a message
basecamp_create_message project_id:12345 message_board_id:11111 subject:"Sprint Update" content:"
All tasks completed!
"

故障排除

“缺少BASECAMP_CLIENT_ID或BASECAMP_LIENT_SECRET”

确保在shell中设置并导出环境变量。

“缺少BASECAMP_ACCOUNT_ID”

在Basecamp URL中查找您的帐户ID（后面的数字 3.basecamp.com/).

OAuth流程未完成

• 确保端口9876可用
• 检查Basecamp应用程序中的重定向URI是否完全匹配： http://localhost:9876/callback

速率限制（429个错误）

服务器将报告 Retry-After 价值。请稍候，然后重试。

令牌存储

OAuth令牌存储在 ~/.basecamp-mcp/tokens.json 具有受限权限（600）。要重新进行身份验证，请删除此文件并重新启动Claude Code。

API 参考

基于 Basecamp 4 API.