这件事在什么时候变成问题
当企业需要将现有外部服务接入大模型调用链路，或需要将FastGPT构建的AI应用以标准化MCP协议对外提供服务时，原有的工具调用或应用发布方式可能无法满足跨平台统一通信的需求。当团队需要对接多厂商支持MCP协议的客户端，或需要实现跨团队的工具调用权限隔离时，MCP的接入与发布配置就成为需要明确决策的问题。 从v4.9.6版本起，FastGPT开始支持MCP相关功能，当团队使用该版本及以上的FastGPT，且存在外部服务对接、应用对外暴露的需求时，需要系统梳理MCP的两种使用方向的配置逻辑与约束条件。此外，当私有化部署的FastGPT需要兼容SSE协议的MCP服务，或需要通过身份代理实现细粒度的权限控制时，现有配置的缺失或不明确会导致部署失败或权限风险，此时需针对MCP的两个方向开展针对性的决策与配置。
需要先定下来的判据
| 判据 | 取什么值 | 依据 |
|---|---|---|
| 是否需要将外部服务接入FastGPT作为工具集 | 取“是”则配置MCP工具集，取“否”则聚焦MCP server发布 | 官方文档 guide/build/tools/mcp_tools |
| 对外提供哪种传输地址 | 默认提供 Streamable HTTP；私有化部署需要兼容 SSE 时，另起独立的 fastgpt-mcp-server 服务并配置 SSEMCPSERVERPROXYENDPOINT | 官方文档 MCP 发布、环境变量说明 |
| 是否需要跨团队成员的权限隔离 | 取“是”则开启身份代理并配置请求头；取“否”则使用MCP server发布者的默认身份 | 官方文档 guide/build/publish/mcp_server 身份代理章节 |
| 客户端是否支持SSE协议 | 取“是”则可使用SSE传输；取“否”则优先使用Streamable HTTP协议 | 官方文档 guide/build/publish/mcp_server |
| 私有化版本是否满足 | v4.9.6 及以上才能使用 MCP server 功能 | 官方文档 MCP 发布 · 私有化部署 |
| 是否需要动态调整工具调用的执行身份 | 取“是”则必须使用身份代理机制；取“否”则无需额外配置身份相关参数 | 官方文档 guide/build/publish/mcp_server 身份代理前提条件 |
判据的取舍需结合企业的实际业务场景与部署环境。两种MCP使用方向的判据相互独立，企业可同时存在接入外部工具集和发布FastGPT应用为MCP server的需求。云服务版直接使用 Streamable HTTP 地址，客户端能否接入以它是否支持该协议为准。当需要SSE协议支持时，需优先确认客户端的兼容性，再配置对应的环境变量。身份代理的开启需要团队所有者权限，且需确保被代理成员的团队身份与应用权限有效，否则会导致工具调用失败。外部 MCP 服务的连接方式以文档为准：MCP 工具集文档按 SSE URL 创建工具集；v4.15.7 更新说明提到 Streamable HTTP 连接失败时会回退到 SSE，并修复了回退时请求头重复发送的问题。具体某个服务端支持哪种传输，需按实际环境确认。
具体怎么做
外部MCP服务接入为工具集
登录FastGPT工作台，进入应用创建页面，选择新建MCP工具集。获取外部MCP服务的访问地址，填入配置弹窗的对应位置。点击解析按钮，系统会自动拉取并解析MCP服务的工具列表。确认工具列表无误后，点击创建完成工具集的搭建。进入工具集内部，可对单个工具进行调试，验证工具的可用性。工具集创建后有两种用法：只选中其中几个工具交给模型；或添加整个工具集节点、再用工具调用节点连接，由模型自动选取需要的工具。v4.17.0 起，工作流在运行时读取 MCP 工具定义，修复了工具定义随工作流快照过期的问题。
发布FastGPT应用为MCP server
登录FastGPT工作台，点击MCP server进入管理页面。点击创建MCP server，填写自定义名称，选择需要关联的FastGPT应用，可选择多个应用。保存后，点击开始使用，获取MCP server的访问地址与接入脚本。在支持MCP协议的客户端中，导入获取到的JSON配置文件，启用该MCP server。以 Cursor 为例，需要把对话切到 Agent 模式，Cursor 才会调用 MCP server。
传输协议与私有化部署配置
两种传输地址的来源不同：Streamable HTTP 地址由 FastGPT 直接提供；SSE 地址只在私有化部署额外起独立的 MCP Server 服务后才有。私有化部署的配置步骤包括：修改docker-compose.yml，添加fastgpt-mcp-server服务，配置FASTGPTENDPOINT为FastGPT的内部访问地址；在FastGPT容器的环境变量中添加SSEMCPSERVERPROXY_ENDPOINT，值为客户端可访问的fastgpt-mcp-server地址，末尾不携带/；重启FastGPT与fastgpt-mcp-server服务，使配置生效。
身份代理配置
身份代理功能需满足特定前提条件，仅团队所有者可开启该功能，被代理用户必须是当前团队内未离开的成员，且拥有目标应用的读取权限。配置步骤包括：编辑已创建的MCP server，在发布配置中开启身份代理，保存配置；在MCP客户端的配置中，添加对应的请求头，可选x-fastgpt-auth-proxy-username（团队成员登录用户名，通常为邮箱）或x-fastgpt-auth-proxy-tmb-id（FastGPT团队成员ID），二者任选其一，同时提供时需指向同一成员；对于SSE地址，修改请求头后需断开并重新连接，Streamable HTTP会逐次读取请求头；验证配置，通过客户端调用工具，确认工具执行成功且权限符合预期。未携带身份代理请求头时，工具以MCP server发布者的身份执行。
怎么验收
- 外部MCP工具集接入验收：在FastGPT的MCP工具集页面点击解析，成功拉取并展示工具列表；在工具调试页面运行单个工具，返回预期的业务结果。
- MCP server发布验收：在工作台MCP server管理页面，可查看已创建的server与关联应用数量；在支持MCP的客户端导入接入脚本，成功展示关联应用对应的工具列表。
- 传输协议验收：使用Streamable HTTP地址调用工具，返回正常结果；私有化部署环境下，使用SSE地址连接，客户端能正常列出并调用工具。
- 身份代理验收：配置身份代理请求头后，调用工具时以指定成员的身份执行，对话记录与运行记录归属该成员；未携带请求头时，工具以发布者身份执行。
- 权限校验验收：使用无目标应用读取权限的成员身份调用工具，返回权限不足的提示；使用合法成员身份调用时，工具正常执行并返回结果。
- 私有化部署验收：确认fastgpt-mcp-server服务正常运行，FastGPT容器的SSEMCPSERVERPROXYENDPOINT配置正确，客户端可正常连接SSE地址的MCP server。
边界：什么情况下这套做法不成立
当FastGPT版本低于v4.9.6时，无法支持MCP工具集与MCP server功能，需先完成版本升级。v4.17.1 修复了 MCP 的 DNS rebinding 导致的 SSRF 风险，并收紧了解析地址族校验；升级后若原先可用的外部 MCP 地址无法解析，需按实际环境确认它解析到的地址。当客户端不支持MCP协议的请求头配置时，身份代理功能无法生效，无法实现细粒度的权限控制。社区里常见的一类提问是外部 MCP 服务在别的客户端能连上、在工具集里解析失败；这类情况与服务端实现的传输方式有关，文档没有给出统一结论，需按实际环境确认。当被代理的团队成员已离开团队，或被移除了目标应用的读取权限时，工具调用会返回权限错误，需定期清理无效的代理成员配置。此外，当企业的网络环境存在严格的出站限制，无法访问外部MCP服务或fastgpt-mcp-server的部署地址时，MCP的接入与发布会失败，需配置网络代理或调整防火墙规则。
继续阅读
参考资料
需要进一步确认时
上述判据与验收项可依据公开文档逐条核对。若需要结合具体部署环境与运维条件落地这套流程，可通过商务咨询获取支持；云服务形态可直接开始使用。
- 商务咨询：结合部署环境落地这套流程
- 立即开始：先用云服务验证流程可行性
- 定价：对比不同形态的适用范围