Conecta un cliente de IA al servidor MCP de Square Cloud

Todos los clientes usan la misma dirección, https://mcp.squarecloud.app/mcp. La forma de iniciar sesión depende del cliente:

Cliente	Cómo se conecta
Claude (claude.ai y las apps de Claude)	OAuth: pega la dirección y autoriza en Square Cloud
ChatGPT	OAuth: pega la dirección y autoriza en Square Cloud
Claude Code	Clave de API en el encabezado `Authorization`
VS Code	Clave de API en el encabezado `Authorization`
Cursor	Clave de API en el encabezado `Authorization`
Otros clientes	Clave de API en el encabezado `Authorization`

En ambos casos, tu cuenta necesita un plan activo.

Claude

Añade un conector personalizado

En Claude, abre Customize > Connectors, haz clic en + Add y luego en Add custom connector. En los planes Team y Enterprise, primero un propietario (Owner) lo añade en Organization settings > Connectors (Add > Custom > Web), y después cada miembro lo conecta desde Customize > Connectors.

Introduce la dirección

Ponle el nombre Square Cloud, introduce https://mcp.squarecloud.app/mcp y haz clic en Continue.

Mantén la identidad propia de Claude

Mantén una opción de inicio de sesión (Sign in now o Sign in when needed) y, como cliente OAuth, Use Claude’s published identity (Recommended). Deja Request headers vacío y haz clic en Add.

Autoriza en Square Cloud

Claude abre una página de Square Cloud. Inicia sesión si hace falta, revisa los permisos que pide Claude y haz clic para autorizar. Puedes desmarcar permisos para darle a Claude menos acceso; mcp siempre se mantiene, ya que es lo que conecta.

Úsalo en un chat

De vuelta en Claude, haz clic en + en el cuadro del chat, abre Connectors y activa Square Cloud.

Square Cloud solo acepta la identidad publicada de Claude. Register automatically y Use your own OAuth client no funcionan con él.

ChatGPT

Añade un servidor MCP personalizado

Abre los plugins de ChatGPT, selecciona + y luego Add custom MCP server. Según tu plan de ChatGPT, puede que un administrador del workspace tenga que permitir primero los servidores MCP personalizados.

Introduce la dirección

Ponle el nombre Square Cloud, elige el endpoint público como conexión e introduce https://mcp.squarecloud.app/mcp. Elige OAuth como autenticación.

Créalo

Revisa la advertencia, selecciona I understand and want to continue y luego Create as a plugin.

Autoriza en Square Cloud

Cuando ChatGPT te pide iniciar sesión, abre una página de Square Cloud. Inicia sesión si hace falta, revisa los permisos y haz clic para autorizar. Puedes desmarcar permisos; mcp siempre se mantiene.

Úsalo en un chat

Empieza una conversación nueva, escribe @ y elige Square Cloud.

ChatGPT cambia los nombres de estos menús de vez en cuando. Si no coinciden, sigue la guía de OpenAI para conectar un servidor MCP.

Claude Code

Claude Code se conecta con una clave de API en un encabezado, no con OAuth. Guarda la clave en la variable de entorno SQUARECLOUD_API_KEY y ejecuta:

claude mcp add --transport http squarecloud https://mcp.squarecloud.app/mcp \
  --header "Authorization: Bearer $SQUARECLOUD_API_KEY"

Tu shell completa la clave al ejecutar el comando, y Claude Code la guarda en su propia configuración. Para compartir el servidor con un proyecto sin compartir la clave, añádelo al .mcp.json del proyecto; Claude Code lee la variable cada vez que se inicia:

.mcp.json

{
  "mcpServers": {
    "squarecloud": {
      "type": "http",
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${SQUARECLOUD_API_KEY}"
      }
    }
  }
}

Comprueba la conexión con claude mcp list, o con /mcp dentro de Claude Code.

VS Code

Añade el servidor a .vscode/mcp.json en tu proyecto, o a tu configuración de usuario con MCP: Open User Configuration desde la paleta de comandos:

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "squarecloud-api-key",
      "description": "Square Cloud API key",
      "password": true
    }
  ],
  "servers": {
    "squarecloud": {
      "type": "http",
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${input:squarecloud-api-key}"
      }
    }
  }
}

