借助 AI 进行开发

本指南说明开发者如何将兼容 MCP 的 IDE（Cursor / VS Code + Cline）连接到 Cobre 的公开 API 文档，从而使 IDE 的 AI 智能体能够读取 OpenAPI Specification（OAS）并生成准确的代码、DTO、文档等内容。

您将获得什么（为何重要）

配置 MCP 后，您的 AI IDE 可以拉取与 Cobre 文档中相同的 API 详情，并利用这些信息：

生成客户端代码（SDK 片段、服务类、控制器）

根据 schema 创建或扩展 DTO/模型

添加字段级文档注释

搜索 endpoint、参数和错误响应

为特定 endpoint（鉴权、payouts、webhooks 等）搭建完整流程

前提条件

开始配置前，请确认：

Node.js 18+（推荐最新 LTS）

兼容 MCP 的 IDE，例如：

Cursor

VS Code + Cline

任何支持 MCP 的编辑器

可运行 npx 的网络访问（必须能访问 npm 仓库）

第 1 步 — 添加 Cobre 的 MCP 服务器配置

在 IDE 中添加如下 MCP 配置：

{
  "mcpServers": {
    " - Cobre API Documentation": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=760877"
      ]
    }
  }
}

该配置使用 Published Documentation 数据源，并通过 site-id=760877 直接指向 Cobre 的公开 API 文档。无需 token。

Cursor 配置（快捷路径）

打开 Cursor

前往 Settings → MCP

点击 Add new global MCP server

将 JSON 粘贴到生成的 mcp.json

保存，必要时重启

用一条简单提示词测试 MCP

VS Code + Cline 配置（快捷路径）

安装并启用 Cline 插件

找到 MCP 配置

添加相同的 mcpServers JSON

必要时重新加载 VS Code

用基于 MCP 的提示词测试

第 2 步 — 验证 MCP 是否可用

在 IDE 的 AI agent 模式中尝试：

基本连通性测试

“Please fetch API documentation via MCP and tell me how many endpoints exist.”

基于 endpoint 的开发

“Using MCP, generate example requests and responses for /v1/... and produce a typed TypeScript client method.”

DTO / schema 生成

“Use MCP to generate Java/Kotlin/TypeScript models for the schemas used by <endpoint>.”

Schema 同步 / 重构

“Compare the current DTO in this repository with the MCP schema and add any missing fields with documentation comments.”

强烈建议：将 MCP 与 Cobre 的 LLM 文档索引结合使用

若需要更广的集成指引（流程、说明、集成步骤），还可以让 AI 阅读：

https://docs.cobre.com/llms.txt

这会提供 Markdown 格式的结构化文档导航。

最佳实践：

用 llms.txt 做概念理解与流程设计。

用 MCP 做精确的 OpenAPI schema 校验（字段、枚举、必填参数、错误码）。

更多信息见：将 Cobre 文档接入 AI

结合两者的提示词示例：

“Usign the MCP and the llms.txt in https://docs.cobre.com/llms.txt with the extended Cobre's documentation, create a flow to demostrate how to send a payment to a Bre-B key.”

刷新缓存的 API 规范

MCP 配置会为性能在本地缓存规范。若 Cobre 更新了文档，您可能需要让 AI 刷新/重新加载 MCP。

若您认为文档已变更（新字段、枚举更新、参数变更）：

请向 IDE 发出：

“Refresh MCP and reload the latest API specification.”

由于 MCP 在本地缓存规范，刷新可确保您使用的是最新版本。

常见问题排查

Windows 上的 `npx` 问题

若 Windows 无法执行默认配置，请使用：

{
  "mcpServers": {
    " - Cobre API Documentation": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=760877"
      ]
    }
  }
}

公司网络限制

确保开发环境可以访问：

www.npmjs.com

若位于防火墙后，可能需要配置 npm 代理。

返回过时字段

若 schema 看起来过时：

让 AI 刷新 MCP

必要时重启 IDE

重试请求

对团队高价值的用例

让 DTO 与持续演进的 API 规范保持同步

生成强类型 SDK 层

自动为后端模型添加文档

减少因过时字段导致的集成错误

加快新开发者上手

借助 AI 进行开发

您将获得什么（为何重要）#

前提条件#

第 1 步 — 添加 Cobre 的 MCP 服务器配置#

Cursor 配置（快捷路径）#

VS Code + Cline 配置（快捷路径）#

第 2 步 — 验证 MCP 是否可用#

基本连通性测试#

基于 endpoint 的开发#

DTO / schema 生成#

Schema 同步 / 重构#

强烈建议：将 MCP 与 Cobre 的 LLM 文档索引结合使用#

刷新缓存的 API 规范#

常见问题排查#

Windows 上的 npx 问题#

公司网络限制#

返回过时字段#

推荐的 Cobre 集成“黄金流程”#

对团队高价值的用例#