OpenAPI ファイルを AI に接続する

Apidog MCP Server は Swagger または OpenAPI Specification（OAS）ファイルを直接読み取ることができ、AI アシスタントは Apidog プロジェクトやオンラインドキュメントに依存せずに API 仕様を扱えるようになります。

前提条件

MCP クライアントを設定する前に、以下を用意してください。

Node.js（バージョン 18 以降、できれば最新の LTS バージョン）

MCP 互換 IDE：

Cursor

VS Code + Cline plugin

その他の MCP 対応エディター

Swagger/OpenAPI ファイル（URL またはローカルパス）

OpenAPI ファイルの準備

以下のいずれかを用意してください。

リモート URL：公開アクセス可能な OpenAPI ファイル（例：https://petstore.swagger.io/v2/swagger.json）

ローカルファイルパス：お使いのマシン上の OpenAPI ファイル（例：~/data/petstore/swagger.json）

対応形式： JSON または YAML

設定の概要

OpenAPI ファイル用の基本的な MCP 設定は以下のとおりです。

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（Agent モード）に以下を依頼して、接続をテストします。

Please fetch API documentation via MCP and tell me how many endpoints exist in the project

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

重要な注意事項

複数の OpenAPI ファイルを扱う

複数の OpenAPI 仕様ファイルを使用するには、設定ファイルに複数の MCP Server を追加し、それぞれに異なる --oas パラメータを指定します。

例：

{
  "mcpServers": {
    "Petstore API": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--oas=https://petstore.swagger.io/v2/swagger.json"
      ]
    },
    "Local API": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--oas=~/data/my-api/openapi.yaml"
      ]
    }
  }
}

ファイルパスと URL の要件

ローカルファイルパス：パスが正しく、ファイルが存在することを確認してください

URL：公開アクセス可能で、有効な OpenAPI 仕様ファイルを返すことを確認してください

パフォーマンスに関する考慮事項

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

オンプレミスデプロイ

オンプレミスデプロイの場合は、IDE の MCP 設定にサーバーの API アドレスを含めます。

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

<your-server-url> をオンプレミスサーバーの API アドレス（http:// または https:// で始まるもの）に置き換えてください。www.npmjs.com へのネットワークアクセスを確保してください。

その他のデータソース

Apidog プロジェクト内の API 仕様を AI に接続する

Apidog によって公開されたオンライン API ドキュメントを AI に接続する

FAQ

Windows 設定の問題

Windows で標準設定が失敗する場合は、以下の代替設定を使用してください。

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

Node.js バージョンの問題

OpenAPI ファイルを AI に接続する

前提条件#

OpenAPI ファイルの準備#

設定の概要#

Cursor で MCP を設定する#

重要な注意事項#

複数の OpenAPI ファイルを扱う#

ファイルパスと URL の要件#

パフォーマンスに関する考慮事項#

オンプレミスデプロイ#

その他のデータソース#

FAQ#