首批开放接口上线,MCP 端点可用
首批 255 个开放接口完成登记并启用,MCP 端点与四个元工具同步可用,
字段级接口参考已上线。开发环境(open-dev.risemap.cn)即可接入,生产环境待发布。
开放接口
| 业务域 | 接口数 | 所需范围 |
|---|---|---|
| 销售(sales) | 162 | sales:read / sales:write |
| 采购与供应链(srm) | 78 | srm:read / srm:write |
| 审批流(workflow) | 15 | workflow: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);能看到多少数据也与该员工在主站看到的一致。
详见认证与授权。