將 Apidog 專案連接至 AI

Apidog MCP Server 可讓 AI 連接並使用 Apidog 專案中的 API 規格，使 AI 助理能夠產生程式碼、搜尋規格，並加速開發工作流程。

先決條件

在設定 MCP 用戶端之前，請確認你具備：

Node.js（版本 18 或以上，建議使用最新 LTS 版本）

MCP 相容的 IDE：

Cursor

VS Code + Cline 外掛

其他支援 MCP 的編輯器

取得必要憑證

產生 API 存取權杖

開啟 Apidog，並將滑鼠停留在你的個人資料圖片上（右上角）

選擇 Account Settings → API Access Token

Create a new API access token

複製權杖，以取代設定中的 <access-token>

取得 Apidog 專案 ID（選用）

在 Apidog 中開啟你的目標專案

點擊左側邊欄中的 Project Settings

前往 Basic Settings

複製 Project ID，以取代設定中的 <project-id>

複製專案內的 MCP 設定

你可以開啟任何 API，並使用 AI Coding 入口直接複製其 MCP 設定。

在 Cursor 中設定 MCP

開啟 MCP 設定

開啟 Cursor 編輯器

點擊設定圖示（右上角）

從左側選單選擇 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>。

為了清楚起見，請依照 "[Project Name] API Specification" 格式命名每個 MCP Server。

安全性最佳實務

如果你的團隊會將 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

常見問題

我正在使用 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 版本問題

如何讓 AI 讀取更新後 API 規格中的最新資料？

將 Apidog 專案連接至 AI

先決條件#

取得必要憑證#

在 Cursor 中設定 MCP#

重要注意事項#

使用多個專案#

安全性最佳實務#

私有化部署#

其他資料來源#

常見問題#

先決條件

取得必要憑證

在 Cursor 中設定 MCP

重要注意事項

使用多個專案

安全性最佳實務

私有化部署

其他資料來源

常見問題