MCP 服务器
通过 Model Context Protocol 将 AI 客户端连接到工作区,使用该人员本人的权限。
POST https://<workspace>.zmle.com/api/mcp
端点
POST https://<workspace>.zmle.com/api/mcp:Streamable HTTP、JSON-RPC 2.0,协议版本 2025-11-25, 2025-06-18, 2025-03-26。服务器无状态,在工作区开启之前处于关闭状态。
带 PKCE 和动态客户端注册的 OAuth 2.1,通过 /.well-known/oauth-protected-resource 发现。每个连接以一个人的身份运行,具有该人的权限和分支。权限范围 mcp:read 用于读取;mcp:write 只能创建草稿。
读取工具
sales_summarybusiness_metriclist_recordsreceivablespayablesprofit_and_losscash_positiontax_summarystock_statusemployee_summarypayroll_summaryteam_todaytill_sessionspurchases_summarycustomer_summarystays_summaryrentals_summaryforecastsearch_recordsget_record草稿工具(需要写入权限范围和工作区许可)
create_draft_quotationcreate_draft_invoicecreate_task限制:每个连接每分钟 60 次调用,每个工作区每小时 3000 次,每小时 30 个草稿,每个请求 64 KB。
连接客户端
- 管理员在 管理 → 集成与 API → AI 连接(MCP)中开启 AI 连接
- 在您的 AI 客户端中添加自定义 MCP 连接器,地址为 https://<workspace>.zmle.com/api/mcp
- 客户端会打开此工作区的登录页:登录并允许连接
- 不支持 OAuth 的客户端可以使用在同一页面创建的个人令牌,以 Bearer 标头发送
结束连接
在 AI 连接页面,“结束连接”会立即停止客户端。关闭 AI 连接会立即拒绝所有调用。
下一步: API 密钥与权限范围
密钥可以读取和写入哪些数据,以及它从创建者那里继承的分支和权限限制。