📦 Smartsuite

SmartSuite 是一个工作管理平台，集项目管理、CRM 和数据库功能于一体。各种规模的团队用它集中组织工作流、跟踪进度和管理数据。 官方文档：https://developers.smartsuite.com/

SmartSuite 概览 Solution · Table · Record · Comment · View

何时使用哪个 action：按需使用 action 名称与参数。

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

安装 CLI npm install -g @membranehq/cli@latest

认证 membrane login --tenant --clientName= 交互环境会打开浏览器；无头环境将打印授权 URL，用户完成登录后执行： membrane login complete 任意命令加 --json 可输出机器可读 JSON。

Agent 类型：claude、openclaw、codex、warp、windsurf 等，用于优化工具适配。

连接 SmartSuite membrane connection ensure "https://www.smartsuite.com/" --json 用户浏览器完成认证，输出含新 connection id。URL 会被归一化并匹配已知应用；未匹配则自动创建并构建连接器。

若返回 state: "READY"，直接进入第 2 步。

1b. 等待连接就绪 状态为 BUILDING 时轮询： npx @membranehq/cli connection get --wait --json --wait 最长 --timeout 秒（默认 30）直到状态变化。 结果状态说明： READY — 完成，进入第 2 步。 CLIENT_ACTION_REQUIRED — 需用户或代理操作，clientAction 对象描述： type: "connect" 需认证；"provide-input" 需补充信息。 description: 人类可读说明。 uiUrl（可选）：预构建 UI 地址。 agentInstructions（可选）：给 AI 代理的编程指引。 用户完成后再次轮询，直到状态变为 READY。 CONFIGURATION_ERROR / SETUP_FAILED — 出错，查看 error 字段。

搜索 action 用自然语言描述需求： membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 始终在指定连接下搜索。结果含 id、name、description、inputSchema、outputSchema。

常用 action Name · Key · Description List Members · list-members · 列出工作区成员（支持过滤分页） Get Table · get-table · 按 ID 获取表结构及字段定义 List Tables · list-tables · 列出工作区所有表 Get Solution · get-solution · 按 ID 获取解决方案 List Solutions · list-solutions · 列出所有解决方案 Delete Record · delete-record · 删除表中记录 Update Record · update-record · 部分更新记录 Create Record · create-record · 新建记录 Get Record · get-record · 按 ID 获取单条记录 List Records · list-records · 列表查询记录（支持过滤、排序、分页）

执行 action membrane action run --connectionId=CONNECTION_ID --json 传 JSON 参数： membrane action run --connectionId=CONNECTION_ID --input '{"key":"value"}' --json 结果在 response.output 字段。

代理请求 当现有 action 不满足需求，可通过 Membrane 代理直接调用 SmartSuite API。Membrane 自动补全 base URL 并注入认证头，凭证过期时透明刷新。