📦 SugarCRM
v1.0.5SugarCRM 集成。管理 CRM 与销售数据、记录及工作流。用于用户需要与 SugarCRM 数据交互时。
详细分析 ▾
运行时依赖
安装命令
点击复制技能文档
SugarCRM SugarCRM 是一个客户关系管理(CRM)平台,帮助销售、营销和客服团队在整个客户生命周期中管理客户互动与数据。各种规模的企业用它提升销售绩效、营销效果和客户满意度。 官方文档:https://support.sugarcrm.com/Documentation/
SugarCRM 概览 Account Contact Lead Opportunity Task Meeting Call Note
使用 SugarCRM 本技能通过 Membrane CLI 与 SugarCRM 交互。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。
连接 SugarCRM
使用 membrane connection ensure 通过应用 URL 或域名查找或创建连接:
membrane connection ensure "https://www.sugarcrm.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 地址,可展示给用户。
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。
常用动作
Name | Key | Description
Filter Related Records | filter-related-records | 通过指定关系获取父记录的相关记录
Create Task | create-task | 在 SugarCRM 创建新任务
Add Note to Record | add-note-to-record | 给任意记录(Account、Contact、Lead、Opportunity 等)添加备注
Bulk API Request | bulk-api-request | 单次调用执行多个 API 请求,减少往返
List Modules | list-modules | 获取 SugarCRM 所有可用模块列表
Get Module Metadata | get-module-metadata | 获取指定模块的元数据(字段、关系等)
Get Current User | get-current-user | 获取当前认证用户信息
Unlink Records | unlink-records | 移除记录与相关记录的关系
Link Records | link-records | 创建记录与一个或多个相关记录的关系
Get Related Records | get-related-records | 通过指定关系获取父记录的相关记录
Search Records | search-records | 用简单查询字符串在模块字段中搜索记录
Delete Record | delete-record | 从任意模块软删除记录
Update Record | update-record | 更新任意模块的现有记录
Create Record | create-record | 在任意模块创建新记录
Get Record | get-record | 获取任意模块的单条记录