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

# Conectar con IA (servidor MCP)

> Conecta Claude, ChatGPT, Cursor o VS Code a tu cuenta de Hurry para que la IA cree y gestione tus tiendas por ti.

La sección **Conectar con IA** te permite conectar asistentes de inteligencia artificial como **Claude**, **ChatGPT**, **Cursor** o **VS Code** a tu cuenta de Hurry a través del **servidor MCP de Hurry Payments**.

MCP es el estándar con el que los asistentes de IA usan herramientas externas. Una vez conectada, tu IA puede crear tiendas, subir productos y fotos, diseñar las páginas, traducirlas, redactar las políticas y publicarlas, siempre con los permisos de tu cuenta.

Encontrarás esta sección en el menú lateral, dentro de **Cuenta > Conectar con IA**.

![Pantalla Conectar con IA dentro del menú Cuenta de Hurry](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-vista-general.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=e6679f6cc483877c7783970b382cf1eb)

***

## Qué puede hacer la IA

Con un token conectado, la IA puede trabajar sobre estas áreas de tu cuenta:

| Área | Qué incluye |
| :- | :- |
| Tiendas | Tiendas, páginas y secciones |
| Catálogo | Productos, variantes y colecciones |
| Diseño | Tema, menú, carrito y CSS |
| Contenido | Traducciones, políticas y dominio |
| Pagos | Pagos, clientes y pasarelas |
| Operaciones | Reembolsos, enrutamiento y cobros masivos |
| Marketing | Píxeles, automatizaciones, emails y SMS |

![Bloque Servidor MCP de Hurry Payments con las funciones disponibles y la URL del servidor](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-servidor.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=8dc7ec7a392eed328004689a6c07b16a)

Lo que la IA puede hacer en cada caso depende del nivel de acceso que le des al token (lo verás en el siguiente paso).

***

## Paso 1: crear un token

El token es la llave con la que la IA accede a tu cuenta. Crea uno distinto para cada IA o dispositivo: así puedes revocarlos por separado.

**1. Abre el formulario**

En **Conectar con IA**, pulsa **Nuevo token** (arriba a la derecha).

**2. Ponle un nombre**

En **Nombre**, escribe la IA o el equipo donde lo vas a usar, por ejemplo `Claude Desktop` o `Cursor portátil`. Te servirá para reconocerlo luego.

**3. Confirma con tu contraseña**

En **Tu contraseña**, introduce la contraseña de tu cuenta de Hurry para confirmar que eres tú quien crea el token.

**4. Elige el nivel de acceso**

* **Completo**: puede crear, cambiar, publicar y, con tu confirmación, cobrar o reembolsar.
* **Solo lectura**: solo consulta ventas, pagos, tiendas y métricas. No puede cambiar nada.

**5. Decide si permite operaciones con dinero**

La casilla **Permitir operaciones con dinero** habilita reembolsos, cobros masivos, campañas SMS, apps de pago y cambios en pasarelas. Déjala desmarcada si no lo necesitas.

**6. Elige la caducidad**

En **Caducidad** puedes elegir **No caduca**, **7 días**, **30 días**, **90 días** o **1 año**.

**7. Crea el token**

Pulsa **Crear token**. El token aparecerá en el listado de **Tokens**.

![Formulario Nuevo token con nombre, contraseña, nivel de acceso, operaciones con dinero y caducidad](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-nuevo-token.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=5f96b8f387ce976179769e545ed347eb)

> [!TIP]
>
> Si solo quieres que la IA te ayude a analizar ventas o métricas, crea un token de **Solo lectura**. Usa el acceso **Completo** cuando quieras que cree o modifique tiendas, y marca **Permitir operaciones con dinero** únicamente si de verdad lo necesitas.

***

## Paso 2: conectar tu IA

Todas las conexiones usan la misma URL del servidor:

```text URL del servidor theme={null}
https://app.hurrypayments.com/api/mcp
```

El transporte es HTTP y el token se envía en la cabecera `Authorization: Bearer`. En los ejemplos, sustituye `TU_TOKEN` por el token que has creado.

En el apartado **Cómo conectarlo** tienes una pestaña por cada herramienta, con el botón **Copiar** para llevarte la configuración.

