跳到主内容
网连网络
文档

通过 AI Agent 使用网连网络

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

连接 MCP 服务

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

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

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

让 Agent 注册或登录

告知 Agent 注册新账号或登录已有账号。注册时提供用户名、密码和手机号,完成短信验证;已开启两步验证时,还需完成动态码验证。规则见注册登录和账号。

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

描述任务并核对结果

从具体任务开始,例如:

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

接入完成后,让 Agent 核对目标设备已批准且在线,再测试设备间的实际连接。控制台中的同类验证步骤见快速上手。

到网站充值

让 Agent 提供充值链接,在网站完成支付;支付后再让它查询到账余额。MCP 不创建充值订单,也不发起支付。操作见账单。

客户端开发接入

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

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

故障速查

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