跳转到主要内容
Square Cloud MCP 服务器让 AI 客户端通过 Model Context Protocol 操作你的账户。用日常语言提出请求，客户端就会替你调用工具：查看状态、日志、指标和边缘流量，读取和编辑文件，管理环境变量，启动和重启应用，创建应用、数据库和 snapshot，等等。
  • 远程运行，无需安装： 所有客户端都使用同一个 HTTPS 地址。
  • 两种连接方式： Claude 和 ChatGPT 在 Square Cloud 授权页面上通过 OAuth 登录。Claude Code、VS Code、Cursor 和其他客户端则发送 API 密钥。
  • 由你的权限决定： 一个连接只能看到其权限范围涵盖的工具，限定到部分应用和数据库的密钥也只能访问这些资源。
  • 由客户端询问，数据安全无忧： 客户端的权限提示决定哪些更改会执行，删除应用或数据库、恢复 snapshot 前都会先创建安全 snapshot。

​
端点

这是 MCP 服务器的唯一地址。在 api.squarecloud.app 或其他任何 Square Cloud 地址上，MCP 请求会返回 421 WRONG_HOST 以及正确的地址。反过来，mcp.squarecloud.app 只提供 MCP 服务器，从不提供 REST API。

​
要求

  • 有效的套餐。 从 Hobby 起，每个 Square Cloud 套餐都包含 MCP 服务器。没有有效套餐时，每个请求都会返回 403 UPGRADE_REQUIRED。如果套餐到期，你的连接会被保留，并在套餐续订后立即恢复工作。
  • 支持远程服务器的 MCP 客户端，通过 Streamable HTTP 连接，例如 Claude、ChatGPT、Claude Code、VS Code 或 Cursor。参见连接客户端。

​
协议

​
MCP 不涵盖的内容

  • 从你的电脑部署文件夹。 MCP 只操作已经在 Square Cloud 上的内容。请使用 CLI、VS Code 扩展或 GitHub 部署上传项目。
  • 下载 snapshot 和数据库证书。 带签名的下载链接会出现在对话中，并到达 AI 模型的提供商手中。请在控制面板中下载。
  • 账户活动。 它会显示你账户的 IP 地址和设备，因此只保留在控制面板中。
  • 机密值。 环境变量的值、.env 文件和私钥永远不会到达 AI 客户端。参见机密信息。
  • 账户设置、账单、API 密钥和 workspace 成员。 这些都在控制面板中管理。

​
后续步骤

连接客户端

设置 Claude、ChatGPT、Claude Code、VS Code 或 Cursor。

权限与安全

权限范围、受限密钥和安全 snapshot。

工具

所有工具及其所需的权限范围。

限制与错误

请求和工具的限制，以及每个错误的含义。