> [tab] claude.ai / ChatGPT
>
> Para claude.ai y ChatGPT se usa una URL que lleva el token dentro:
>
> ```text URL con token theme={null}
> https://app.hurrypayments.com/api/mcp/t/TU_TOKEN
> ```
>
> * **claude.ai**: ve a **Ajustes > Conectores > Añadir conector personalizado** y pega esta URL.
> * **ChatGPT**: ve a **Ajustes > Conectores > Modo desarrollador > Crear**, pega esta URL y deja la conexión **sin autenticación**.
>
> ![Pestaña claude.ai / ChatGPT con la URL que incluye el token](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-claude-ai.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=685c897b70eccaea8ef8b6701e6ea471)
>
> > [!WARNING]
> >
> > Esta URL lleva el token dentro: no la compartas. Si se filtra, revoca el token.

> [tab] Claude Desktop
>
> Necesitas tener **Node.js** instalado.
>
> 1. En Claude Desktop, ve a **Ajustes > Desarrollador > Editar configuración**.
> 2. Añade esto al archivo `claude_desktop_config.json`:
>
> ```json claude_desktop_config.json theme={null}
> {
>   "mcpServers": {
>     "hurry": {
>       "command": "npx",
>       "args": [
>         "-y",
>         "mcp-remote",
>         "https://app.hurrypayments.com/api/mcp",
>         "--header",
>         "Authorization:${HURRY_AUTH}"
>       ],
>       "env": {
>         "HURRY_AUTH": "Bearer TU_TOKEN"
>       }
>     }
>   }
> }
> ```
>
> 3. Guarda el archivo y reinicia Claude Desktop.
>
> ![Pestaña Claude Desktop con la configuración para claude\_desktop\_config.json](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-claude-desktop.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=41361f5c56d366463f9d6d038056d5cd)
>
> > [!NOTE]
> >
> > También puedes usar en Claude Desktop la URL de la pestaña claude.ai, desde **Ajustes > Conectores**.

> [tab] Claude Code
>
> Ejecuta este comando en la terminal:
>
> ```bash Terminal theme={null}
> claude mcp add --transport http hurry https://app.hurrypayments.com/api/mcp --header "Authorization: Bearer TU_TOKEN"
> ```
>
> Añade `--scope user` para tenerlo disponible en todos tus proyectos.
>
> ![Pestaña Claude Code con el comando claude mcp add](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-claude-code.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=12ba3b25686ed53cc51affbea44ccb7c)

> [tab] Cursor
>
> En Cursor, ve a **Ajustes > MCP > Add new global MCP server**, o edita directamente el archivo `~/.cursor/mcp.json`:
>
> ```json ~/.cursor/mcp.json theme={null}
> {
>   "mcpServers": {
>     "hurry": {
>       "url": "https://app.hurrypayments.com/api/mcp",
>       "headers": {
>         "Authorization": "Bearer TU_TOKEN"
>       }
>     }
>   }
> }
> ```
>
> ![Pestaña Cursor con la configuración de mcp.json](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-cursor.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=1cce05168499aba9778260212efe947b)

> [tab] VS Code
>
> Funciona con **Copilot en modo agente**. Crea el archivo `.vscode/mcp.json` en tu proyecto, o usa el comando **MCP: Add Server** desde la paleta de comandos:
>
> ```json .vscode/mcp.json theme={null}
> {
>   "servers": {
>     "hurry": {
>       "type": "http",
>       "url": "https://app.hurrypayments.com/api/mcp",
>       "headers": {
>         "Authorization": "Bearer TU_TOKEN"
>       }
>     }
>   }
> }
> ```
>
> ![Pestaña VS Code con la configuración de .vscode/mcp.json](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-vscode.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=7ca817314869a3492bd95bab9132c7cd)

***

## Paso 3: pídele algo a tu IA

Con la conexión hecha, escríbele a tu IA lo que necesitas en lenguaje natural. Por ejemplo:

> Crea una tienda de velas aromáticas con 4 productos, una home persuasiva en tonos cálidos y las políticas en español.

La IA usará las herramientas de Hurry para hacerlo, dentro de los permisos del token.

***

## Gestionar tus tokens

En el apartado **Tokens** verás todos los tokens que has creado. Mientras no tengas ninguno, aparecerá el mensaje **Todavía no hay tokens**.

![Apartado Tokens vacío con el mensaje Todavía no hay tokens](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-tokens-vacio.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=aff22b05cdc42bb917283f4e8e150b9b)

***

## Seguridad

* Trata el token como una contraseña: no lo compartas ni lo publiques.
* Crea un token por cada IA o dispositivo para poder revocarlos por separado.
* Si un token o la URL con token se filtra, revócalo.
* Usa **Solo lectura** siempre que la IA no necesite hacer cambios.
* Deja desmarcado **Permitir operaciones con dinero** salvo que lo necesites.
* Valora poner caducidad a los tokens que solo vayas a usar durante un tiempo.


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