服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 这是 Cloudways 7月16日发布的 MCP v1.2 迁移安排，当前到了公告日期；不能把它写成今天新上线或所有 Cloudways API key 同时停用。
- READ 用于查询，Full Access 包含修改与删除，Limited Scope 只开放选定端点或端点组。按实际任务选权限。
- 新配置使用 X-Access-Token 和 X-Mcp-Host；只重新生成旧 API key，不能替代这次认证迁移。
- 保存配置后重新连接 MCP 客户端，检查连接状态与获准工具。客户端显示已连接，不代表所有操作都已授权或执行成功。
截止日期说到哪一步？
Cloudways 在2026年7月16日的 MCP v1.2 公告中说，旧 API key 将在10月14日之后停止工作。帮助中心前置条件写的是10月15日前弃用，并提示改用 X-Access-Token。这两种表述都指向应尽快完成的 MCP 认证迁移，未提供精确截止钟点或时区。
这里讨论的是 Cloudways MCP 的旧认证方式，不是宣布整个 Cloudways API 的所有密钥都作废。公开说明也不能证明某个账户此刻已经被切断；不要因为暂时还能连上，就把旧密钥当成长久可用的方案。
只查状态，先选 READ
Access Token 是可以限定权限的访问令牌。READ 允许查询和返回信息；Full Access 还允许修改甚至删除资源；Limited Scope 将能力限制在选定端点或端点组。需要变更时，应先确认具体动作，再决定是否增加对应权限。
举个尚未执行的假设例子：团队只想问哪些应用部署在服务器上，可以先使用 READ。若后来需要调整设置，应先核对具体工具和目标，再另行安排所需权限；不用为了让工具列表看起来齐全就授予完整访问。只读也不代表账户信息可以公开分享。
先在账户中准备新令牌
第一步，使用自己有权管理的 Cloudways 账户，进入原 API key 所在的账户区域，查找 Access Token 入口。按实际任务选择 READ 或有限范围，保存新令牌。公告没有给出当前新入口的完整按钮路径，不能直接把旧教程的 Regenerate API Key 当成创建新令牌。
第二步，找到当前客户端已经使用的 Cloudways MCP 条目，确认要替换的是它的认证配置。令牌应只填入你控制的客户端凭据位置，不要粘贴到聊天、截图或公开代码中；也不要把旧 key 改个字段名就当作新 token。
按客户端格式替换请求头
官方新配置的服务端点为 https://mcp.cloudways.com/mcp/，末尾斜线保留。认证使用 X-Access-Token，X-Mcp-Host 标明实际客户端；这些字段替换的是 MCP 连接的认证信息，不要求重启 Cloudways 服务器。
以 Cursor 原生 HTTP 配置为例，官方路径是 ~/.cursor/mcp.json。保留已有其他条目，在 mcpServers 下找到 cloudways：url 使用上述端点，headers 中的 X-Access-Token 填新令牌，X-Mcp-Host 填 cursor，保存有效 JSON。
其他客户端请使用帮助中心各自的示例，不能把 Cursor 的整个结构直接套过去。例如 VS Code 使用 servers 和 type:http，Gemini CLI 使用 httpUrl；字段名与传输方式需要对应。完整配置见来源中的官方设置文档。
重新连接的是客户端，不是业务服务
保存后，在 MCP 客户端设置中把 Cloudways 条目关闭再开启；没有开关时，完全退出客户端再重开。只关闭一个窗口可能没有退出常驻程序。这个步骤刷新连接和工具缓存，不是执行 server_restart 或 service_restart。
随后查看客户端中的连接状态和工具发现结果。Cursor 示例以绿色指示点确认连接；实际可用动作仍取决于令牌范围。如果要核对结果，只选择自己已获授权的查询，并把返回对象与预期账户、服务器或应用对应。
哪些工具不能拿来试连接？
官方工具目录区分了查询与变更：server_list 用于列出服务器，service_status 查询服务；server_delete 会永久删除服务器及数据，service_restart 会重启服务。不要用重启、删除或扩容来证明新认证“完全可用”。
迁移后先确认连接，再确认所需查询可用；将部署、服务修改和删除留给另行授权的操作。工具目录描述的是能力，不是你已经执行了这些动作，也不是迁移后业务结果的保证。
资料来源
常见问题
帮助中心为什么还有邮箱加 API key 的例子？
当前设置文档同时保留旧步骤和 FAQ，但 Required Headers 与新客户端示例已经使用 X-Access-Token。迁移时应对照新配置；遇到入口与文档不一致，向 Cloudways 支持确认，不应再用旧 key 方案作为长期替代。
新工具没有全部显示，就说明令牌无效吗？
不一定。公告说明工具可通过动态发现提供，客户端也可能缓存旧工具列表。先检查连接和重新加载结果，再核对所需工具及令牌范围；不能仅凭显示数量判断认证失败或扩大权限。
出现401，就应该重新生成所有账户密钥吗？
先核对当前 Cloudways MCP 条目是否采用新 token、请求头是否准确、配置是否保存并重新加载。401本身不能证明账户所有密钥都失效，也不能据此确认公告已对你的账户强制执行。
新令牌连接失败，可以长期切回旧配置吗？
公告已给出旧认证的停用安排，不能把旧配置仍能连接当成继续支持的承诺。先保留不含令牌值的错误记录，核对新配置；账户中找不到新入口或仍无法连接时，向 Cloudways 支持确认，不要为了恢复连接扩大令牌权限。