MCP 服务器与工作流工具

MCP 服务器将 Ai Flowi 的 AI Flowi Workflow 与客户端及外部工具连接起来。项目中的 MCP Server 将选定的工作流公开为可调用的工具。MCP Servers 设置保存供工作流使用的外部连接，而 MCP Client 提供编程智能体配置。项目中 MCP Server 的 JSON 视图提供 2 种传输方式：SSE 或 Streamable HTTP。外部 MCP 连接还支持 STDIO。

发布于 2026年10月8日 · 更新于 2026年10月9日

作者：Ai Flowi · 技术审核： Janice Lee，技术支持，Ai Flowi。

产品：Ai Flowi 的 AI Flowi Workflow · 任务：连接客户端与工作流工具 · 组件：MCP Tools，用于调用外部服务器工具

适用场景

使用 MCP Server，让 MCP 客户端能够调用选定的项目工作流。

使用 MCP Servers 和 MCP Tools，将外部服务器的工具接入工作流。

使用 MCP Client 复制编程智能体的配置，让这些智能体在你的 AI Flowi Workflow 实例上构建并运行工作流。

开始前的准备

选择要公开的项目和工作流，或获取外部服务器的连接配置。
使用正常的账户会话：在支持会话中，MCP 设置会被隐藏。
请将 API 密钥保存在私有客户端配置中；文档中使用 YOUR_API_KEY 作为占位符。
只有启用 MCP composer 设置时，才会显示项目认证控件。

操作步骤

1. MCP Server · 工作流/工具

打开项目的 MCP Server 视图，在“工作流/工具”下选择“编辑工具”。

审阅工具名称和描述，然后仅启用供此客户端使用的工作流。

保存的工具设置包含每个工作流的名称、描述及启用状态。

2. 认证 · 添加认证 / 编辑认证

显示“认证”时，选择“添加认证”或“编辑认证”，并审阅认证方式。

认证方式的标签为“无”、“API 密钥”和 OAuth；认证摘要将未启用认证的项目标记为“无（公开）”。

当 composer 设置被禁用时，保存工具选择会使用“无”认证设置，而生成的客户端请求头取决于实例的登录配置。

分享项目端点前，请与管理员核查生成的配置及访问权限。

3. JSON · 传输方式

选择 JSON，再选择 macOS/Linux、Windows 或 WSL，然后在“传输方式”下选择 SSE 或 Streamable HTTP。

将生成的配置复制到 MCP 客户端，并在私有配置中替换所有出现的 YOUR_API_KEY 占位符。

如果 JSON 视图提供“生成 API 密钥”操作，且你需要密钥，请使用该操作。

“自动安装”要求 AI Flowi Workflow 在本机运行，且所选客户端可用；远程实例请使用 JSON 配置。

使用无害输入测试选定的工具，并确认客户端收到预期的工作流响应。

4. MCP Servers · 添加 MCP 服务器

在设置中打开 MCP Servers，并选择“添加 MCP 服务器”。

选择 JSON 可粘贴服务器配置；选择 STDIO 可填写 Name、Command、Arguments 和 Environment Variables；选择 Streamable HTTP/SSE 可填写 Name、Streamable HTTP/SSE URL、Headers 和 Environment Variables。

对于 STDIO，请确认配置的命令及其依赖项在运行 AI Flowi Workflow 的服务器上可用。

选择“添加服务器”，然后检查已保存连接的工具数量或错误消息。

使用“编辑”和“更新服务器”更改连接；选择“删除”会在移除前打开确认提示。

5. MCP Tools · MCP Server / Tool

将 MCP Tools 添加到工作流，选择已保存的 MCP Server，再选择 Tool，并填写显示的输入项。

运行组件并查看 Response，它会以表格形式返回所选工具的结果。

对 HTTPS 连接，请保持 Verify SSL Certificate 启用。

组件的 Headers 会覆盖服务器设置中保存的请求头。

6. MCP Client · Bob (IBM) / Claude Code

在设置中打开 MCP Client，并选择 Bob (IBM) 或 Claude Code。

对于 Bob (IBM)，打开“设置 > MCP”，选择“编辑全局 MCP”或“编辑项目 MCP”，粘贴显示的 JSON 并保存。

对于 Claude Code，使用显示的终端命令，或将 JSON 配置添加到 ~/.claude.json。

客户端配置使用当前实例地址作为 SERVER_URL，并使用 YOUR_API_KEY 作为 API_KEY 的占位符。

在“API 密钥”设置中生成密钥，并在私有配置中替换占位符。

常见误区

混淆项目的 MCP Server 与 MCP Servers 下保存的外部连接。
误以为“自动安装”可用于远程实例。
分享包含真实 API 密钥的生成配置。
以为尚未选择 Tool 就能执行服务器连接。

故障排查

遇到“MCP 服务器配置错误”时，请先修正项目的 OAuth 配置，再生成客户端配置。

如果 MCP Servers 中出现“超时”或“错误”，请查看服务器错误详情，并检查其连接设置。

如果出现“未找到工具”，请先检查外部服务器是否公开了工具，再在 MCP Tools 中选择它。

如果工具名称或输入项看起来已过时，请关闭 Use Cached Server，重新获取工具及服务器更新。

如果提示“名称和命令为必填项。”或“名称和 URL 为必填项。”，请填写必填字段后再添加服务器。