写代码不用切窗口！用 MCP 协议把企业 API 资产接到 Cursor

随着 Cursor、Claude Code、VS Code + Cline 等 AI 辅助编程工具的普及，越来越多的开发者开始习惯让 AI 助手帮忙编写业务代码、生成控制器 (Controller) 与数据传输对象 (DTO)。

然而，在使用 AI 编程时，绝大多数研发团队都会遇到一个非常低效的体验痛点：AI 缺乏企业内部最新的 API 接口文档上下文。

每次想让 AI 编写一个对接业务接口的代码时，开发者都不得不做一系列繁琐的操作：

切出 IDE 窗口，打开浏览器里的 API 协作平台；
搜索找到具体的接口页面，手动复制请求参数、响应 JSON 和字段注释；
切回 Cursor 窗口，把长篇大论的接口文档黏贴给 AI，再输入 Prompt 让其生成代码。

这种频繁切窗口、手工复制粘贴的过程，不仅极大地打断了开发思路，而且只要接口发生微小变动，手头的代码就容易与真实文档脱节。

有没有办法让 Cursor 或 AI Agent 直接安全地读取企业内部的 API 资产，实现“边看最新文档边写代码”？

答案就是利用 Apifox 的 MCP (Model Context Protocol) 架构。在私有化部署环境下，通过配置 Apifox MCP Server，即可无缝将内网 API Hub 与 AI 编辑器打通。 本文将为您详细拆解其技术原理与配置步骤。

AI Coding 交流群

如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。

一、什么是 MCP 协议与 Apifox MCP Server？

MCP (Model Context Protocol，模型上下文协议) 是由 Anthropic 等领军 AI 机构发起的一套开放标准。它允许 AI 编辑器（如 Cursor）以标准化、安全的方式，向外部上下文数据源（如企业 API 接口文档、数据库、知识库）发起查询。

┌────────────────────────────────────────────────────────────────────────┐
│                   Apifox 私有化 MCP 架构示意图                         │
│                                                                        │
│   ┌────────────────────────────────────────────────────────┐           │
│   │    开发者本地 IDE (Cursor / VS Code + Cline 插件)     │           │
│   └──────────────────────────▲─────────────────────────────┘           │
│                              │ 本地通过 MCP 协议发起查询                │
│                              │                                         │
│   ┌──────────────────────────┴─────────────────────────────┐           │
│   │           Apifox MCP Server (本地中间件服务)           │           │
│   │  配置参数: --apifox-api-base-url=<私有化服务器内网地址> │           │
│   └──────────────────────────┬─────────────────────────────┘           │
│                              │                                         │
│                              ▼ 纯内网加密读取                          │
│   ┌────────────────────────────────────────────────────────┐           │
│   │         Apifox 私有化部署服务器 & 内网 API Hub         │           │
│   └────────────────────────────────────────────────────────┘           │
│                                                                        │
└────────────────────────────────────────────────────────────────────────┘

Apifox MCP Server 正是 Apifox 官方推出的 MCP 服务端工具。完成配置后，Apifox MCP Server 会安全获取团队内部 API 文档的结构化数据并缓存在本地。AI 编辑器（如 Cursor）在接收到开发者指令时，可以通过 MCP 直接读取最新的接口定义、数据模型 (Schemas) 以及字段注释，从而生成 100% 精确匹配业务规范的代码。

二、私有化部署环境下的 MCP 配置实战

对于使用 Apifox 私有化部署的企业团队，由于服务部署在公司内网或专有云环境，所有 MCP 请求必须指回企业自己的私有服务器，保障数据不外流。

1. 前置条件准备

Node.js 环境：开发机或内网环境已安装 Node.js (建议版本号 >= 18 LTS)；
支持 MCP 的 IDE：Cursor、VS Code (配合 Cline 插件) 或 Claude Code；
Apifox 个人访问令牌 (Personal Access Token)：在 Apifox 私有化 Web 门户的“个人设置 - 账号设置 - 个人访问令牌”中生成。

2. 在 Cursor 中配置私有化 MCP Server

打开 Cursor 的 Settings -> Features -> MCP，点击 Add New MCP Server，填入以下参数：

Name: apifox-private
Type: command
Command: npx -y apifox-mcp-server@latest --apifox-api-base-url=http://<贵公司内网Apifox服务器地址> --access-token=<您的个人Token>

{
  "mcpServers": {
    "apifox-private": {
      "command": "npx",
      "args": [
        "-y",
        "apifox-mcp-server@latest",
        "--apifox-api-base-url=http://apifox.your-company-domain.com",
        "--access-token=APS-xxxxxxxxx"
      ]
    }
  }
}

注意：通过指定 --apifox-api-base-url 参数，所有的接口查询请求均纯粹在企业内网通信，确保核心接口资产与 Token 数据不出域。

三、 MCP 赋能下的四大高效日常开发场景

配置完成后，开发者在 Cursor 中无需切出窗口，直接用大白话向 AI 发送指令即可：

场景 1：自动生成控制器与模型定义代码

开发者指令：“通过 MCP 获取项目内 /user/profile 相关的 API 文档，直接在当前 Go 项目中生成相应的 DTO 结构体与 Handler 框架代码。”

AI 表现：自动调用 MCP 找到 API 文档，提取请求参数与响应数据结构，一键生成无语法错误的对应语言模型，且自动附带接口中的中文注释。

场景 2：接口字段变更时的代码同步补充

开发者指令：“根据 API 文档，查看 Order 模块新增了哪几个字段，并自动补充到当前的 OrderDTO 类中。”

AI 表现：自动读取 Apifox 内最新的数据模型快照，识别出新增的字段，并在现有代码中增量追加。

场景 3：根据接口定义自动补全单单元测试

开发者指令：“读取 /payment/checkout 接口文档中的字段约束与校验规则，为当前的 Service 编写全面的单元测试用例。”

AI 表现：读取 Schema 中的强类型限制（如必填项、正则表达式、最大最小值），生成覆盖边界情况的单元测试逻辑。

场景 4：搜索与理解复杂内网接口

开发者指令：“在企业 API Hub 中搜索处理退款逻辑的所有接口，并总结其调用顺序。”

AI 表现：快速在内网全量 API 资产库中进行语义检索，梳理出接口依赖链条。

四、内网安全与数据隐私保障

许多企业安全团队担心：将 API 文档暴露给 AI 会不会导致数据泄露？Apifox 私有化 MCP 架构提供了三重安全屏障：

内网基座隔离：私有化环境下，MCP 访问的 Endpoint 纯粹是指向企业机房内部的服务器，不经过任何外部节点；
访问控制与 Token 鉴权：读取接口数据时严格透传开发者个人的访问令牌，开发者在 Apifox 中看不到的项目，在 Cursor 中也无法通过 MCP 查询；
敏感凭证防泄密处理：自动屏蔽项目中的敏感授权 Key，测试环境鉴权参数在客户端本地加密，确保 AI 上下文安全。