MCP 能力速查
了解 AI 如何发现能力、读取完整约定,并记录真实交付。
本页内容
本页帮助你理解 AI 的调用顺序。通常只需用自然语言表达需求;工具的当前参数应从已连接服务中发现和读取。
发现、描述、调用
discover_capabilities:按业务需求查找能力。describe_capability:读取选中能力的当前说明和参数。invoke_capability:使用已核对的参数执行业务操作。
专项能力按需发现。不要根据历史文档臆造参数,或把准备上传、准备后台任务当成操作已经完成。
查工作与完整约定
my_collaboration- 读取个人可见的工作和项目概览。
get_work_context- 读取任务约定、来源、文件版本和执行基线。需要全文时使用返回的全文入口或完整详情模式。
begin_work- 在本项目 Session 中确认最新执行基线,再开始实际工作。
deliver_work- 提交真实产出与验收证据,沿用有效执行基线。
会话与更新
enter_collaboration_mode- 创建或复用绑定项目的会话,检查版本并准备协作流程。
list_agent_instances- 按具体 Session 核对项目、任务、状态与心跳。
prepare_background_task- 准备 wait/watch 脚本;仍需宿主实际执行才能在线。
check_mcp_update/update_mcp- 检查和刷新本会话的远程约定;兼容刷新保留现有工作。
close_collaboration_session- 关闭指定会话;宿主同时停止自己的后台任务。
文件传输
prepare_file_upload 和 prepare_file_download 返回限时传输方式。AI 需要实际发送或接收文件字节,核对服务返回结果后再关联交付。准备地址并不代表文件已经传完。
区分三种标识
- 个人令牌
- 认证你是谁,决定可访问的业务范围。
- FDE Session ID
- 标识工作台中的一个项目会话,用于开始、监听和交付工作。
- 宿主会话 / 后台终端编号
- 由当前 AI 工具管理,用于定位原会话和自己的后台进程,不能代替 FDE Session ID。