Octri 是一个面向 API 生产全流程的平台，核心是“一份 OpenAPI 规范，生成四个产品”。用户将 API 规范（OpenAPI、Swagger、Postman 或 AsyncAPI，JSON 或 YAML）指向 Octri，平台会将其归一化为 OpenAPI 3.1，并自动生成和维护以下四类产物：文档站点、10 种语言的 SDK、一个 MCP 服务器以及生产环境监控。每个产品可独立使用，但组合使用时效果更好。
主要能力
文档站点：AI 为每个端点生成初稿，用户可像编辑文档一样修改，发布到自有域名。端点页面采用三栏布局，包含逐级展开的 schema 树、每个端点的实时“试一试”演练场，并支持在生成的参考文档旁添加 MDX 指南。所有套餐（包括免费版）均支持自定义域名。
SDK 生成（10 种语言）：支持 TypeScript（发布到 npm，使用 fetch 或 axios，含从规范生成的类型定义）、Python（发布到 PyPI，异步优先，可选同步变体和数据模型）、Go（通过 git tag 分发，使用标准库 HTTP）、Java（发布到 Maven Central，签名，使用自有域名的 groupId）、Dart（发布到 pub.dev，适用于 Dart 和 Flutter）、Ruby（发布到 RubyGems，类风格客户端）、PHP（发布到 Packagist，Composer 安装）、Rust（发布到 crates.io，doc 注释生成 rustdoc）、Swift（通过 git tag 和 Swift Package Manager 分发，无需注册表账号）、Kotlin（发布到 Maven Central，可选 OkHttp 或 Ktor）。支持按语言配置命名空间、分页、幂等性和代码风格，自定义钩子可编译进客户端，自动发布到 npm、PyPI、Maven、crates.io、RubyGems 等注册表，并提供构建历史。
监控与可观测性：用户可选择在项目中启用 Monitoring 并重新构建，让 SDK 用户从应用中自愿开启；或为后端添加独立包。无需独立代理。支持按级别、路由、状态码或发布版本查询结构化事件；按指纹分组错误并关联到抛出错误的函数和文件；端到端追踪单个请求跨客户端、服务器、缓存、数据库和队列的路径，并标出慢跨度；展示服务间调用和每条边的错误率；自动发现循环中的相同查询并在追踪中计数；按计划运行合成探测并保留历史记录；基于燃烧率和回归触发警报，避免单个 500 错误唤醒所有人。凭证和标识符在客户端事件离开进程前及摄入时进行脱敏。监控默认关闭，从仪表板开启，个人上下文需应用同意，并遵循预签名的 GDPR 第 28 条 DPA。
MCP 服务器：一条命令 npx @octri/mcp 即可将项目转为 MCP 服务器，无需托管。提供 7 个文档工具用于搜索、阅读和导航文档，每个端点对应一个可调用工具，让 Claude、Cursor 等 MCP 客户端能够列出并调用真实端点。SDK Studio 的排除列表会成为智能体的权限列表。
规范就绪度评分：粘贴 OpenAPI URL 可获得 10 分制评分，基于 SDK Studio 运行的相同规则，显示缺失的 schema、未声明的路径参数和不规范的方法名。示例审计显示 24 个操作得分 6.8 分，并列出通过和未通过的 14 条规则及其对生成 SDK 的影响。
使用方式
- 连接规范：上传文件或关联 GitHub 仓库，Postman 或 AsyncAPI 格式会被翻译。
- 审查草稿：AI 为每个端点撰写文档，用户可编辑，满意后发布。
- 选择语言：配置 SDK 并构建。监控需要每个 SDK 用户自愿开启；关联的注册表可自动发布。
- 推送到仓库：每次规范变更都会重新运行整个流水线，保持文档、SDK、智能体工具同步。
平台支持从现有配置迁移，读取已有导航、自定义页面、SDK 设置等，无需从空白项目开始，迁移协助和入门帮助免费。自托管生成和文档渲染暂未提供，当前为托管服务。
适用场景
适合需要维护 API 文档、多语言 SDK 和监控的团队，尤其是希望将 API 端点暴露给 AI 智能体（如 Claude、Cursor）的开发者。从规范到交付，正常文档站点大约需要一天，其余部分一个下午即可完成。
限制
当前为托管服务，自托管生成和文档渲染暂不可用。自定义 SDK 代码仅在 Growth 及以上套餐提供。个人上下文需要应用同意，并遵循 GDPR 第 28 条 DPA。SDK 监控需要 SDK 用户自愿开启，或自行在后端添加独立包。具体套餐分级、价格细节和免费版功能范围暂未提供。
