Apidog MCPサーバーを介してOpenAPIファイルをAIに接続する

Apidogプロジェクト内のAPI仕様に加えて、Apidogを通じて公開されたオンラインAPIドキュメント、Apidog MCPサーバーはSwaggerまたはOpenAPI仕様(OAS)ファイルを直接読み取ることもできます。

MCPクライアントの設定

前提条件

Node.js環境がインストールされていること（バージョン18以上、最新のLTS推奨）

MCPをサポートする任意のIDE：

Cursor

VSCode + Cline拡張機能

その他

一般的な設定手順

OpenAPIファイルの準備

Swagger/OpenAPIファイルへのURLまたはローカルパスを用意する

サポートされる形式：JSONまたはYAML形式のOpenAPIファイル

IDEでのMCP設定

IDEのMCP設定ファイルに次のJSON設定を追加します：

macOS / Linux

Windows

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--oas=<oas-url-or-path>"
      ]
    }
  }
}

<oas-url-or-path>には以下を指定できます：

リモートURL（例：https://petstore.swagger.io/v2/swagger.json）

ローカルファイルパス（例：~/data/petstore/swagger.json）

CursorでのMCP設定

MCP設定ファイルの編集

Cursorエディタを開き、設定アイコン（右上）をクリックし、左メニューから「MCP」を選択し、「+ Add new global MCP server」をクリックします。

設定の追加

開いたmcp.jsonファイルに次の設定を追加します（https://petstore.swagger.io/v2/swagger.jsonを実際のOpenAPIファイルパスまたはURLに置き換えることを忘れずに）：

macOS / Linux

Windows

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--oas=https://petstore.swagger.io/v2/swagger.json"
      ]
    }
  }
}

設定の確認

AIに接続をテストする（エージェントモードで）：

MCPを介してAPIドキュメントを取得し、プロジェクトに存在するAPIの数を教えてください

AIがOpenAPIファイル内の正しいAPI情報を返す場合、接続は成功です。

connect-ai-to-open-api-file-using-apidog-mcp-server.png

重要な注意事項

複数のOpenAPI仕様ファイルを使用する必要がある場合、設定ファイルに複数のMCPサーバーを追加し、それぞれ異なる--oasパラメータを指定できます。

ローカルファイルパスの場合、パスが正しくファイルが存在することを確認してください。URLの場合、公開アクセス可能で有効なOpenAPI仕様ファイルを返すことを確認してください。

OpenAPIファイルが大きい場合や複雑なデータ構造を含む場合、MCPサーバーが処理に時間を要することがあります。

オンプレミスデプロイメントのユーザーは、IDEのMCP設定にオンプレミスサーバーのAPIアドレスを含めてください：「--apidog-api-base-url= <オンプレミスサーバーのAPIアドレス、http://またはhttps://で始まる> 」また、www.npmjs.com へのネットワークアクセスが適切であることを確認してください。

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--oas=<oas-url-or-path>",
        // オンプレミスデプロイメント用：
        "--apidog-api-base-url=<オンプレミスサーバーのAPIアドレス、http:// または https:// で始まる>"
      ]
    }
  }
}

他のデータリソースをAIに接続する

Apidogプロジェクト内のAPI仕様をApidog MCPサーバー経由でAIに接続する

Apidogが公開したオンラインAPIドキュメントをApidog MCPサーバー経由でAIに接続する

よくある質問

Windows設定の問題

標準設定がWindowsで失敗する場合、次の設定を使用してください：

{
  "mcpServers": {
    "API specification": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "apidog-mcp-server@latest",
        "--oas=<oas-url-or-path>"
      ]
    }
  }
}

Node.jsバージョンの問題

Apidog MCPサーバーを介してOpenAPIファイルをAIに接続する

MCPクライアントの設定#

前提条件#

一般的な設定手順#

CursorでのMCP設定#

重要な注意事項#

他のデータリソースをAIに接続する#