使用 AI 开发

AI 助手的回答质量取决于它掌握的信息。当您向通用 AI 助手询问 VelaFi API 时，它可能会猜测接口路径、字段名或状态码。VelaFi MCP 服务器让您的 AI 助手以只读方式直接访问本文档，在回答问题或编写代码之前先查阅最新页面。

MCP 服务器的作用

Model Context Protocol（MCP）是一项开放标准，让 AI 工具可以连接外部数据源。通过 VelaFi 文档 MCP 服务器，AI 助手可以：

带来的好处：

MCP 服务器只读取本站公开的文档。它无法访问您的 VelaFi 账户、调用 VelaFi API 或转移资金，也不需要 API 密钥或登录。切勿将您的 API secret 或令牌粘贴到 AI 对话中。

https://docs.velafi.com/mcp

在网页版 Claude 或 Claude 桌面应用中：

并非所有 Claude 套餐都提供自定义连接器，组织管理员也可能限制该功能。

运行：

claude mcp add --transport http velafi-docs https://docs.velafi.com/mcp

在 Claude Code 中运行 /mcp，确认服务器已连接。

在提供该功能的套餐中，ChatGPT 可通过开发者模式（developer mode）使用自定义 MCP 连接器：

ChatGPT 更新界面后菜单名称可能会变化。如果找不到这些选项，请在 OpenAI 帮助中心搜索 “developer mode” 和 “MCP connectors”。

打开命令面板，运行 Open MCP settings，选择 Add custom MCP 并添加：

~/.cursor/mcp.json

{
  "mcpServers": {
    "velafi-docs": {
      "url": "https://docs.velafi.com/mcp"
    }
  }
}

在项目的 .vscode/mcp.json 中添加该服务器：

.vscode/mcp.json

{
  "servers": {
    "velafi-docs": {
      "type": "http",
      "url": "https://docs.velafi.com/mcp"
    }
  }
}

然后在 GitHub Copilot Chat 的 agent 模式中使用。

将该服务器添加到 Windsurf 的 MCP 配置中：

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "velafi-docs": {
      "serverUrl": "https://docs.velafi.com/mcp"
    }
  }
}

运行：

codex mcp add velafi-docs --url https://docs.velafi.com/mcp

其他支持通过 HTTP 连接远程 MCP 服务器的工具，也可以使用同一个 URL 连接。

连接后，可以向助手提问，例如：

在生产环境使用之前，请务必检查生成的代码，并先在沙盒环境中测试。

如果不只是查阅文档，还可以安装 VelaFi Agent Skills。它们为助手提供每个核心使用场景的分步指令、规则和自检脚本。

Markdown 页面：在任意页面 URL 后加上 .md，即可获得纯 Markdown 版本，例如 https://docs.velafi.com/docs/quickstart.md。
页面菜单：使用任意页面顶部的菜单，可以将页面复制为 Markdown、在 ChatGPT 或 Claude 中打开、复制 MCP 服务器 URL，或一键将 MCP 服务器连接到 Cursor 或 VS Code。
llms.txt：/llms.txt 列出所有页面及简短说明，/llms-full.txt 在一个文件中包含文档全文。