在给企业内部系统或 SaaS 产品接入大模型 Agent（智能体）、开发 Function Calling（工具调用）或者封装 MCP（Model Context Protocol）Server 时，后端和 AI 工程师最烦的一件体力活就是「手搓 Tool Schema」：明明后端已经有现成的 FastAPI / Spring Boot 导出的 OpenAPI 3.0/3.1 或 Swagger 2.0 接口文档（JSON 或 YAML），但要喂给不同大模型时，OpenAI[1] 要求一层 type: "function" 且开启 strict: true 严格模式时所有字段必须塞进 required 并把可选字段改成 ["string", "null"] 联合类型；Anthropic[2] Claude 要求顶层叫 input_schema；MCP 协议要求 tools/list 结构；Google Gemini 的 functionDeclarations 又不认 JSON Schema 的联合类型数组、只认 nullable: true 标志位。更别提原文档里到处是 $ref 内部引用、readOnly 只读返回字段，或者路径参数 id 和请求体里的 id 重名互相覆盖。想在一个免安装依赖的网页里把 OpenAPI/Swagger 规范一键转成 OpenAI、Claude、MCP、Gemini 五种可直接复制的工具定义，并配合 MCP 配置校验、Token 计数和 API 成本测算把 Agent 开发跑通，可以直接使用 SaaS Feeds[3]（https://saasfeeds.com/）工具箱（https://saasfeeds.com/tools ）新上线的 OpenAPI → AI 工具 Schema 转换器（https://saasfeeds.com/tools/openapi-tools ）。SaaS Feeds 是企业 AI 与 SaaS 行业资讯站，转换过程不落库保存接口文档，也不代管企业 API 密钥。
开发 AI Agent 转换接口 Schema、配 MCP 与算调用成本，各工具怎么配合
| 角色 | 推荐去处 | 能带走什么 | 边界与注意 |
|---|---|---|---|
| 将 OpenAPI 3.x / Swagger 2.0（JSON/YAML）一键转为五大模型工具 Schema | SaaS Feeds OpenAPI 转 AI 工具转换器（https://saasfeeds.com/tools/openapi-tools）[4] | 输出 OpenAI Chat、OpenAI Responses（支持 strict 开关）、Anthropic Claude、MCP tools/list、Gemini functionDeclarations 五种页签 + 操作清单与双语告警 |
单次上限 1.5MB，转换后不落库；为防 SSRF 不联网抓取外部 URL $ref |
| 生成与校验 Claude Desktop、Cursor、VS Code、Codex 等 8 客户端 MCP 配置文件 | SaaS Feeds MCP 配置生成与校验器（https://saasfeeds.com/tools/mcp-config）[5] | 本地检查 JSON 语法、command/url 互斥、env 结构与明文密钥风险；一键生成 8 大客户端配置模板 | 纯浏览器本地运行，API Key 不出本机 |
| 统计长 System Prompt 与工具定义占多少 Token 及单次调用成本 | SaaS Feeds AI Token 计数器（https://saasfeeds.com/tools/token-counter）[6] | OpenAI 系 tiktoken 精确分词，Claude/Gemini/DeepSeek/Qwen 等按系数估算，对照 21 款模型算上下文占比与单次人民币成本 | 工具 Schema 越长每次请求固定消耗的输入 Token 越多 |
| 估算团队月度大模型 API 调用账单与对比 48 款 SaaS 软件订阅价 | SaaS Feeds API 费用计算器与 SaaS 定价对比（https://saasfeeds.com/tools/ai-cost-calculator 、https://saasfeeds.com/tools/pricing[7]） | 20+ 主流模型输入/输出/缓存命中率月费测算；48 款 SaaS 按 seat/host/account 核对官网价与免费档 | 价格按页面核对日期更新，非实时合同报价 |
| 查阅各模型官方 Tool Use 协议规范与开源转换库源码 | OpenAI / Anthropic / Google Gemini 官方开发者文档、Model Context Protocol 规范及 GitHub[8] | 官方最新 API 字段定义、SDK 调用示例与限流配额说明 | 生产环境鉴权与工具执行安全沙箱需在企业后端自行实现 |
这款 OpenAPI 转 AI 工具转换器怎么帮开发者避开上游开源库的坑
-
一份 OpenAPI / Swagger 粘贴进去，同时吐出 OpenAI、Claude、MCP、Gemini 五种标准结构。
- 打开 OpenAPI → AI 工具 Schema 转换器（https://saasfeeds.com/tools/openapi-tools ，英文版 https://saasfeeds.com/en/tools/openapi-tools ），直接粘贴 JSON 或 YAML 格式的 OpenAPI 3.0/3.1 或 Swagger 2.0 规范（也可以点「填入示例」秒级体验包含查询、创建、文件上传与冲突参数的典型接口）。
- 点击转换后，页面下方直接给出五个可一键复制或下载
.json的输出页签：OpenAI Chat Completions、OpenAI Responses API、Anthropic（Claudetools）、**MCP（tools/list）**以及 Google Gemini（functionDeclarations）。同时顶部的工具条支持按 HTTP 方法（GET/POST/PUT/PATCH/DELETE）勾选过滤、决定是否包含已标记为deprecated的废弃接口，以及给生成的工具名统一加上模块前缀（如crm_或order_）。
-
原生支持 OpenAI
strict: true严格模式变换与 Gemini Schema 子集投影。- 写过 OpenAI Structured Outputs / Strict Function Calling 的人都知道，一旦打开
strict: true，OpenAI 接口会强制要求每个object层级都加上additionalProperties: false，并且原本可选（optional）的参数也必须全部列进required数组、同时把字段类型改写成["string", "null"]联合类型，还要剥离format、pattern、minimum等不被 strict 子集支持的校验关键字。手工改一个有 20 个参数的接口极易漏改报错。 - 在转换器顶部勾选「OpenAI strict 模式」开关后，引擎会自动递归完成全套 strict 变换；而在 Gemini 页签下，引擎又会自动将 OpenAPI 3.1 的
["string", "null"]还原为 Gemini 专用的type: "string", nullable: true标志位，并把 Gemini 不支持的oneOf自动降级为anyOf同时在告警栏给出明确提示。
- 写过 OpenAI Structured Outputs / Strict Function Calling 的人都知道，一旦打开
-
修掉常见开源转换工具的三个经典暗坑：非对象请求体丢失、重名静默覆盖与
readOnly污染。- 很多开发者直接用现成的简单脚本把路径参数（path/query）和请求体（requestBody）拍平放进同一个
properties字典时，常踩三个坑：① 如果某个接口的requestBody顶层是个数组（type: array）或纯字符串而不是object，不少开源工具（如早期fastapi_mcp#319）会直接把整个请求体丢掉；② 如果 URL 路径里有个{id}，JSON 请求体里也有个id字段，扁平化时后者会静默覆盖前者；③ 响应体模型复用了同一个 Schema，导致只读的readOnly字段（如created_at）被当成必填入参喂给大模型。 - SaaS Feeds 的转换器专门针对这三点做了工程修复：顶层非对象的请求体会自动包裹进
body属性不丢失；请求体字段与 path/query/header 参数重名时会自动改名为<name>__body并在双语告警列表中逐条标出；所有标记为readOnly: true的属性会自动从工具入参 Schema 中剔除，同时剥离discriminator、xml、example等大模型不认的 OAS 专有字段。
- 很多开发者直接用现成的简单脚本把路径参数（path/query）和请求体（requestBody）拍平放进同一个
-
转完 Schema 顺手测 Token 开销、算 API 账单、生成客户端 MCP 配置文件。
- 大家都知道，每次调用大模型时，挂载在
tools数组里的几十个 JSON Schema 都会被拼进 System Prompt 计入输入 Token。转出 JSON 后，你可以直接复制到同站的 AI Token 计数器（https://saasfeeds.com/tools/token-counter ），看看这组工具定义每次固定吃掉多少百个 Token；再去 AI 模型 API 费用计算器（https://saasfeeds.com/tools/ai-cost-calculator ）结合 Prompt 缓存命中率算算一个月要花多少钱；如果做的是本地或远程 MCP Server，还能用 MCP 配置生成与校验器（https://saasfeeds.com/tools/mcp-config ）一键生成 Claude Desktop、Cursor、Claude Code、VS Code、Codex 等 8 个客户端的配置文件。
- 大家都知道，每次调用大模型时，挂载在
开发 AI 工具调用与 MCP 服务时的组合用法
| 你当前的开发步骤 | 推荐打开的工具页面 | 能帮你省掉什么麻烦 |
|---|---|---|
| 后端已有 FastAPI/Swagger 接口文档，要快速接入 OpenAI、Claude、Gemini 或封装 MCP | OpenAPI → AI 工具转换器（https://saasfeeds.com/tools/openapi-tools） | 一键展开 $ref、剔除 readOnly、处理重名冲突，生成五种模型原生 Tool Schema |
开启 OpenAI strict: true 后总是报 additionalProperties 或 required 校验错误 |
OpenAPI → AI 工具转换器（勾选 strict 模式） | 自动递归注入 additionalProperties: false，将可选字段转为 null 联合并补齐 required |
| 挂载了十几个工具后想看每次请求白白消耗多少输入 Token、换哪个模型更省钱 | AI Token 计数器 → API 费用计算器（https://saasfeeds.com/tools/token-counter 、https://saasfeeds.com/tools/ai-cost-calculator） | 精确算出工具 Schema 的 Token 数，对比 20+ 模型开启缓存前后的月度 API 成本 |
| 写好了 MCP Server，要给团队配进 Cursor、Claude Desktop、VS Code 或 Codex | MCP 配置生成与校验器（https://saasfeeds.com/tools/mcp-config） | 一键生成 8 大客户端 JSON/TOML 片段，校验语法错误与硬编码密钥风险 |
适合谁，不适合谁
适合： 正在开发大模型 Function Calling、Agent 工作流或封装 MCP Server 的后端与 AI 工程师；需要把存量 REST API 快速适配给 OpenAI、Claude、Gemini 多模型底座的技术团队；关注企业 AI 软件成本与 SaaS 订阅价格的产品与技术负责人。
不适合： 需要在线直接发起真实 HTTP 请求调试企业内网接口的用户（这不是 Postman 在线代理，不替你向目标服务器发请求）；或者上传超过 1.5MB 超巨型未拆分 монолит（Monolith）全量规范且依赖外部公网 $ref 动态拉取的场景。
常见追问
Q：我把公司内部接口的 OpenAPI YAML 粘贴进去转换，接口文档会被你们存进数据库吗？
不会。在 OpenAPI 转换器页面（https://saasfeeds.com/tools/openapi-tools ）中明确承诺：服务端仅在内存中解析 YAML/JSON 并返回转换后的结构化结果，单次请求处理完毕即释放，不落库、不记录日志、不缓存任何用户提交的规范内容。同时为了防止服务端请求伪造（SSRF），引擎只展开文档内部的 #/... 引用，遇到指向外部域名的 $ref 会替换为安全占位对象并给出告警。
Q：如果原 Swagger 接口里没有写 operationId，生成的工具名叫什么？
大模型要求工具名必须符合 ^[a-zA-Z0-9_-]{1,64}$。当原接口缺少 operationId 时，转换器会自动按 方法_路径（例如 get_users_by_id）规范化生成合法名称；如果规范化后出现重名，会自动追加 _2、_3 后缀并在告警栏提示。
Q：平时想跟踪最新的企业 AI 落地案例、MCP 生态和 SaaS 行业动态去哪看？ 可以直接浏览 SaaS Feeds 首页（https://saasfeeds.com/）、最新更新（https://saasfeeds.com/latest ）或热点榜（https://saasfeeds.com/hot ），站内清晰区分「本站文章」与「来源报道」并提供原文核对入口。
收尾
把写好的 REST API 变成大模型能稳稳调用的 Tool Schema，本来就不该靠人肉一行行改 JSON。下次给 Agent 接接口、配 MCP 或者算 Token 账单时，直接打开 SaaS Feeds（https://saasfeeds.com/）的工具箱（https://saasfeeds.com/tools ），用 OpenAPI 转换器、MCP 配置器和成本计算器一套跑完，省下大把调格式的时间。