• インベントリ
  • 構造
  • 詳細
  • 手動操作

AIでAPIインフラとプロジェクトの構成を可視化する方法

SwaggerHubをAIクライアントに接続すれば、散在する定義を整理された技術マップへと変換できます。

このページについてAIに聞く

すぐに答え

AIでAPI環境をどのように可視化できますか?

AIがSwaggerHubにクエリを送り、プロジェクト一覧やAPIのインベントリを取得します。これにより、技術環境全体の構造化されたビューが得られます。

データの活用先

マッピングによって得られる成果

AIはSwaggerHubのデータを以下の形式で整理します。

インベントリ

完全なAPIリスト

選択したプロジェクト内のすべてのAPIをAIが抽出します。現在の環境にあるものが一目でわかるリストを作成できます。

構造

プロジェクトのグループ化

APIがどのようにプロジェクトごとに整理されているかをAIが特定します。技術環境の階層構造を把握するのに役立ちます。

詳細

詳細な仕様の深掘り

特定のプロジェクトに関する設定やメタデータをAIが取得します。特定のエンドポイントやプロジェクト構成について直接質問できます。

手動操作

手動での更新

AIはSwaggerHubの定義を直接編集することはできません。定義の変更やドキュメントの更新は、引き続きSwaggerHubのUIで行ってください。

ワークフロー

リクエストを受けた際のAIの動作

AIはSwaggerHubとの接続を利用して、データのスキャンと整理を行います。

  1. プロジェクトのスキャン

    SwaggerHubアカウント内にある、利用可能なすべてのプロジェクトコンテナをAIが特定します。

    list_projects
  2. APIの監査

    特定されたプロジェクト内を調査し、ホストされているすべてのAPI定義を見つけ出します。

    list_apis
  3. 詳細の抽出

    指定されたプロジェクトの具体的な構成情報やメタデータを取得します。

    get_project_details
  4. マップの構築

    プロジェクトとAPIの相関関係を整理し、構造に関する質問に回答します。

    list_projectslist_apis

試してみる

以下のプロンプトをコピーして開始

これらのプロンプトを使って、環境のマッピングを開始しましょう。

出発点

これらは会話のきっかけとなる例です。実際のSwaggerHubのプロジェクト名やAPI名に書き換えて使用してください。

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"
    }
  }
}
チャットにコピー04
  • 現在私のSwaggerHubアカウントにあるすべてのプロジェクトをリストアップして。

  • 'Payment Gateway' プロジェクト内のすべてのAPIを教えて。

  • 'User Auth Service' のプロジェクト詳細の概要をまとめて。

  • すべてのプロジェクトとそれに関連付けられたAPIをリストアップして、API環境のマップを作成して。

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

ここから始める

SwaggerHubを一度接続すれば、すぐに質問できます

一度接続するだけで、AIがSwaggerHubのデータにアクセスできるようになります。認証情報は暗号化され、接続後すぐにクエリを開始できます。

SwaggerHubをAIに接続する

FAQ

動作に関する詳細

  • 01

    AIはAPIの定義を編集できますか?

    いいえ。AIができることは、SwaggerHubからプロジェクトやAPIのデータを読み取ることのみです。

  • 02

    これを使って新しいプロジェクトを作成できますか?

    いいえ。提供されているツールは、既存データのリスト取得と取得のみを許可しています。

  • 03

    AIはSwaggerHubのすべてのデータを見ることができますか?

    いいえ。AIがアクセスできるのは、マニフェストで提供されている特定のツールを通じて取得可能なデータのみです。

  • 04

    どのAPIがどのプロジェクトに属しているか、AIはどうやって判断するのですか?

    AIはプロジェクト一覧とAPI一覧を照合することで、会話の中でそれらの関係性を構築します。

  • 05

    特定のAPIエンドポイントについて質問してもいいですか?

    はい。その情報が、AIが取得したプロジェクトの詳細に含まれていれば可能です。

  • SwaggerHubについて他に質問がありますか? SwaggerHub Connectorの全機能を見る

『SwaggerHub』を Claude、Cursor、ChatGPT などに接続