Technical Guide

27. 接 MCP / 外部服务

把一个只读外部服务接进研究型 Agent:先验证 server,再接入配置,最后放入报告流程。

先接只读服务

MCP 很适合扩展 Agent 能力。

但终局实战第一版,建议只接只读服务。

例如:

内部文档查询
只读数据库查询
项目资料索引

不要一开始接写操作。

接入前先验证

先在 DeerFlow 外部验证 MCP server:

能启动
工具列表正确
调用一个工具能返回结果
错误信息清楚

这一步能省很多排错时间。

接入配置

配置以官方 config.example.yaml 为准。

重点看:

server 名称
transport
command / args
env
认证方式

不要把密钥写进文档或仓库。

放进任务流

MCP 不应该替代所有搜索。

更稳的方式是:

公开搜索找背景
MCP 查询内部或特定资料
最终报告区分不同来源

这一篇你要记住

MCP 接入的价值是让 Agent 能访问外部系统。

但权限越大,风险越大。先只读,再扩展。

什么时候值得接 MCP

不是所有外部能力都要 MCP。

如果只是一次性脚本,用普通工具可能更简单。

MCP 更适合这些情况:

多个 Agent 都要用
工具需要独立部署
外部系统本来就有 MCP server
需要统一协议管理工具

接入后怎么降级

MCP server 可能不可用。

研究型 Agent 应该有降级路径:

MCP 可用:使用外部资料
MCP 不可用:只用公开搜索,并在报告里说明限制

这样任务不会因为一个外部服务挂掉就完全失败。

安全提醒

只读不等于无风险。

内部资料被读取后也可能进入报告,所以要确认哪些内容可以被输出。