Saltar al contenido principal
El servidor MCP de Square Cloud permite que un cliente de IA trabaje en tu cuenta a través del Model Context Protocol. Pide lo que necesites con tus propias palabras y el cliente llama a las herramientas 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

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

​
Protocolo

​
Lo que queda fuera del MCP

  • Hacer deploy de una carpeta de tu computadora. El MCP trabaja sobre lo que ya está en Square Cloud. Sube un proyecto con la CLI, la extensión de VS Code o los deploys desde GitHub.
  • 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.
  • Configuración de la cuenta, facturación, claves de API y miembros de workspaces. Se gestionan en el dashboard.

​
Próximos pasos

Conectar un cliente

Configura Claude, ChatGPT, Claude Code, VS Code o Cursor.

Permisos y seguridad

Scopes, claves restringidas y snapshots de seguridad.

Herramientas

Cada herramienta y el scope que necesita.

Límites y errores

Los límites de solicitudes y de herramientas, y qué significa cada error.