OpenAPI Validator EngineでパートナーのAPI仕様書をAI検証する

AIが validate_openapi ツールを使用して、OpenAPIファイルの構文エラー、必須項目の欠落、参照切れをスキャンします。仕様書内の構造的な問題はすべてレポートとしてまとめられるため、実装を開始する前に統合時のエラーを未然に防げます。

1. 01

   ファイルの読み込み

   ローカルファイルでもURLでも、提供されたOpenAPIの生データをAIが読み取ります。

   validate_openapi
2. 02

   構造監査の実行

   公式のOpenAPI仕様ルールに照らして、ファイルの内容をチェックします。

   validate_openapi
3. 03

   参照切れの特定

   存在しないオブジェクトを指している内部参照を徹底的に探し出します。

   validate_openapi
4. 04

   不備のレポート作成

   検出されたすべてのエラーと警告を、分かりやすいリストにまとめて報告します。

   validate_openapi

@seriousme/openapi-schema-validator Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_G95x3PwWbp62LMB6m5PHyPKsw6CprV2yBUtgMX7s/mcpコピー

Claude Desktop

以下の手順で数秒で接続できます。

1. 1In Claude Desktop, open Settings → Connectors.
2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3. 3Click Add and start a new chat — @seriousme/openapi-schema-validator capabilities are ready to use.

設定 · claude_desktop_config.jsonコピー

{
  "mcpServers": {
    "openapi-validator-engine-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_G95x3PwWbp62LMB6m5PHyPKsw6CprV2yBUtgMX7s/mcp"
    }
  }
}

• Claude
• ChatGPT
• Cursor
• VS Code
• Windsurf
• Claude Code
• JetBrains
• Cline

MCPをクライアントにリンクするだけです。認証情報は暗号化されて保持されるため、すぐに仕様書の監査を開始できます。

• 01

  AIは仕様書の誤りを自動的に修正できますか？

  いいえ。AIはエラーを特定して報告しますが、修正するにはユーザー自身でファイルを編集する必要があります。

• 02

  AIはAPIが実際に動作するかどうかまで確認しますか？

  いいえ。このツールは定義ファイルの構造と構文を検証するものであり、実際のライブエンドポイントの挙動をテストするものではありません。

• 03

  プライベートなURLでホストされている仕様書も検証できますか？

  はい。AIクライアントがそのURLにアクセスするためのネットワーク権限を持っていれば可能です。

• 04

  AIが元のファイルを削除することはありませんか？

  ありません。AIは検証のために内容を読み取るだけで、ローカルファイルを変更したり削除したりする権限は持っていません。

• 05

  JSONとYAMLの両方の形式に対応していますか？

  はい。標準的なOpenAPI形式であれば、どちらのフォーマットでも検証可能です。

• OpenAPI Validator Engineについて他に質問がありますか？コネクタの専用ページで回答しています。 OpenAPI Validator Engine Connectorの全機能を見る