
如何把 sim 工作流部署为 MCP 服务器并接入外部 AI 客户端【免费下载链接】simSim is the collaborative workspace to build, deploy, and monitor AI agents and workflows. Used by 100,000 builders.项目地址: https://gitcode.com/GitHub_Trending/sim16/sim如果你的目标是让 Claude Desktop、Cursor、VS Code 等 MCP 兼容客户端能直接调用 sim 中写好的工作流本文给出完整操作路径把已部署的工作流发布为 MCP tool创建一个 MCP server 拿到服务器 URL再把你使用的客户端配置上去。最终结果是工作流成为外部 AI 助手可调用的工具——客户端发起调用时请求到达你的 MCP server URLsim 校验请求、把参数映射到工作流输入、执行对应部署版本的工作流并把结果返回给客户端。前提条件工作流中已有Start block并在其Input Format里定义好输入字段。Input Format 的每个字段会直接变成 MCP tool 的参数字段描述默认来自 Start block 上该输入的 description。工作流已经部署Deploy。只有已部署的工作流才能被添加为 MCP tool。你有对应权限创建 MCP server 和把工作流加入 server 需要Write或Admin权限删除 server 需要Admin。部署工作流MCP 工具的执行对象是部署快照所以第一步是在画布上完成部署打开你的工作流点击Deploy。在弹出的 Deploy modal 的General页签中点击Deploy完成首次发布之后如果你在画布上改了工作流工具栏会出现Update deployment徽标点击Update即可发布新版本。注意MCP 工具执行的是与 API 调用相同的部署版本。画布上的修改不会立刻影响线上行为只有点击Update才会发布新快照下次 MCP 调用才会用到新的 Start block 输入描述。创建 MCP serverMCP server 用来把一组工作流工具归在一起。在 workspace 设置中操作进入Settings → MCP Servers。点击Add。输入名称和可选的描述。选择访问方式API Key私有客户端必须带X-API-Key请求头或Public无需认证。Public server 任何拿到 URL 的人都可以调用只适合不涉及敏感数据的工作流。可选在这里直接勾选已部署的工作流立即作为工具加入。点击Add Server。点击Details查看 server 详情页复制 server URL之后接入客户端时使用。同一个工作流可以同时加入多个 MCP server每个 server 有各自的 URL可以按不同用途或客户端拆分工具。把工作流发布为 MCP tool对每个要暴露的工作流操作一次打开已部署的工作流点击Deploy切换到MCP页签。配置工具名称和描述。名称只允许小写字母、数字和下划线建议有描述性如search_documents、send_email描述留空时会回退到工作流的描述。检查参数描述。参数来自 Start block 的 Input Format 字段每个参数描述默认取该输入在 Start block 上的 description如果某个工具需要与默认不同的描述可以按工具单独覆盖。选择要把这个工具加入哪些 MCP server。点击Save Tool。接入外部 AI 客户端Sim 会为每个受支持的客户端生成可直接粘贴的配置。获取方式进入Settings → MCP Servers。点击目标 server 的Details。在MCP Client区域选择你的客户端Cursor、Codex、Claude Code、Claude Desktop、VS Code或Sim。复制生成的配置并按下方配置说明处理认证。以下各客户端示例中的YOUR_SERVER_URL替换为你 server 详情页复制的 URL$SIM_API_KEY的处理见文末说明。CursorCursor 支持直接 URL 配置添加到 Cursor 的 MCP 设置文件.cursor/mcp.json{ mcpServers: { my-sim-workflows: { url: YOUR_SERVER_URL, headers: { X-API-Key: $SIM_API_KEY } } } }Cursor 原生处理变量展开$SIM_API_KEY可以保留为环境变量。server 详情页也提供一键安装按钮。Codex添加到~/.codex/config.toml[mcp_servers.my-sim-workflows] url YOUR_SERVER_URL env_http_headers { X-API-Key SIM_API_KEY }需要在启动 Codex 前设置SIM_API_KEY环境变量。ChatGPT 桌面应用、Codex CLI 和 Codex IDE 扩展共用这一份配置。Claude Code在终端运行claude mcp add my-sim-workflows --url YOUR_SERVER_URL --header X-API-Key:$SIM_API_KEYClaude Desktop添加到~/Library/Application Support/Claude/claude_desktop_config.json通过mcp-remote桥接 HTTP 端点{ mcpServers: { my-sim-workflows: { command: npx, args: [-y, mcp-remote, YOUR_SERVER_URL, --header, X-API-Key:$SIM_API_KEY] } } }VS Code添加到.vscode/mcp.json方式与 Claude Desktop 相同{ mcpServers: { my-sim-workflows: { command: npx, args: [-y, mcp-remote, YOUR_SERVER_URL, --header, X-API-Key:$SIM_API_KEY] } } }关于$SIM_API_KEY占位符Claude Desktop 和 VS Code 的 JSON 配置不会展开环境变量必须把$SIM_API_KEY替换成你的实际 API keyCodex 从环境变量读取SIM_API_KEYClaude Code 和 Cursor 原生支持变量展开可保留原样。如果你创建的是 Public server则省略X-API-Key请求头和--header参数——Public server 不需要认证。验证接入配置完成后按以下顺序核对在Settings → MCP Servers的 server 详情页中查看已加入该 server 的工具列表确认你的工作流在列并再次确认 URL 与客户端配置中填写的一致。也可以用 sim CLI 列出工具做独立核对需要 personal API keysim workflow-mcp-servers tools list serverIdserverId是 server 的唯一标识。如果工具列表没有变化用--refresh参数绕过工作区级工具缓存、以你自己的凭据重新发现sim workflow-mcp-servers tools list serverId --refresh注意 CLI 中的工具列表来自短生命周期的按 workspace 缓存缓存结果反映的是最后执行发现的成员所看到的工具所以刚加的工具没出现时先加--refresh。协议层面sim 实现标准 MCP 协议基于官方modelcontextprotocol/sdk类型支持 JSON-RPC 2.0 消息包括tools/list和tools/call方法。客户端连上后能否发现并调用工具以客户端侧工具列表和执行结果为准。排错与限制工具没出现确认工作流处于已部署状态未部署的工作流无法作为 MCP tool。改了 Start block 但参数描述没变已部署工具要等下一次重新部署Update才会拾取 Start block 的改动单个工具需要不同描述时用工具级覆盖。认证方式通过 mcp-remote 或基于 HTTP 的 MCP 传输连接时把 API key 放在X-API-Key头中服务端使用同时支持 session 和 API key 两种访问的 hybrid auth 做校验。权限不足查看 MCP server 需要 Read 及以上创建/添加工具需要 Write 或 Admin删除 server 需要 Admin。后续管理server 详情页还提供日常管理能力查看工具、复制 URL、添加更多已部署工作流、移除工具、删除整个 server连同其全部工具。如果之后需要程序化管理sim workflow-mcp-serversCLI 命令组覆盖创建、更新、删除 server 以及发布/取消发布工具等操作例如把已部署工作流发布为工具sim workflow-mcp-servers tools create serverId --workflow-id value --tool-name value详细参数见仓库文档 CLI · Workflow MCP Servers。【免费下载链接】simSim is the collaborative workspace to build, deploy, and monitor AI agents and workflows. Used by 100,000 builders.项目地址: https://gitcode.com/GitHub_Trending/sim16/sim创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考