> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Square Cloud MCP 服务器

> 通过远程 MCP 服务器将 Claude、ChatGPT、Claude Code、VS Code 或 Cursor 连接到你的 Square Cloud 账户，在聊天中管理应用和数据库。

Square Cloud MCP 服务器让 AI 客户端通过 [Model Context Protocol](https://modelcontextprotocol.io) 操作你的账户。用日常语言提出请求，客户端就会替你调用[工具](https://docs.squarecloud.app/zh/mcp/tools.md)：查看状态、日志、指标和边缘流量，读取和编辑文件，管理环境变量，启动和重启应用，创建应用、数据库和 snapshot，等等。

* **远程运行，无需安装：** 所有客户端都使用同一个 HTTPS 地址。
* **两种连接方式：** Claude 和 ChatGPT 在 Square Cloud 授权页面上通过 OAuth 登录。Claude Code、VS Code、Cursor 和其他客户端则发送 API 密钥。
* **由你的权限决定：** 一个连接只能看到其权限范围涵盖的工具，限定到部分应用和数据库的密钥也只能访问这些资源。
* **由客户端询问，数据安全无忧：** 客户端的权限提示决定哪些更改会执行，删除应用或数据库、恢复 snapshot 前都会先创建安全 snapshot。

## 端点

```text theme={"system"}
https://mcp.squarecloud.app/mcp
```

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

## 要求

* **有效的[套餐](https://docs.squarecloud.app/zh/platform/plans.md)。** 从 Hobby 起，每个 Square Cloud 套餐都包含 MCP 服务器。没有有效套餐时，每个请求都会返回 `403 UPGRADE_REQUIRED`。如果套餐到期，你的连接会被保留，并在套餐续订后立即恢复工作。
* **支持远程服务器的 MCP 客户端**，通过 Streamable HTTP 连接，例如 Claude、ChatGPT、Claude Code、VS Code 或 Cursor。参见[连接客户端](https://docs.squarecloud.app/zh/mcp/connect.md)。

## 协议

| 主题 | 详情 |
| - | - |
| 传输方式 | Streamable HTTP，仅限 `POST`。服务器不保留会话，`GET` 会返回 `405`。 |
| 协议版本 | `2026-07-28`、`2025-11-25`、`2025-06-18` 和 `2025-03-26`。`2026-07-28` 修订版的客户端无需握手即可调用；较旧的客户端先发送 `initialize`。没有 `MCP-Protocol-Version` 的请求会按 `2025-03-26` 处理，不受支持的版本会返回 `400` 以及受支持的版本列表。 |
| 能力 | 仅提供工具，不提供资源或提示。 |
| 结果 | 每个工具以文本块的形式返回一个 JSON 对象，包含 `ok`、`summary`，并在出现失败或需要你处理时包含 `code`。 |
| 长时间调用 | 耗时超过几秒的调用会以流（SSE）的形式返回，并发送保活信号。关闭连接会取消调用，且任何调用的运行时间都不会超过 3 分钟。 |

## MCP 不涵盖的内容

* **超过 1 MB 的项目。** 客户端可以把你电脑上的项目作为最大 1 MB 的 zip 发送：新应用使用 `upload_application`，新版本使用 `commit_application`；文本文件可以通过 `create_application` 和 `commit_application` 发送。较大的项目请使用 [CLI](https://docs.squarecloud.app/zh/cli-reference/deploy.md)、[VS Code 扩展](https://docs.squarecloud.app/zh/vscode-extension/features.md)或 [GitHub 部署](https://docs.squarecloud.app/zh/cli-reference/github-deploys.md)。
* **下载 snapshot 和数据库证书。** 带签名的下载链接会出现在对话中，并到达 AI 模型的提供商手中。请在控制面板中下载。
* **账户活动。** 它会显示你账户的 IP 地址和设备，因此只保留在控制面板中。
* **机密值。** 环境变量的值、`.env` 文件和私钥永远不会到达 AI 客户端。参见[机密信息](https://docs.squarecloud.app/zh/mcp/permissions-and-safety.md#机密信息)。
* **账户设置、账单、API 密钥和 workspace 成员。** 这些都在控制面板中管理。

## 后续步骤

> [card] [连接客户端](https://docs.squarecloud.app/zh/mcp/connect.md)
>
> 设置 Claude、ChatGPT、Claude Code、VS Code 或 Cursor。

> [card] [权限与安全](https://docs.squarecloud.app/zh/mcp/permissions-and-safety.md)
>
> 权限范围、受限密钥和安全 snapshot。

> [card] [工具](https://docs.squarecloud.app/zh/mcp/tools.md)
>
> 所有工具及其所需的权限范围。

> [card] [限制与错误](https://docs.squarecloud.app/zh/mcp/limits-and-errors.md)
>
> 请求和工具的限制，以及每个错误的含义。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.