将 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

创建新的 API 访问令牌

复制该令牌，用于替换配置中的 <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

重要说明

使用多个项目

安全最佳实践

私有化部署

其他数据源

常见问题