摘要
RO App(前身为 RemOnline)维修店和服务 CRM,公共 API v2:带有状态和评论的订单、客户、询盘(潜在客户)、产品和仓库、发票、财务账户及其交易、任务和员工。API 密钥。
引导式设置
2 分钟将 RO App 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 RO App,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
RO App 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → RO App,粘贴你的凭证,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
RO App
RO App(前身为 RemOnline)维修店和服务 CRM,公共 API v2:带有状态和评论的订单、客户、询盘(潜在客户)、产品和仓库、发票、财务账户及其交易、任务和员工。API 密钥。
设置
设置大约需要 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 列出维修订单;按状态 ID 从 ro_app_list_order_statuses 进行过滤。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。此连接器不会删除任何内容。
先决条件:RO_APP_API_KEY
本地安装连接器
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
打开 http://localhost:3000/connectors/store,选择 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 移动到准备取件,并添加评论:客户已致电,将于周五来。"
- "上个月哪些发票仍未支付?"
下一步
这份指南对你有帮助吗?