开始之前
您需要一台使用 systemd 的 Linux amd64 或 arm64 服务器、一个由您控制的管理通道,以及出站 HTTPS 访问权限。您的 ChatGPT 账户和工作区必须允许自定义 MCP 连接。本指南使用直接连接,无需在 Directory 上架。
安装程序要求明确同意授予管理权限。之后,已连接的 AI 可以使用代理的 root 权限执行操作。请检查每条安装命令,并且只使用您获准管理的服务器。
创建您的 OpsTether 账户
打开控制台,选择 Sign in or create an account。选择 Register,然后设置用户名和至少 12 个字符的密码。电子邮箱为可选项。请妥善保管登录信息:目前不支持通过电子邮件找回密码。
配对 Linux 服务器
- 在控制台中选择 Connect server。
- 检查生成的安装命令及其 root 权限确认说明。
- 在服务器终端中运行该命令。
- 返回控制台,选择 Refresh,并确认正确的服务器处于在线状态。
安装命令包含短期有效的配对凭据。请勿公开。如果在安装前过期,请生成新命令。
将 OpsTether 添加到 ChatGPT
在 ChatGPT 网页版中,打开 Plugins → + → Add custom MCP server。填写以下设置。不同客户端版本中的字段名称可能有所不同。
| 设置 | 值 |
|---|---|
| 名称 | OpsTether |
| 服务器 URL | https://opstether.m2g.pro/mcp |
| 身份验证 | OAuth |
| OAuth 客户端 ID | opstether-chatgpt |
| OAuth 客户端密钥 | 留空。这是公开 OAuth 客户端。 |
| 权限范围(如需填写) | openid profile email opstether:admin |
选择使用现有或已提供 OAuth 客户端的选项。阅读访问权限说明,然后选择 Create as a plugin。使用与控制台相同的 OpsTether 账户登录,并检查请求的权限。使用前,请先安装生成的插件。
高级 OAuth 设置及其他客户端
连接使用 Authorization Code 授权码流程、PKCE S256,以及 none 令牌端点身份验证方式。自动客户端注册已禁用。其他客户端或不同的回调 URL 需要由服务运营人员单独注册。
- 资源 / 受众
https://opstether.m2g.pro/mcp- 已注册的回调地址
https://chatgpt.com/connector_platform_oauth_redirect
如果客户端要求密钥或显示其他回调地址,请向支持人员提供客户端名称和回调 URL。请勿发送凭据。
检查首次连接
新建对话,选择 @OpsTether,并请求列出已连接的服务器。确认返回的服务器名称后,再请求查看系统资源使用情况。
列出我已连接的服务器,并显示哪些处于在线状态。
显示这台服务器的 CPU、内存和磁盘使用情况。
您还可以查看进程、systemd 服务状态和日志、Docker 容器及文件。授权更改时,请使用 AI 客户端的审核控制。
连接故障排查
没有服务器
确认控制台和 AI 客户端使用同一个 OpsTether 账户。
服务器离线
检查目标主机上的代理及其出站 HTTPS 连接,然后刷新控制台。
安装命令已过期
在控制台中创建新命令。
OAuth 连接错误
明确填写上方的客户端 ID,并将密钥留空。不要依赖自动客户端注册。
自定义 MCP 选项不可用
向您的 AI 提供商确认账户和工作区权限。OpsTether 无法更改这些权限。
账户、工作区和提供商的可用性规则均适用。本指南中的产品菜单名称采用英文界面中的名称。