> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 借助 AI 开发

> 将 Claude、Cursor 等 AI 工具连接到 Blockradar 文档，让它们基于最新文档作答。

让您的 AI 助手或编程智能体直接访问 Blockradar 文档，使其基于最新文档作答，而不是依赖训练时的记忆。共有三种方式：

| 方式                                        | 适用场景                  |
| ----------------------------------------- | --------------------- |
| [MCP 服务器](#连接-mcp-服务器)                    | 在工作过程中查阅文档的编程智能体和 IDE |
| [页面菜单](#就单个页面提问)                          | 就单个页面向 AI 聊天工具提问      |
| [Markdown 与 llms.txt](#以-markdown-格式获取文档) | 脚本、自定义智能体和 RAG 管道     |

## 连接 MCP 服务器

Blockradar 文档 MCP 服务器的地址为：

```text theme={null}
https://docs.blockradar.co/mcp
```

该服务器使用 Streamable HTTP 传输协议，无需 API 密钥。连接后，您的 AI 工具可以：

* **搜索文档**，查找指南、代码示例和 API 参考页面。
* **读取页面和 OpenAPI 规范**，查询准确的端点、参数和响应字段。
* **反馈文档问题**，在页面内容有误或过时时通知 Blockradar 团队。

<Note>
  MCP 服务器仅读取公开文档。它无法访问您的 Blockradar 账户、钱包或交易，也不会调用 Blockradar API。
</Note>

<Tip>
  使用 Cursor 或 VS Code？打开 **复制页面** 旁边的菜单，选择 **连接到Cursor** 或 **连接到VS Code**，即可一键安装服务器。
</Tip>

<Tabs>
  <Tab title="Claude Code">
    在终端中运行以下命令：

    ```bash theme={null}
    claude mcp add --transport http blockradar-docs https://docs.blockradar.co/mcp
    ```

    该命令会将服务器添加到当前项目。如需在所有项目中使用，请在同一命令中加上 `--scope user`。
  </Tab>

  <Tab title="Cursor">
    将服务器添加到项目中的 `.cursor/mcp.json`，或添加到 `~/.cursor/mcp.json` 以在所有项目中使用：

    ```json theme={null}
    {
      "mcpServers": {
        "blockradar-docs": {
          "url": "https://docs.blockradar.co/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code">
    将服务器添加到工作区中的 `.vscode/mcp.json`：

    ```json theme={null}
    {
      "servers": {
        "blockradar-docs": {
          "type": "http",
          "url": "https://docs.blockradar.co/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    在 Claude Desktop 或 claude.ai 中将服务器添加为自定义连接器：

    1. 前往 **Customize > Connectors**。
    2. 点击 **+**，然后点击 **Add custom connector**。
    3. 输入 `https://docs.blockradar.co/mcp` 作为服务器 URL，然后点击 **Add**。

    在 Team 和 Enterprise 套餐中，需由 Owner 先在 **Organization settings > Connectors** 中添加连接器，成员随后可在 **Customize > Connectors** 中连接。
  </Tab>

  <Tab title="Windsurf">
    将服务器添加到 `~/.codeium/windsurf/mcp_config.json`：

    ```json theme={null}
    {
      "mcpServers": {
        "blockradar-docs": {
          "serverUrl": "https://docs.blockradar.co/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>

如需验证连接，可以向助手提一个关于 Blockradar 的问题，例如：*“根据 Blockradar 文档，如何生成充值地址，并在 USDC 到账时收到通知？”* 如果服务器已连接，助手会先搜索 Blockradar 文档再作答。

## 就单个页面提问

每个文档页面的右上角都有一个 **复制页面** 按钮。打开其旁边的菜单可查看更多选项：

| 选项                   | 作用                              |
| -------------------- | ------------------------------- |
| **复制页面**             | 将页面复制为 Markdown，可粘贴到任意 AI 聊天工具中 |
| **以 Markdown 格式查看**  | 以纯 Markdown 格式打开页面              |
| **在 ChatGPT 中打开**    | 以当前页面为上下文发起 ChatGPT 对话          |
| **在 Claude 中打开**     | 以当前页面为上下文发起 Claude 对话           |
| **在 Perplexity 中打开** | 以当前页面为上下文发起 Perplexity 对话       |
| **复制MCP Server**     | 复制 MCP 服务器 URL                  |
| **连接到Cursor**        | 在 Cursor 中安装 MCP 服务器            |
| **连接到VS Code**       | 在 VS Code 中安装 MCP 服务器           |

可用于就某个页面提问、基于 API 参考页面生成代码，或在加载相关页面的情况下排查集成问题。

## 以 Markdown 格式获取文档

对于脚本、自定义智能体和 RAG 管道，可以以纯文本形式加载文档：

| 资源              | URL                                                                                                                     | 用途             |
| --------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------- |
| 任意页面            | 在页面 URL 后加上 `.md`，例如 [`/zh/introduction/build-with-ai.md`](https://docs.blockradar.co/zh/introduction/build-with-ai.md) | 加载单个页面         |
| `llms.txt`      | [docs.blockradar.co/llms.txt](https://docs.blockradar.co/llms.txt)                                                      | 包含文档页面标题和描述的索引 |
| `llms-full.txt` | [docs.blockradar.co/llms-full.txt](https://docs.blockradar.co/llms-full.txt)                                            | 单个文件中的完整文档     |

<Note>
  `llms.txt` 和 `llms-full.txt` 包含的是英文文档。如需加载中文页面，请在其 URL 后加上 `.md`。
</Note>