选择连接方式
应用目录列出的是实现范围,不表示所有账户、操作和真实模型组合都已验收。查看应用连接器资料中的验证范围。
配置一个只读工具
在 Console 的 Tools 中添加连接,选择目标账户与操作,完成授权、验证并启用。首次集成选择一个能明确核对结果的只读操作,例如读取专用测试文档。 Remote MCP 先发现工具,再审查名称、描述和 schema,选择允许操作。工具默认要求审批,包括自称 read-only 的工具;只有明确审查后才调整策略。服务器的说明是外部数据,不能直接作为授予权限的依据。 目前 MCP 支持 Streamable HTTP 和 legacy SSE;没有通用 stdio、资源 / prompts 订阅、sampling 或 elicitation 支持。任意 MCP 服务的 OAuth 浏览器注册和自动刷新也不在该接口范围,见Remote MCP。创建带绑定的 Session
以下片段接续已初始化客户端和已验证的连接 ID。所选 Harness 必须支持 Tools。research 解释工具用途。连接 ID 指向账户配置,绑定名是 Session 中的使用名称。默认工具在初始化时为必需;确实允许缺失授权时可把该别名加入 optional_tools: ['research']。可选不等于获得授权或跳过审批,任务遇到权限缺口仍需处理。
必需与可选绑定的就绪规则
可选表示允许延后就绪检查,不表示可以绑定不存在、属于其他租户或类型错误的连接。
创建资源前,可以用 Session 预检比较目标定义。直接定义的 Python
client.preflight_session(..., tools={'research': tool_connection_id}) 和 TypeScript client.preflightSession({...definition, tools: {research: toolConnectionId}}) 使用与创建相同的初始化检查;这里只展示 API 形态,Sandbox、模型与 Harness 字段须由完整定义提供。只有任务确实允许在该连接尚未就绪时开始,才添加 optional_tools。预检成功不代表后续操作已经获批,也不预留外部服务未来的可用性。
完整契约见初始化。必需或可选就绪、允许操作集合、单次调用审批是三个分别生效的控制。
从有记录的只读调用开始
一个具体记录是通过 DeepWiki Remote MCP 的read_wiki_structure 读取 modelcontextprotocol/typescript-sdk。11 月 18 日记录包含发现、仅选择这一操作、对已审阅的读取显式关闭审批,以及分别通过 Vercel 上 TypeScript/Pi、Python/OpenCode 与已配置 SiliconFlow 模型的实际调用。两者均返回仓库主题并确认清理。这份记录不证明所有 MCP 服务、上游当前可用性或任意 OAuth 接入。
在自己的服务上重复该流程时,按 Remote MCP 配置检查发现结果,只选择目标操作。除非审阅过该操作并有意调整策略,否则保留审批。绑定返回的连接 ID,提交一个明确读取任务,再检查 Tool call 的实际参数与结果内容,不能仅凭助手措辞推断调用发生。写入任务继续阅读审批示例,并单独核对外部结果;只读记录不证明写入安全。
跟踪一次操作的完整流程
使用专用测试记录,分开执行读取和写入任务。先要求research 读取已知记录,将实际返回内容与预期核对;再请求一次小规模、可撤销且需要审批的更新。应用记录 Session ID、Run ID、Tool call ID,以及存在时的 approval ID,它们分别标识不同对象。
Tool 别名不是凭据,不授予额外操作。Session 已固定的允许操作与连接当前策略都会影响执行。连接更换账户身份可能返回
tool_account_changed;在连接当前配置新增操作,不会自动向既有 Session 授予该操作。相关 MCP schema 变化可能返回 mcp_schema_changed。目标绑定需要变化时,先审查新配置,再创建新 Session。