> ## 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.

# Servidor MCP de Square Cloud

> Conecta Claude, ChatGPT, Claude Code, VS Code o Cursor a tu cuenta de Square Cloud con el servidor MCP remoto y gestiona aplicaciones y bases de datos desde el chat.

El servidor MCP de Square Cloud permite que un cliente de IA trabaje en tu cuenta a través del [Model Context Protocol](https://modelcontextprotocol.io). Pide lo que necesites con tus propias palabras y el cliente llama a las [herramientas](https://docs.squarecloud.app/es/mcp/tools.md) por ti: consulta el estado, los logs, las métricas y el tráfico del edge, lee y edita archivos, gestiona variables de entorno, inicia y reinicia aplicaciones, crea aplicaciones, bases de datos y snapshots, y mucho más.

* **Remoto, sin nada que instalar:** una sola dirección HTTPS para todos los clientes.
* **Dos formas de conectarte:** Claude y ChatGPT inician sesión con OAuth en una página de consentimiento de Square Cloud. Claude Code, VS Code, Cursor y otros clientes envían una clave de API.
* **Tus permisos deciden:** una conexión solo ve las herramientas que cubren sus scopes, y una clave limitada a algunas aplicaciones y bases de datos solo llega a esas.
* **Tu cliente pregunta, tus datos quedan a salvo:** el aviso de permisos de tu cliente decide qué cambios se ejecutan, y eliminar una aplicación o una base de datos o restaurar un snapshot toma primero un snapshot de seguridad.

## Endpoint

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

Esta es la única dirección del servidor MCP. En `api.squarecloud.app` o en cualquier otra dirección de Square Cloud, las solicitudes MCP responden `421 WRONG_HOST` con la dirección correcta. A la inversa, `mcp.squarecloud.app` solo sirve el servidor MCP, nunca la REST API.

## Requisitos

* **Un [plan](https://docs.squarecloud.app/es/platform/plans.md) activo.** El servidor MCP forma parte de todos los planes de Square Cloud, desde Hobby. Sin un plan activo, cada solicitud responde `403 UPGRADE_REQUIRED`. Si tu plan vence, tus conexiones se conservan y vuelven a funcionar en cuanto renuevas el plan.
* **Un cliente MCP que admita servidores remotos** por Streamable HTTP, como Claude, ChatGPT, Claude Code, VS Code o Cursor. Consulta [Conectar un cliente](https://docs.squarecloud.app/es/mcp/connect.md).

## Protocolo

| Tema | Detalles |
| - | - |
| Transporte | Streamable HTTP, solo `POST`. El servidor no guarda sesión, y `GET` responde `405`. |
| Versiones del protocolo | `2026-07-28`, `2025-11-25`, `2025-06-18` y `2025-03-26`. Los clientes de la revisión `2026-07-28` llaman sin handshake; los clientes más antiguos empiezan con `initialize`. Una solicitud sin `MCP-Protocol-Version` se interpreta como `2025-03-26`, y una versión no admitida responde `400` con la lista de versiones admitidas. |
| Capacidades | Solo herramientas, sin recursos ni prompts. |
| Resultados | Cada herramienta responde un objeto JSON como bloque de texto, con `ok`, un `summary` y, cuando algo falló o te necesita, un `code`. |
| Llamadas largas | Una llamada que tarda más de unos segundos se responde como stream (SSE) con keepalives. Cerrar la conexión cancela la llamada, y ninguna llamada dura más de 3 minutos. |

## Lo que queda fuera del MCP

* **Proyectos de más de 1 MB.** El cliente puede enviar un proyecto de tu computadora como zip de hasta 1 MB, con `upload_application` para una aplicación nueva o `commit_application` para una nueva versión, y archivos de texto con `create_application` y `commit_application`. Para un proyecto más grande, usa la [CLI](https://docs.squarecloud.app/es/cli-reference/deploy.md), la [extensión de VS Code](https://docs.squarecloud.app/es/vscode-extension/features.md) o los [deploys desde GitHub](https://docs.squarecloud.app/es/cli-reference/github-deploys.md).
* **Descargas de snapshots y de certificados de bases de datos.** El enlace de descarga firmado terminaría en la conversación y en manos del proveedor del modelo de IA. Descárgalos desde el dashboard.
* **Actividad de la cuenta.** Muestra las direcciones IP y los dispositivos de tu cuenta, así que se queda en el dashboard.
* **Valores secretos.** Los valores de las variables de entorno, los archivos `.env` y las claves privadas nunca llegan al cliente de IA. Consulta [Secretos](https://docs.squarecloud.app/es/mcp/permissions-and-safety.md#secretos).
* **Configuración de la cuenta, facturación, claves de API y miembros de workspaces.** Se gestionan en el dashboard.

## Próximos pasos

> [card] [Conectar un cliente](https://docs.squarecloud.app/es/mcp/connect.md)
>
> Configura Claude, ChatGPT, Claude Code, VS Code o Cursor.

> [card] [Permisos y seguridad](https://docs.squarecloud.app/es/mcp/permissions-and-safety.md)
>
> Scopes, claves restringidas y snapshots de seguridad.

> [card] [Herramientas](https://docs.squarecloud.app/es/mcp/tools.md)
>
> Cada herramienta y el scope que necesita.

> [card] [Límites y errores](https://docs.squarecloud.app/es/mcp/limits-and-errors.md)
>
> Los límites de solicitudes y de herramientas, y qué significa cada error.


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