> ## 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. # Conecta un cliente de IA al servidor MCP de Square Cloud > Conecta Claude y ChatGPT con OAuth, o Claude Code, VS Code y Cursor con una clave de API, al servidor MCP de Square Cloud, y descubre cuánto dura una conexión. 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) (claude.ai y las apps de Claude) | OAuth: pega la dirección y autoriza en Square Cloud | | [ChatGPT](#chatgpt) | OAuth: pega la dirección y autoriza en Square Cloud | | [Claude Code](#claude-code) | [Clave de API](#crear-una-clave-de-api) en el encabezado `Authorization` | | [VS Code](#vs-code) | [Clave de API](#crear-una-clave-de-api) en el encabezado `Authorization` | | [Cursor](#cursor) | [Clave de API](#crear-una-clave-de-api) en el encabezado `Authorization` | | [Otros clientes](#otros-clientes) | [Clave de API](#crear-una-clave-de-api) en el encabezado `Authorization` | En ambos casos, tu cuenta necesita un [plan](https://docs.squarecloud.app/es/platform/plans.md) activo. ## Claude **1. 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**. **2. Introduce la dirección** Ponle el nombre `Square Cloud`, introduce `https://mcp.squarecloud.app/mcp` y haz clic en **Continue**. **3. 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**. **4. 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. **5. Úsalo en un chat** De vuelta en Claude, haz clic en **+** en el cuadro del chat, abre **Connectors** y activa **Square Cloud**. > [!NOTE] > > Square Cloud solo acepta la identidad publicada de Claude. **Register automatically** y **Use your own OAuth client** no funcionan con él. ## ChatGPT **1. Añade un servidor MCP personalizado** Abre los [plugins de ChatGPT](https://chatgpt.com/plugins), 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. **2. 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. **3. Créalo** Revisa la advertencia, selecciona **I understand and want to continue** y luego **Create as a plugin**. **4. 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. **5. Úsalo en un chat** Empieza una conversación nueva, escribe `@` y elige **Square Cloud**. > [!NOTE] > > 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](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt). ## Claude Code Claude Code se conecta con una [clave de API](#crear-una-clave-de-api) en un encabezado, no con OAuth. Guarda la clave en la variable de entorno `SQUARECLOUD_API_KEY` y ejecuta: ```bash theme={"system"} 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: ```json .mcp.json theme={"system"} { "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: ```json .vscode/mcp.json theme={"system"} { "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](#crear-una-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**. > [!TIP] > > Esto es independiente de la [extensión de Square Cloud para VS Code](https://docs.squarecloud.app/es/vscode-extension/installation.md), 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: ```json .cursor/mcp.json theme={"system"} { "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. ```http theme={"system"} Authorization: Bearer ``` ## Crear una clave de API Crea la clave en la [configuración de seguridad de tu cuenta](https://squarecloud.app/es/account/security): * **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](https://docs.squarecloud.app/es/mcp/permissions-and-safety.md#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](https://docs.squarecloud.app/es/mcp/permissions-and-safety.md#claves-restringidas-a-aplicaciones-y-bases-de-datos). 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](https://docs.squarecloud.app/es/mcp/limits-and-errors.md). ## Desconectar Revoca la clave en la [configuración de seguridad de tu cuenta](https://squarecloud.app/es/account/security): 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.