Octri SDK Generator：从 OpenAPI 规范生成文档、SDK、MCP 服务器与监控

你的 OpenAPI 规范，一路直达生产环境。

一个文档站点、十种语言的 SDK、一个面向智能体的 MCP 服务器，以及能在这些 SDK 于生产环境出问题时告诉你的监控。一份规范生成全部四项，并让它们保持最新。

（3 分钟视频）

一个输入

上传一次规范。交付四款产品

文档、SDK、监控和智能体工具。每一个都独立成立。它们只是恰好在一起时更好。

1. 输入

   你的规范

   任意格式：OpenAPI、Swagger、Postman 或 AsyncAPI，JSON 或 YAML。统一规范化为 OpenAPI 3.1。

2. 文档站点

   撰写、编辑、发布

3. SDK · 10 种语言

   按你的内部风格定制

4. 可观测性

   哪里出问题，以及为什么

5. MCP 服务器

   把你的 API 变成智能体工具

四款产品，一个平台

API StudioAPI 文档

值得一读的文档，来自你已有的规范

AI 为每个端点撰写初稿。你像编辑文档一样编辑它。没人需要打开 YAML。

• 三栏式端点页面，带逐层展开的 schema 树
• 每个端点上的实时“试一试”演练场
• MDX 指南与生成的参考文档并列
• 每个套餐都支持你自己的域名，包括免费版

查看 API Studio

SDK StudioSDK 生成器

十种语言，按你的约定构建

重命名方法、排除端点、选择你的 HTTP 引擎和文件夹结构。然后让它自行发布。

• 按语言配置命名空间、分页、幂等性和代码风格
• 自定义钩子由你编写，编译进客户端
• 自动发布到 npm、PyPI、Maven、crates.io、RubyGems 等
• 构建历史，让你确切看到何时交付了什么

查看 SDK Studio

SDK 会为 TypeScript、Python、Go、Java、Dart、Ruby、PHP、Rust、Swift、Kotlin 生成。

监控SDK 和 API 监控

在你的客户告诉你之前，先发现哪里出问题

两种接入方式：开启后，遥测会编译进你生成的 SDK；或者把独立包直接放进你的后端。无论哪种方式，都无需部署代理，也无需埋点。

Octri 监控：查询结构化日志、打开原始事件负载、分组问题、跨客户端、服务器、缓存和数据库的追踪瀑布图、服务地图、N+1 查询检测、合成可用性检查和告警规则。

监控默认关闭，从仪表盘开启。凭据和直接标识符，从令牌到邮箱、电话和 IP，都会在客户端侧、事件离开你的进程之前被脱敏，然后在摄取时再次脱敏。个人上下文需等待你的应用同意，依据预签署的 GDPR 第 28 条 DPA。

MCP面向智能体的 MCP 服务器

别再让智能体幻觉你的 API

MCP 是智能体触达它从未被训练过的事物的方式。没有它，Claude 或 Cursor 会凭记忆集成你的 API。有了它，一条命令就能把你的项目变成它们连接的服务器。然后它们列出你真实的端点并调用它们。

• 七个文档工具，用于搜索、阅读和浏览你的文档
• 每个端点一个可调用工具，让智能体可以真正访问你的 API
• 由 SDK Studio 策划，因此你的排除列表就变成了智能体的权限列表
• 一行即可安装：npx @octri/mcp，无需托管任何内容

查看 MCP

你的规范是否已准备好进行代码生成？

粘贴你的 OpenAPI URL，即可获得满分 10 分的评分，评分规则与 SDK Studio 所运行的规则相同。在任何人基于它生成客户端之前，你就能看到每一个缺失的 schema、未声明的路径参数以及别扭的方法名。

同时运行一个示例审计：在 24 个操作中，就绪评分为 10 分中的 6.8 分，规范通过和未通过的规则在下方滚动显示。

这十四条规则检查什么，以及每一条规则会让生成的 SDK 付出什么代价。

改一处。四者全部跟随

在 API Studio 中弃用一个端点，SDK 会标记该方法，智能体工具会停止提供它，监控会显示还有谁在调用它。添加一种语言、发布一个版本、推送一份新规范：同样的事情都会发生。这四者之下只有一个源头，因此永远不会有第二个需要去更新的地方。

其他所有人都在“这是你的 SDK”处止步。

那一刻起，你的代码就脱离了你的视野。它在别人的机器上运行，在别人的机器上失败，而你在三天后的一张支持工单里才得知此事。

没有 Octri

抛出错误在他们的机器上

没有任何报告没有警报

3天

生产环境仍然故障你毫不知情

愤怒的支持工单#4412-4414

又一次

有了 Octri

抛出错误在他们的机器上

警报触发即时

9分钟

修复已发布v2.3.2

0 张支持工单无人察觉

从规范到发布只需一个下午

从一份 OpenAPI 规范出发的完整流水线：API 文档、十种语言的客户端库、一个 MCP 服务器以及生产监控。

01

连接 your spec

上传文件或关联 GitHub 仓库。来自 Postman 或 AsyncAPI？我们帮你转换。

02

审阅 草稿

AI 为每个端点撰写文档。随意编辑，读起来没问题时即可发布。

03

选择你的 语言

配置 SDK，开启监控，构建。它们会自行发布。

04

推送到 仓库

每次规范变更都会重新运行整条流水线。文档、SDK、智能体工具，全部保持同步。

一份规范，十个客户端库

每个客户端都由同一份 OpenAPI 文档生成，并发布到其自身用户已经使用的注册表中。

• TypeScript

  发布到 npm，类型定义由你的规范生成。fetch 或 axios。

• Python

  发布到 PyPI。异步优先，可选同步变体，并可选择数据模型。

• Go

  通过 git tag 分发，因此 go get 可直接从你的仓库解析。使用标准库 HTTP。

• Java

  发布到 Maven Central，已签名，使用你拥有的域名下的 groupId。

• Dart

  发布到 pub.dev，Dart 和 Flutter 通用。

• Ruby

  发布到 RubyGems，采用 Ruby 调用者所期望的类风格客户端。

• PHP

  发布到 Packagist，因此 Composer 会像安装其他依赖一样安装它。

• Rust

  发布到 crates.io，完整的文档注释会成为用户在 docs.rs 上阅读的 rustdoc。

• Swift

  通过 git tag 分发，由 Swift Package Manager 解析。无需注册表账号。

• Kotlin

  发布到 Maven Central。OkHttp 或 Ktor，随你团队已在使用的那个。

已经在用其他工具？

我们读取你现有的配置并完整迁移过来：导航、自定义页面、SDK 设置等等。你无需从空白项目开始。需要迁移协助？与我们通话以及我们的入门帮助均免费。

简单、组合定价

文档、SDK 和监控集于一个方案。额外的 SDK 语言为固定附加费用。

额外语言为固定 $50/月。

推荐

Growth

$79/月+ 税

适合快速交付的成长型团队。

选择 Growth

Enterprise

定制

无限规模，附 SLA 保障。

联系销售

来自 构建过程 的笔记

我们在交付规范、SDK 和遥测中学到的东西，认真写下来。

所有文章

问题

方案、规范变更、编辑生成的文档和 SDK、训练数据和自托管。

不。方案不是按产品划分的，所以你可以让某个产品保持关闭，几个月后再开启，而无需重做任何已设置好的内容。

你的规范 已经写好

其余一切只需一个下午。