AIを活用してAPI仕様書を効率的に検証する方法

エージェントがInsomnia MCPを使用してローカルのデザインファイルを読み取り、OpenAPIやSwaggerの仕様に沿っているか検証します。スキーマの妥当性やエンドポイントのロジックについて、即座にフィードバックが得られます。具体的な仕組みは以下の通りです。

1. 01

   ファイルの特定

   Insomnia環境内をスキャンし、レビュー対象となる特定の設計ファイルを見つけ出します。

   list_files
2. 02

   仕様書の読み込み

   対象ファイルが特定されると、エージェントはOpenAPIまたはSwaggerドキュメントの全内容を取得します。

   get_file
3. 03

   構造の解析

   JSONまたはYAMLの内容を解析し、すべてのエンドポイント、パラメータ、レスポンスオブジェクトをマッピングします。

   get_file
4. 04

   問題の報告

   エラーや改善点の要約を、チャットインターフェース上に直接提示します。

   list_files

Insomnia Connector

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

コネクタリンクhttps://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/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 — Insomnia capabilities are ready to use.

設定 · claude_desktop_config.jsonコピー

{
  "mcpServers": {
    "insomnia-collaborative-api-design-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp"
    }
  }
}

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

リンクから接続を承認してください。認証情報は暗号化されて保持され、接続後すぐに質問ができるようになります。

• 01

  AIがInsomniaのファイルを直接編集することはできますか？

  いいえ。AIはフィードバックを提供するためにファイルを読み取ることはできますが、編集はできません。変更を加える場合は、手動でInsomniaを使用して保存する必要があります。

• 02

  AIはInsomniaのすべてのデータにアクセスできますか？

  いいえ。AIがアクセスできるのは、提供されたツールを使用して、あなたが指示した特定のファイルのみです。

• 03

  APIリクエストの検証も可能ですか？

  いいえ。このワークフローは設計仕様書を検証するために設計されており、実際のAPIリクエストを実行するためのものではありません。

• 04

  仕様書がJSONではなくYAML形式の場合はどうなりますか？

  有効なOpenAPIまたはSwagger仕様書であれば、JSONとYAMLのどちらの形式でも読み取ることが可能です。

• 05

  AIが設計データを削除してしまうことはありますか？

  いいえ。使用するツールはファイルのリスト取得と内容の読み取りのみを許可しています。ファイルを削除したり、上書きしたりする機能はありません。

• Insomniaに関するその他の質問 Insomnia Connectorの全機能を見る