Octri.dev

ドキュメント側は OpenAPI ドキュメント生成ツールとして働く。エンドポイントごとにスキーマツリー、ステータスコード別のエラー、読者自身のキーを使う試用コンソールを備えたリファレンスページが付く。AI が各説明の初稿を書き、仕様が空欄にしたフィールドも埋める。ガイドはリファレンスの隣に MDX で置き、ポータル全体は無料プランを含むすべてのプランで独自ドメインに公開できる。

同じ文書から TypeScript、Python、Go、Java、Kotlin、Ruby、PHP、Swift、Dart、Rust のクライアントを生成する。リトライ、ページネーション、型付きエラーは標準装備で、認証は security scheme から配線され、言語ごとにメソッド名の変更やエンドポイントの除外もできる。各リリースは npm、PyPI、Maven Central、RubyGems、crates.io、pub.dev、Packagist、git タグへ自分で出せる。再生成はすべて pull request で届く。

npx @octri/mcp を実行すると、Claude、Cursor、VS Code、その他の MCP クライアントに、仕様から作ったサーバーが渡る。検索と閲覧のためのドキュメントツール 7 つに加え、エンドポイントごとに呼び出し可能なツールが 1 つ付く。エージェントは実在する操作を一覧し、引数名を推測せずに呼べる。ツール一覧は MCP、OpenAI、Anthropic の形式で書き出せる。

生成したクライアントにはエラー報告機能が入り、開発者が有効にするまで止まっている。有効にすると、Octri はエラー、構造化ログ、トレース、稼働チェックを集め、問題を指紋でまとめ、スタックフレームを source map で解決する。トークン、メール、電話、IP はイベントがプロセスを出る前にクライアント側で伏せ、取り込み時にもう一度伏せる。

ドキュメントでエンドポイントを非推奨にすれば、SDK がメソッドに印を付け、MCP サーバーはツールとして出さなくなり、監視は旧経路の呼び出し元を示す。言語を増やす、リリースを切る、新しい仕様を push する、どれも同じように動く。4 つの出力の下には 1 つの源しかない。別の場所を直す必要はない。

監査は 14 のルールで仕様を 10 点満点で採点し、弱いクライアントを生むエンドポイントを名指しする。アカウントなしで動き、ファイルも残さない。3 つのルールだけで 10 点のうち最大 6 点を占める。レスポンススキーマの宣言、components に置く共有モデル、衝突しない公開名だ。