跳到主要内容

首批开放接口上线,MCP 端点可用

Avery
Risemap 开放平台

首批 255 个开放接口完成登记并启用,MCP 端点与四个元工具同步可用, 字段级接口参考已上线。开发环境(open-dev.risemap.cn)即可接入,生产环境待发布。

开放接口​

业务域接口数所需范围
销售(sales)162sales:read / sales:write
采购与供应链(srm)78srm:read / srm:write
审批流(workflow)15workflow:read / workflow:write

全部经统一直通入口 POST /v1/api/invoke 按 apiCode 调用,不做路径镜像。 完整清单见开放接口清单,逐接口的请求/响应字段表见 接口参考。

财务、项目、办公等业务域尚未开放,按批次评估中。

MCP 端点​

端点 https://open.risemap.cn/v1/mcp(开发环境 open-dev.risemap.cn), Streamable HTTP 无状态实现,协议版本 2025-06-18 / 2025-03-26。

只暴露 4 个元工具 —— list_domains、search_apis、describe_api、call_api —— 由 agent 按需检索具体接口,客户端上下文占用与接口总量解耦。接入只需填一个地址, 浏览器完成 OAuth 授权,无需接触密钥,详见客户端接入。

经 MCP 调用高危接口(删除、作废、审批等)须携 confirm: true,agent 应先向用户 复述将要执行的内容并获得明确同意。

⚠️ 审批流域需重新授权​

workflow 域是本批新增的范围词汇。在此之前完成授权的凭证不包含该域 —— 需要访问审批任务、流程实例与审批历史的调用方,请重新走一次授权流程并勾选 workflow:read / workflow:write,已有的令牌不会自动获得该范围。

AppKey 的授权范围在创建时固定、之后不可修改:需要该域的集成方请新建一个 勾选了 workflow 范围的 AppKey,切换完成后再吊销旧的,以免中断调用。

权限口径提醒​

开放平台的凭证绑定员工身份:能做的事等于「凭证授权范围 ∩ 绑定员工本人权限」。 凭证即便勾了 sales:write,绑定员工在主站没有相应销售模块的操作权限,调用仍会被拒 (92204);能看到多少数据也与该员工在主站看到的一致。 详见认证与授权。