OpenAPI仕様書からAIでコードを自動生成する方法 SwaggerHub MCP

エージェントがSwaggerHub MCPを使用して、仕様書から特定のAPIバージョンや詳細情報を直接取得します。これにより、正確なコード生成に必要なJSONスキーマが提供されます。手動でのコピー＆ペーストは不要です。

1. 01

   仕様書の特定

   エージェントがSwaggerHubアカウント内から、正しいAPI定義を見つけ出します。

   get_api_version_spec
2. 02

   スキーマデータの抽出

   指定されたバージョンの特定のJSON構造をAIが抽出します。

   get_api_version_spec
3. 03

   エンドポイント詳細の収集

   完全性を期すため、エージェントは特定のパスやオブジェクトに関する詳細情報を取得します。

   get_api_details
4. 04

   生成の準備

   AIが取得したスキーマを、コード生成プロンプトで使いやすい形式に整理します。

   get_api_details

SwaggerHub Connector

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

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

設定 · claude_desktop_config.jsonコピー

{
  "mcpServers": {
    "swaggerhub-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_yxaBIFA3ShjsASSaz8QU0k25zGEdGatXEvFXcUe2/mcp"
    }
  }
}

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

ワンクリックでアカウントを接続できます。認証情報は暗号化されて安全に保持されます。利用可能なツールの全リストはコネクターのページで確認できます。

• 01

  AIはSwaggerHub内のOpenAPI仕様書を編集できますか？

  いいえ。AIができるのは仕様書からデータを読み取ることだけです。SwaggerHub内のファイルを直接変更することはありません。

• 02

  AIはすべてのAPIを参照できますか？それとも特定のAPIだけですか？

  接続が完了すると、あなたがSwaggerHubで閲覧権限を持っているすべてのAPIにアクセスできます。

• 03

  これを使ってドキュメントを生成することはできますか？

  はい。AIはAPIの詳細情報を取得できるため、仕様書の要約やスキーマに基づいたドキュメントのドラフト作成を依頼できます。

• 04

  AIが自動的にリポジトリへコードをプッシュすることはありませんか？

  ありません。AIはデータとコードの提案を提供しますが、そのコードをレビューし、リポジトリにコミットするのはあなた自身です。

• 05

  APIの特定のバージョンを探し出すことはできますか？

  はい。SwaggerHubのバージョニング情報を使用して、必要なバージョンの仕様書を正確に取得できます。

• SwaggerHubについてさらに質問がありますか？ SwaggerHub MCPの全機能を見る