Spec0 是一个面向企业内部 API 的实时、受治理的注册中心,核心目标是为 AI 智能体提供最新、精确的 OpenAPI 规范访问能力,避免将庞大且易过期的规范文档直接粘贴进上下文。
用途 Spec0 让 Cursor、Claude Code 等支持 MCP 的 AI 智能体通过 API Registry MCP 实时查询团队私有 OpenAPI 规范。每次查询只获取所需操作(约 300 token),而不是一次性注入约 150k token 的完整规范,从而保持上下文精简、信息始终最新。
主要能力
- 智能 API 注册中心:对整个组织的 API 目录进行语义索引,智能体可在数百个 API 中通过单次查询定位正确操作,而非一次只能处理一个规范。
- 三种推送方式,统一实时注册:可通过 CI、Web UI 或 CLI 直接推送规范;每个规范都会被索引为 operations、components 与 metadata,并按团队结构进行治理。
- 治理与归属:API 知晓其所属团队,治理、变更告警与订阅路由自动发送给正确负责人。
- Git 原生生命周期:每次推送都进行 Spectral 校验与破坏性变更检测,可在智能体看到之前拦截不合格的规范。
- 组织级治理:支持自定义 Spectral 规则集、组织范围 RBAC、每次 MCP 查询的审计日志以及 SSO。
- 实时 MCP 服务器:规范随代码合并即时更新,无需手动刷新或重新粘贴。
- Schema 正确的 Mock:推送规范即可获得基于 schema 的实时 Mock URL,无需基础设施;规范变更时 Mock 同步变化。支持表达式规则模拟真实行为(如缺货返回 404、余额为零返回 402、按查询参数返回不同负载)。
- 与现有 MCP 客户端兼容:Cursor、Claude Code、Windsurf 以及任何支持 MCP 的客户端均可使用。
- 带引用的问答:Ask Spec0 基于组织已发布的规范及其关系图回答问题,并链接到所引用的操作,便于核对。
- 共享 Mock URL 与 CI 契约测试:一个始终最新的链接供全组织与消费者访问,并可接入 CI 在每次推送时运行契约测试,在 PR 阶段捕获向后不兼容的变更。
使用方式
- 注册账号:在 app.spec0.io 注册,系统即时为组织开通私有注册中心与唯一的 MCP 端点。
- 从 CI 推送规范:安装 CLI,认证一次,推送私有 OpenAPI 规范;可加入 CI 以保证每次合并后保持最新。
- 配置智能体的 MCP 客户端:一条 CLI 命令即可配置 Cursor、Claude Code、Windsurf 等客户端,组织 bearer token 会自动写入。之后即可向智能体询问目录中的任何 API。
安装与命令示例(保留原文): $ npm install -g @spec0/cli $ spec0 auth login $ spec0 push openapi.yaml $ spec0 mcp install --client cursor
适用场景
- 拥有内部 OpenAPI 规范、希望 AI 智能体直接查询的工程团队。
- 使用 Cursor 或 Claude Code 日常开发、规模约 50–500 人的工程组织。
- 需要在 PR 阶段检测破坏性变更、并在前端开发中提前使用实时 Mock 的团队。
限制与说明
- 官方资料未提供具体收费价格信息,仅提到早期设计合作伙伴可获六个月 Team 套餐免费(以两次 30 分钟交流为交换)。
- 官方资料未提供平台兼容性细节(除 MCP 客户端外)。
- 官方资料未提供明确的效果数据或性能指标。
- 规范托管于欧盟,静态加密;CLI 与 Mock 服务器开源(MIT),可自托管于 VPC 或 CI。