Apidog プロジェクトを AI に接続する

Apidog MCP Server により、AI は Apidog プロジェクト内の API 仕様に接続して利用できるようになります。これにより、AI アシスタントはコード生成、仕様の検索、開発ワークフローの高速化を行えます。

前提条件

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

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

MCP 対応 IDE:

Cursor

VS Code + Cline plugin

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

必要な認証情報の取得

API アクセストークンを生成する

Apidog を開き、プロフィール画像（右上）にカーソルを合わせます

Account Settings → API Access Token を選択します

新しい API アクセストークンを作成します

トークンをコピーし、設定内の <access-token> を置き換えます

Apidog プロジェクト ID を取得する（任意）

Apidog で対象プロジェクトを開きます

左サイドバーの Project Settings をクリックします

Basic Settings に移動します

Project ID をコピーし、設定内の <project-id> を置き換えます

プロジェクト内で MCP 設定をコピーする

任意の API を開き、AI Coding エントリを使用して、その MCP 設定を直接コピーできます。

Cursor で MCP を設定する

MCP 設定を開く

Cursor editor を開きます

設定アイコン（右上）をクリックします

左メニューから MCP を選択します

+ Add new global MCP server をクリックします

設定を追加する

開いた mcp.json ファイルに以下の設定を貼り付けます。<access-token> と <project-id> を実際の値に置き換えてください。

macOS / Linux

Windows

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project-id=<project-id>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}

設定を検証する

AI（Agent モード）に次のように依頼して、接続をテストします。

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

AI が Apidog プロジェクトの API 情報を返した場合、接続は成功です。

重要な注意事項

<access-token> と <project-id> を、ご自身の Apidog API アクセストークンおよびプロジェクト ID に置き換えてください。

複数プロジェクトの操作

複数のプロジェクトの API 仕様を扱うには、設定ファイルに複数の MCP Server 設定を追加します。各プロジェクトには、それぞれ固有の <project-id> が必要です。

分かりやすくするために、各 MCP Server には "[Project Name] API Specification" という形式で名前を付けてください。

セキュリティのベストプラクティス

チームで MCP 設定ファイルをコードリポジトリに同期する場合は、次の対応を行ってください。

設定から "APIDOG_ACCESS_TOKEN": "<access-token>" の行を削除します

各チームメンバーのマシンで APIDOG_ACCESS_TOKEN を環境変数として設定します

これにより、バージョン管理におけるトークン漏えいを防止できます。

オンプレミスデプロイ

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

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project-id=<project-id>",
        "--apidog-api-base-url=<your-server-url>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}

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

その他のデータソース

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

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

FAQ

Apidog Europe を使用しています。MCP サーバーの起動時に特別な設定は必要ですか？

はい。Apidog Europe を使用している場合は、パラメータ --apidog-api-base-url を追加し、EU API エンドポイントに設定する必要があります。

以下は設定例です。

"Pet Store- Apidog": {
  "command": "npx",
  "args": [
    "-y",
    "apidog-mcp-server@latest",
    "--project-id=xxx",
    "--apidog-api-base-url=https://api.eu.apidog.com"
  ],
  "env": {
    "APIDOG_ACCESS_TOKEN": "xxx"
  }
}

Windows の設定に関する問題

Node.js バージョンの問題

更新された API 仕様から AI に最新データを読み取らせるにはどうすればよいですか？

Apidog プロジェクトを AI に接続する

前提条件#

必要な認証情報の取得#

Cursor で MCP を設定する#

重要な注意事項#

複数プロジェクトの操作#

セキュリティのベストプラクティス#

オンプレミスデプロイ#

その他のデータソース#

FAQ#

前提条件

必要な認証情報の取得

Cursor で MCP を設定する

重要な注意事項

複数プロジェクトの操作

セキュリティのベストプラクティス

オンプレミスデプロイ

その他のデータソース

FAQ