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

# MCP 集成

> 通过 Model Context Protocol 将 AI 助手连接到 Nonce

Nonce 提供 [MCP](https://modelcontextprotocol.io/) server，让 AI 助手通过自然语言管理你的矿场运营。

## Nonce MCP 如何工作

AI 客户端完成 OAuth 授权后，通过 Nonce MCP 调用 Public API v2。可访问的 workspace 和 farm 由当前账号的权限决定。

![MCP clients connect to Nonce MCP, which calls Public API v2.](https://mintcdn.com/nonce/b9KVJ-OYoCYG9adE/images/api/nonce-mcp-flow-light.svg?fit=max\&auto=format\&n=b9KVJ-OYoCYG9adE\&q=85\&s=987a670004ded0884af38284c392adc1)

## Server URL

```
https://mcp.nonce.app/mcp
```

## 从 AI 客户端连接

**Claude**

1. 打开 **Settings** > **Connectors**
2. 点击 **Add custom connector**
3. 输入 server URL：`https://mcp.nonce.app/mcp`
4. 点击 **Add** 完成添加
5. 在对话中通过 **+** > **Connectors** 启用，并按提示完成 OAuth 登录

> [!NOTE]
>
> Team / Enterprise 工作区需由 Owner 在 **Organization settings** > **Connectors** 中添加，成员再连接。

**ChatGPT**

1. 打开 **Settings** > **Connectors**，点击 **Create**
2. 填写 connector 名称、描述，URL 填入：`https://mcp.nonce.app/mcp`
3. 点击 **Create**，确认工具列表加载成功
4. 新对话中点击 **+** > **More**，选择 Nonce connector，并按提示完成 OAuth 登录

> [!NOTE]
>
> 自定义 MCP 需在 **Settings** > **Connectors** 中启用 **Developer mode**；具备写入能力的完整 MCP 仅 Business / Enterprise / Education 工作区可用。

## 认证

首次连接时，你会被引导登录 Nonce 账号。授权完成后，MCP 客户端会自动管理 token。

> [!NOTE]
>
> MCP 使用与 Nonce 网页端相同的账号和权限。详见「[角色与权限](https://docs.nonce.app/zh/user-guide/permissions/index.md)」了解各角色的访问范围。

## 你可以做什么

连接后，AI 助手可以：

* **查询** 矿场和矿机的实时状态
* **监控** 算力、温度和矿池配置变更
* **执行** 批量操作（如重启矿机）
* **追踪** 任务执行历史和结果

完整工具列表见「[可用工具](https://docs.nonce.app/zh/api-guide/mcp/tools.md)」。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.