用途:该技能覆盖 Agently 的 MCP 集成路径,用于注册外部 MCP 服务器工具,使其可被 Agently 智能体调用。重点在传输注册、schema 映射、智能体作用域和结果行为,不替代通用 tool-loop 技能或 TriggerFlow 工作流设计。前置条件为 Agently >= 4.0.8.5。
主要能力:支持 agent.use_mcp(...)、agent.async_use_mcp(...)、Agently.tool.use_mcp(...);支持 stdio 或 HTTP MCP 传输;可将 MCP 工具 schema 映射为 Agently 工具元数据;支持按智能体限定 MCP 工具可见性;可解释 MCP 结果与错误。
使用方式:主要问题是“如何挂载 MCP 服务器”时,先看 references/transports-and-registration.md;涉及工具签名、返回值或 MCP 校验错误时看 references/schema-and-results.md;涉及哪个智能体可看到哪些 MCP 工具时看 references/agent-use-and-tagging.md。若问题演变为通用 tool-loop 设计或内置工具选择,应改用 agently-tools;行为仍异常时看 references/troubleshooting.md。
核心模型:MCP 在 Agently 中是一条工具注册通路——从 MCP 服务器发现工具,将其 schema 转换为 Agently 工具元数据,注册后与其他工具一样参与同一工具系统。因此 MCP 回答的是工具来源、注册方式与 schema 映射;正常工具循环仍属 agently-tools。
选择规则:需要外部 MCP 服务器提供工具时用 use_mcp(...);工具仅对一个智能体可见时用 agent.use_mcp(...);需先全局注册时用 Agently.tool.use_mcp(...);本地 Python 函数即可满足时用 agently-tools。
限制与边界:MCP 注册不是独立的规划循环,实际执行仍由正常 Agently 工具循环完成;服务器返回结构化内容时 Agently 优先直接使用该结构化内容;返回文本时先尝试 JSON 解析,失败则回退为原始文本。