Basecamp

Basecamp Basecamp 是一款项目管理和团队沟通工具，各种规模的企业都用它来集中组织项目、任务和讨论。团队借助它协作、跟踪进度并保持信息同步。 官方文档：https://github.com/basecamp/bc3-api

Basecamp 概览 Project Campfire —— 项目聊天室 Message Board —— 发布公告与讨论 To-do List To-do Item Schedule —— 事件与截止日期 Automatic Check-in —— 定期提问 Docs & Files File Document Forwarding Address —— 通过邮件向 Basecamp 发送内容

使用 Basecamp 本技能通过 Membrane CLI 与 Basecamp 交互。Membrane 自动处理认证与凭证刷新，让你专注集成逻辑，无需操心鉴权细节。

安装 CLI 全局安装 Membrane CLI，以便在终端运行 membrane： npm install -g @membranehq/cli@latest

认证 membrane login --tenant --clientName= 若支持交互模式，将自动打开浏览器；否则在控制台打印授权 URL。 无头环境：命令会打印授权 URL，请用户用浏览器打开。登录完成后看到验证码，执行： membrane login complete 任意命令后加 --json 可输出机器可读的 JSON。

Agent 类型：claude、openclaw、codex、warp、windsurf 等，用于根据所用 harness 优化工具。

连接 Basecamp 使用 membrane connection ensure 按应用 URL 或域名查找或创建连接： membrane connection ensure "" --json 用户在浏览器完成认证，输出包含新连接 id，这是最快获取连接的方式。URL 会被规范化为域名并与已知应用匹配；未找到则自动创建应用并构建连接器。

若返回的连接 state 为 "READY"，直接进入第 2 步。

1b. 等待连接就绪 若连接处于 BUILDING 状态，轮询直至就绪： npx @membranehq/cli connection get --wait --json --wait 最长轮询 --timeout 秒（默认 30），直到状态变化。持续轮询直到状态不再是 BUILDING。

结果状态说明： READY —— 连接已完全建立，进入第 2 步。 CLIENT_ACTION_REQUIRED —— 用户或 agent 需执行操作。clientAction 对象描述所需动作： clientAction.type —— 动作类型： "connect"：用户需认证（OAuth、API key 等），包括初次认证与断线重连。 "provide-input"：需补充信息（如选择要连接的应用）。 clientAction.description —— 人类可读说明。 clientAction.uiUrl（可选）—— 预构建 UI 地址，可展示给用户。 clientAction.agentInstructions（可选）—— 给 AI agent 的程序化指引。 用户完成动作后，再次执行 membrane connection get --json 检查状态是否变为 READY。

CONFIGURATION_ERROR 或 SETUP_FAILED —— 出错，查看 error 字段获取详情。

搜索动作 用自然语言描述需求进行搜索： membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 务必在特定连接上下文中搜索。每条结果包含 id、name、description、inputSchema（参数）、outputSchema（返回值）。

常用动作 Name Key Description List Projects list-projects 列出当前用户可见的所有项目 List Messages list-messages 列出留言板中的所有消息 List To-dos list-todos 列出待办列表中的所有待办 List To-do Lists list-todo-lists 列出待办集中的所有待办列表 List Comments list-comments 列出记录（消息、待办等）下的所有评论 List People list-people 列出当前用户可见的所有成员 List Project People list-project-people 列出指定项目中的所有成员 Get Project get-project 按 ID 获取指定项目 Get Message get-message 按 ID 获取指定消息 Get To-do get-todo 按 ID 获取指定待办 Get To-do List get-todo-list 按 ID 获取指定待办列表 Get Comment get-comment 按 ID 获取指定评论 Get Person get-person 按 ID 获取指定成员 Create Project create-project 创建新项目 Create Message create-message 在留言板创建新消息 Create To-do create-todo 在待办列表创建新待办 Create To-do List create-todo-list 在待办集创建新待办列表 Create Comment create-comment 在记录下创建新评论