VS Code pide la clave de API cuando el servidor se inicia, así que nunca queda en el archivo. Inicia, detén o reinicia el servidor con MCP: List Servers.

Esto es independiente de la extensión de Square Cloud para VS Code, que gestiona tus aplicaciones desde la barra lateral. Puedes usar ambas.

Cursor

Añade el servidor a .cursor/mcp.json en tu proyecto, o a ~/.cursor/mcp.json para todos tus proyectos:

.cursor/mcp.json

{
  "mcpServers": {
    "squarecloud": {
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SQUARECLOUD_API_KEY}"
      }
    }
  }
}

Define SQUARECLOUD_API_KEY en tu entorno antes de abrir Cursor. Activa el servidor en el menú Customize de Cursor; si no se conecta, el canal MCP Logs del panel de salida muestra por qué.

Otros clientes

Cualquier cliente que admita servidores MCP remotos por Streamable HTTP con un encabezado personalizado funciona de la misma forma: usa la dirección https://mcp.squarecloud.app/mcp y envía la clave de API en el encabezado Authorization. El prefijo Bearer es opcional.

Authorization: Bearer <your API key>

Crear una clave de API

Crea la clave en la configuración de seguridad de tu cuenta:

Dale el scope mcp, más los scopes de las herramientas que quieres que use el cliente. Una clave con acceso completo también funciona. Consulta Scopes.
Para acceso de solo lectura, elige mcp, apps:read, files:read, envs:read, snapshots:read y databases:read.
Para limitar el cliente a algunas aplicaciones y bases de datos, restringe la clave a ellas. Consulta Claves restringidas.

El secreto se muestra una sola vez. Guárdalo en una variable de entorno o en el almacén de secretos de tu cliente, nunca en un chat ni en un archivo al que hagas commit. Las claves que creas no expiran: revoca la clave cuando dejes de usarla. Una cuenta admite hasta 10 claves.

Cuánto dura una conexión

Claude y ChatGPT (OAuth). Autorizar crea una clave de API para ese cliente, con su nombre (Claude o ChatGPT):

Dura 90 días y no tiene token de actualización. Cuando expira, el cliente te pide iniciar sesión y autorizar de nuevo.
Solo funciona en el servidor MCP. En la REST API responde 403 MISSING_SCOPE.
Volver a conectar el mismo cliente revoca su clave anterior. Cada cuenta mantiene una conexión de Claude y una de ChatGPT, así que conectar una segunda cuenta de Claude desconecta la primera.

Para mantener varias conexiones a la vez, da a cada conexión adicional su propia clave de API. En Claude, un conector personalizado también puede enviar una clave de API: elige No sign in en Authentication y añade el encabezado Authorization en Request headers. En los planes Team y Enterprise, todos los que usan ese conector comparten el acceso de la clave. Las claves de API que creas no expiran. Sea cual sea la forma de entrar, todas las conexiones MCP de una cuenta comparten los mismos límites.

Desconectar

Revoca la clave en la configuración de seguridad de tu cuenta: la clave Claude o ChatGPT para una conexión OAuth, o la clave que creaste. El acceso termina en la siguiente solicitud del cliente. Quitar el conector o el servidor en el cliente hace que deje de llamar, pero solo revocar la clave en Square Cloud la invalida.

CLI

VS Code

MCP

SDKs

Conecta un cliente de IA al servidor MCP de Square Cloud

Claude

ChatGPT

Claude Code

VS Code

Cursor

Otros clientes

Crear una clave de API

Cuánto dura una conexión

Desconectar

​Claude

​ChatGPT

​Claude Code

​VS Code

​Cursor

​Otros clientes

​Crear una clave de API

​Cuánto dura una conexión

​Desconectar

Claude

ChatGPT

Claude Code

VS Code

Cursor

Otros clientes

Crear una clave de API

Cuánto dura una conexión

Desconectar