# 通过 AI Agent 使用网连网络

> 连接 MCP，让 Agent 通过对话完成注册、设备接入和网络管理；充值在网站完成。

来源: https://www.widewired.com.cn/page/docs/agent

## 连接 MCP 服务

在支持 Streamable HTTP MCP 的 Agent 应用中，添加本站入口：

```json
{"mcpServers":{"widewired":{"url":"https://www-api.widewired.com.cn/mcp"}}}
```

Agent 应用需要支持私密保存账号凭据，并为后续调用提供认证信息。

## 让 Agent 注册或登录

告知 Agent 注册新账号或登录已有账号。注册时提供用户名、密码和手机号，完成短信验证；已开启两步验证时，还需完成动态码验证。规则见[注册登录](https://www.widewired.com.cn/page/docs/signup)和[账号](https://www.widewired.com.cn/page/docs/account-security)。

密码和验证码只在可信 Agent 应用的私密输入中填写，不要在共享对话中公开凭据或完整登录结果。账号的权限、设备数量限制、奖励和计费规则与控制台使用相同。

## 描述任务并核对结果

从具体任务开始，例如：

- “为我的电脑和服务器创建一个网络，并指导我接入这两台设备。”
- “列出待审批设备，批准前先让我确认。”
- “检查这两台设备的链路，解释最近的丢包情况。”
- “查看本月用量和可用余额。”
- “查找最近的配置变更，并帮我联系支持。”

同意修改前，核对所选网络和受影响设备。删除资源或运行安装命令前，要求 Agent 征得确认。每台设备的安装仍需要本机权限，电脑上的 Agent 不能代替用户授予手机 VPN 权限。

接入完成后，让 Agent 核对目标设备已批准且在线，再测试设备间的实际连接。控制台中的同类验证步骤见[快速上手](https://www.widewired.com.cn/page/docs/quickstart)。

## 到网站充值

让 Agent 提供充值链接，在网站完成支付；支付后再让它查询到账余额。MCP 不创建充值订单，也不发起支付。操作见[账单](https://www.widewired.com.cn/page/docs/billing)。

## 客户端开发接入

可用工具为 `search_operations`、`describe_operation`、`call_operation` 和 `recharge`。先按用户任务搜索，再查看操作字段和前提，最后按用户决定调用。

自行接入时，使用本站[操作目录](https://www-api.widewired.com.cn/agent/v1/operations)和 [OpenAPI](https://www-api.widewired.com.cn/agent/v1/openapi.json)。HTTP 客户端在每次请求的 `Authorization: Bearer ...` 中携带账号访问凭据，或将其私密传入 `call_operation`。注册、部分登录场景及密码重置需要客户端完成人机校验挑战，按操作描述实现，不要交给远端 MCP 服务求解。认证结果应私密保存。通过 MCP 提交支持附件时，支持最大 8 MiB 的 base64 文件。

## 故障速查

| 现象 | 处理 |
| --- | --- |
| 后续调用无法认证 | 确认 Agent 应用支持私密保存账号凭据，并能为 MCP 调用携带认证信息 |
| 注册后无法登录 | 完成短信验证，并核对用户名或手机号及密码 |
| 操作要求重新认证 | 完成要求的密码或动态码验证后再继续 |
| 设备一直待审批 | 核对设备身份，批准后检查连接状态 |
| 支付后余额未变化 | 核对网页中的充值记录和到账余额，不要重复下单 |