摘要
RO App(前身为 RemOnline)维修店和服务 CRM,公共 API v2:带有状态和评论的订单、客户、询盘(潜在客户)、产品和仓库、发票、财务账户及其交易、任务和员工。API 密钥。
引导式设置
2 分钟将 RO App 连接到 Gemini
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 RO App,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
RO App 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → RO App,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
RO App + Gemini
RO App(前身为 RemOnline)维修店和服务 CRM,公共 API v2:带有状态和评论的订单、客户、询盘(潜在客户)、产品和仓库、发票、财务账户及其交易、任务和员工。API 密钥。
前提条件
查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
RO_APP_API_KEY
第一步 — 获取凭据
设置大约需要 2 分钟。
- 在 RO App 中打开 设置,API(https://web.roapp.io/settings/api)。
- 将 API 密钥复制到
RO_APP_API_KEY。它与您的用户配置文件相关联,可以在同一页面上重新生成。
密钥以 Authorization: Bearer 的形式发送。API v2 中没有令牌交换。错误的密钥会返回 403,并显示消息无效令牌。
从哪里开始:ro_app_get_company 检查密钥。ro_app_list_orders 列出维修订单;根据 ro_app_list_order_statuses 中的状态 ID 进行过滤。ro_app_get_order 和 ro_app_list_order_items 显示一个订单及其零件和服务。
订单:ro_app_list_orders、ro_app_get_order、ro_app_list_order_items、ro_app_create_order、ro_app_update_order、ro_app_update_order_status、ro_app_add_order_comment,以及参考列表 ro_app_list_order_statuses 和 ro_app_list_order_types。新订单需要一个位置(ro_app_list_locations)、一个订单类型和一个客户。
客户:客户可以是个人或组织。个人:ro_app_list_people、ro_app_get_person、ro_app_create_person。组织:ro_app_list_organizations、ro_app_get_organization、ro_app_create_organization。
潜在客户:RO App 称之为询盘。ro_app_list_inquiries、ro_app_get_inquiry、ro_app_create_inquiry、ro_app_update_inquiry_status,以及 ro_app_list_inquiry_statuses 和 ro_app_list_inquiry_types。
库存:ro_app_list_products 和 ro_app_get_product 读取产品目录,ro_app_list_warehouses 列出仓库。API v2 文档没有针对每个仓库的库存数量的调用,因此这里没有库存水平。
发票和付款(只读):ro_app_list_invoices、ro_app_get_invoice、ro_app_list_invoice_items;ro_app_list_finance_accounts 和 ro_app_list_account_transactions 显示现金箱、银行账户及其上记录的付款。连接器不创建付款、转账或退款。
任务和员工:ro_app_list_tasks、ro_app_get_task、ro_app_create_task;ro_app_list_employees 提供用于经理和受托人的员工 ID。
分页和过滤器:列表每页返回最多 50 行,带有 count(总数);使用 page 请求下一页。大多数过滤器接受 ID 列表。日期过滤器接受一个或两个 ISO 8601 日期时间:一个是开始,两个是范围。
限制:每秒 3 个请求;更多请求返回 429。此连接器不会删除任何内容。
第二步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第三步 — 在 Gemini 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp(或在终端运行gemini mcp list)—anythingmcp应显示为已连接。 - 开始输入提示 — Gemini CLI 现在可以调用
RO App的工具。
可用工具
| 工具 | 功能 |
|---|---|
ro_app_get_company | 读取 RO App 关于 API 密钥背后的公司账户的信息。用于检查密钥是否有效。只读 |
ro_app_list_locations | 列出公司的位置(分支、车间):ID、名称、地址及是否已归档。ID 是订单的 branch_id… |
ro_app_list_employees | 列出公司的员工:ID、姓名、电子邮件、电话、职位和组。ID 是经理、受托人和任务作者所引用的… |
ro_app_list_orders | 列出维修和服务订单:ID、文档编号、状态、类型、位置、客户、资产、经理和受托人、问题描述… |
ro_app_get_order | 读取一个订单及其所有详细信息:状态、类型、客户和付款人、资产、经理和受托人、问题描述、备注、结论… |
ro_app_list_order_items | 列出订单上的产品和服务:每个项目的名称、数量、价格、成本、折扣、税和保修。只读 |
ro_app_create_order | 为客户在某个位置创建维修或服务订单。首先获取 ID:ro_app_list_locations(branch_id)… |
ro_app_update_order | 更新订单:客户、资产、经理、受托人、日程、到期日期、问题描述、备注或自定义字段。仅更新给定的字段… |
ro_app_update_order_status | 将订单移动到另一个状态,并可附加评论。根据账户的状态规则,这可以通知客户或关闭… |
ro_app_add_order_comment | 向订单的事件记录添加评论。私人评论仅对员工可见 |
ro_app_list_order_statuses | 列出订单可以拥有的每个状态:ID、名称、颜色和组(新、进行中、已完成、关闭等)。只读 |
ro_app_list_order_types | 列出账户的订单类型(例如维修、销售、维护)及其 ID。订单需要一个。只读 |
ro_app_list_people | 列出作为个人的客户:ID、名字和姓氏、电子邮件、电话、地址、标签、经理、折扣及是否为供应商。返回的… |
ro_app_get_person | 读取一个个人:姓名、生日、电子邮件、电话、地址、标签、经理、折扣码、税号和自定义字段。只读 |
ro_app_create_person | 创建一个作为个人的客户,包含名字和可选的姓氏、电子邮件、电话、地址和标签。返回该个人及其… |
ro_app_list_organizations | 列出作为组织(公司)的客户:ID、名称、电子邮件、电话、地址、标签、经理及是否为供应商。返回的行… |
ro_app_get_organization | 读取一个组织:名称、电子邮件、电话、地址、标签、经理、税号和注册号及自定义字段。只读 |
ro_app_create_organization | 创建一个作为组织(公司)的客户,包含名称和可选的电子邮件、电话、地址、税号和标签。返回的… |
ro_app_list_inquiries | 列出询盘(潜在客户):ID、文档编号、状态、类型、位置、联系人姓名和电话、客户、经理、评论、到期日期和创建… |
ro_app_get_inquiry | 读取一个询盘(潜在客户):状态、类型、联系人姓名、电话和电子邮件、客户、经理、评论、备注、地址、到期日期和自定义字段… |
ro_app_create_inquiry | 创建一个给定类型的询盘(潜在客户),包含联系人姓名和电话或现有客户、评论和可选的到期日期… |
ro_app_update_inquiry_status | 将询盘(潜在客户)移动到另一个状态,并可附加评论,例如标记为已赢或已输 |
ro_app_list_inquiry_statuses | 列出询盘(潜在客户)可以拥有的每个状态,包含 ID、名称和组。只读,无参数 |
ro_app_list_inquiry_types | 列出账户的询盘(潜在客户)类型及其 ID。询盘需要一个。只读,无参数 |
ro_app_list_products | 列出目录中的产品(零件和商品):ID、标题、SKU、内部代码、条形码、制造商零件编号、类别、计量单位… |
ro_app_get_product | 读取目录中的一个产品:标题、SKU、代码、条形码、类别、计量单位、保修、价格和自定义字段。只读 |
ro_app_list_warehouses | 列出仓库:ID、名称、类型及其所属位置。只读 |
ro_app_list_invoices | 列出发票:ID、文档编号、状态、客户和付款人、法人、付款方式、总额、发票日期和到期日期,以及订单… |
ro_app_get_invoice | 读取一张发票:编号、状态、客户和付款人、法人、付款方式、总额(含税和折扣)、发票和到期日期及… |
ro_app_list_invoice_items | 列出发票上的产品和服务:每个项目的名称、数量、价格、折扣和税。只读 |
ro_app_list_finance_accounts | 列出公司的财务账户(现金箱和银行账户),及其 ID、标题和付款方式类型。只读;此… |
ro_app_list_account_transactions | 列出在一个财务账户上记录的付款:方向(收入或支出)、金额、现金流类别、描述、处理该付款的员工… |
ro_app_list_tasks | 列出任务:ID、标题、描述、优先级、状态、到期日期、作者、受托人及其关联对象。返回的行… |
ro_app_get_task | 读取一个任务:标题、描述、优先级、状态、到期日期、作者、受托人、关联对象及其评论。只读 |
ro_app_create_task | 创建一个任务,包含标题和到期日期,可选地包含描述、优先级、受托人和与订单、询盘、发票的链接… |
示例提示
- "哪些维修订单仍在等待零件,哪个技术员负责?"
- "显示订单 10482 及其零件、服务和评论。"
- "为 Anna Petrova 创建一个潜在客户,iPhone 14 屏幕更换,来自网站。"
- "将订单 10482 移动到准备取件,并添加评论:客户来电,将于周五到。"
- "上个月哪些发票仍未支付?"
常见问题
API 密钥来自哪里? 在 RO App 中打开设置,API 并将 API 密钥复制到 RO_APP_API_KEY。它属于你的用户配置文件,并可以在同一页面上重新生成。RO App 以前称为 RemOnline。
它涵盖了什么? 带有状态、项目和评论的维修订单,作为个人和组织的客户,询盘(潜在客户)、产品和仓库、发票、财务账户及其交易、任务和员工。发票和付款为只读,连接器不创建付款、转账或退款。每个仓库的库存水平不可用,因为 API v2 文档没有对此的调用。
是否有任何安装被关闭? 没有。每个工具都是开启的,且此连接器不会删除任何内容;写入操作会创建或更新订单、客户、潜在客户和任务,因此 AI 会向你展示每一个并等待确认。
Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?