03 · 业务工具
AI SaaS 的 MCP 接入方式
Finance ERP 通过标准 MCP JSON-RPC 暴露经过授权的业务能力。推荐的公开路径使用已登录 ERP 用户 Token，由服务端恢复租户、用户、门店、角色与权限边界，而不是信任客户端自报的身份头。
连接信息
- 端点
- https://fin.eelml.com/api/mcp
- 协议
- 基于 HTTP JSON-RPC 的 MCP 2025-03-26
- 身份认证
- Authorization: Bearer <ERP_USER_TOKEN>
- 支持方法
- initialize、ping、tools/list、tools/call
1 · 登录 AI SaaS 工作区
通过 Finance ERP 登录流程获得用户 JWT。账户必须属于有效租户。
2 · 初始化 MCP
发送 JSON-RPC initialize 请求，然后发送 notifications/initialized。
3 · 发现业务能力
调用 tools/list。返回的工具 Schema、标题、描述与 annotations 是当前能力合同。
4 · 调用一项已授权工具
使用 tools/call 传入工具名与符合 Schema 的参数，并同时读取结果中的 content 与 structuredContent。
接口范围
- POST
- /api/mcp
- JSON-RPC
- initialize
- JSON-RPC
- tools/list
- JSON-RPC
- tools/call
列出可用 SaaS 工具
curl https://fin.eelml.com/api/mcp \ -H "Authorization: Bearer $ERP_USER_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} }'
安全与产品边界
- 不要发送 X-Agent-Tenant-Id、X-Agent-User-Id、角色、权限或门店身份头；这些值由经过认证的服务端会话提供。
- 服务 Token 使用的 /mcp 与 /api/v1/mcp 是托管机器接口，不属于公开自助凭证。
- MCP 传输不会绕过业务审批、租户隔离、门店范围或能力级授权。