📦 Nutshell — 简言之

Nutshell Nutshell 是一个 CRM 与销售自动化平台，面向希望在一个地方管理线索、联系人和交易的 B2B 销售团队。销售代表和经理用它跟踪销售管道并提升团队绩效。 官方文档：https://support.nutshell.com/hc/en-us/categories/200369036-Nutshell-API

Nutshell 概览 Lead Contact Product Activity Opportunity Contact Product Activity Account Contact Activity Contact Activity User Task Meeting Phone Call 按需使用动作名称与参数。

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

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

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

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

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

若返回连接 state 为 "READY"，直接跳到步骤 2。

1b. 等待连接就绪 若连接处于 BUILDING 状态，轮询直至就绪： npx @membranehq/cli connection get --wait --json --wait 会长轮询（默认 --timeout 30 秒）直到状态变化。持续轮询直到状态不再是 BUILDING。结果状态指示下一步： READY — 连接已就绪，跳到步骤 2。 CLIENT_ACTION_REQUIRED — 用户或代理需执行操作。clientAction 对象说明所需动作： clientAction.type — 动作类型："connect"（需认证）、"provide-input"（需补充信息）。 clientAction.description — 人类可读说明。 clientAction.uiUrl（可选）— 预构建 UI 的 URL，可展示给用户。 clientAction.agentInstructions（可选）— 给 AI 代理的编程指令。 用户完成动作后，再次执行 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。

常用动作 名称 键 描述 Find Leads find-leads 按查询分页查找线索 Find Accounts find-accounts 按查询分页查找账户 Find Contacts find-contacts 按查询分页查找联系人 Find Tasks find-tasks 按查询分页查找任务 Find Activities find-activities 按查询分页查找活动 Get Lead get-lead 按 ID 获取单个线索 Get Account get-account 按 ID 获取单个账户 Get Contact get-contact 按 ID 获取单个联系人 Get Task get-task 按 ID 获取单个任务 Get Activity get-activity 按 ID 获取单个活动 Create Lead create-lead 在 Nutshell CRM 创建新线索 Create Account create-account 在 Nutshell CRM 创建新账户 Create Contact create-contact 在 Nutshell CRM 创建新联系人 Create Task create-task 在 Nutshell CRM 创建新任务 Create Activity create-activity 在 Nutshell CRM 创建新活动（会议、电话等） Update Lead update-lead 更新现有线索 Update Account update-account 更新现有账户