clientSideMCPServerIds 字段。工具在应用本地会话和状态中执行。工具范围应尽量精简,每次执行操作时仍要重新检查用户权限。按会话注册有助于限定工具范围,但不能替代应用自身的权限校验。
由于工具在客户端执行,每个浏览器标签页或应用窗口都有独立的服务实例;只有客户端会话仍能处理请求时,工具才可用。需要考虑浏览器标签关闭、连接中断或用户会话过期的情况,并在工具无法完成时返回清楚的错误信息。客户端 MCP 工具默认按低风险处理,用户可以选择记住审批决定;应用仍应在每次操作时自行校验权限。
注册和处理客户端服务
MCP 注册需要当前登录用户的 OAuth access token;这些路由不支持 API key。默认baseUrl 为 https://app.counso.ai;如应用使用其他 Counso 环境,请替换为相应基础地址。
注册范围绑定当前用户和工作区。若不续期,注册会在五分钟后过期;心跳间隔不能超过五分钟,并应使用
expiresAt 跟踪注册状态。在 requests 事件流中收到工具请求后,将其交给 MCP server transport 处理,再由 transport 通过 results 端点提交执行结果。客户端关闭时注销服务。
SDK transport 可以代为处理注册和消息传递。自行实现其他 transport 时,应保持每个客户端独立:以已登录用户注册,通过 Server-Sent Events 接收请求,将事件交给 MCP transport 处理,再提交执行结果。端点结构见Counso API 参考。