AIでAPIスキーマの詳細を検証する方法：Stoplight MCPコネクター活用術

エージェントがStoplightからOpenAPIモデルや特定のエンドポイント定義を取得します。次に、実装内容とこれらの最新の要件を比較して、不一致がないかを特定します。ドキュメントが求めている正確な仕様を、AIが即座に把握できます。

1. 01

   プロジェクトの構成把握

   Stoplightプロジェクト内にある、利用可能なすべてのAPIノードをエージェントが特定します。

   list_project_nodes
2. 02

   エンドポイントデータの取得

   選択したエンドポイントの具体的なスキーマと定義をエージェントが取得します。

   get_node_details
3. 03

   実装内容の比較

   エージェントがコードを確認し、取得したOpenAPIモデルと照らし合わせます。

   get_node_details
4. 04

   不一致の報告

   ドキュメントと一致しない特定のフィールドやパスを、エージェントがリストアップします。

   list_project_nodes

Stoplight Connector

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

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

設定 · claude_desktop_config.jsonコピー

{
  "mcpServers": {
    "stoplight-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp"
    }
  }
}

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

アカウントの連携は一度だけで完了します。認証情報は暗号化されて保護されるため、すぐにエージェントへAPI仕様について質問を開始できます。

• 01

  AIがStoplightのドキュメントを更新することはできますか？

  いいえ。AIはコードの検証を支援するために、モデルや定義を読み取ることのみが可能です。

• 02

  AIがコードを自動的に書き換えることはありますか？

  いいえ。AIは不一致を特定して修正案を提示しますが、変更を適用するのは必ずあなた自身で行う必要があります。

• 03

  あらゆるOpenAPI仕様で動作しますか？

  はい。Stoplightプロジェクトのノードを通じてアクセス可能な仕様であれば、問題なく動作します。

• 04

  パラメータの不足を見つけるために使えますか？

  はい。エージェントがコードとノードの詳細を比較し、不足しているフィールドや余分なフィールドを特定できます。

• 05

  AIはStoplightアカウント全体にアクセスしますか？

  いいえ。エージェントは、提供されたツールを使用してあなたが指示した特定のプロジェクトノードにのみアクセスします。

• Stoplightに関するその他の質問 Stoplightコネクターの全機能を見る