# Conecta un asistente de IA a tu cuenta de MONEI

El servidor MCP de MONEI permite que un asistente de IA, como Claude o ChatGPT, trabaje con tu cuenta de MONEI. Pregunta al asistente por tus pagos, clientes, suscripciones o liquidaciones, y lee la respuesta de tu cuenta. Con acceso de escritura, también puede actuar por ti, por ejemplo crear un pago o hacer un reembolso.

El asistente nunca recibe tu contraseña. Inicias sesión en el panel de MONEI, eliges una cuenta y los permisos que recibe el asistente, y puedes desconectarlo en cualquier momento.

info

Asistentes de IA compatibles hoy: [Claude](https://claude.ai) (la aplicación web y Claude Desktop), [Claude Code](https://claude.com/claude-code) y [ChatGPT](https://chatgpt.com) (planes Pro, Business, Enterprise y Edu). Pronto llegarán más asistentes. El servidor MCP solo funciona con datos reales: el modo de prueba y las cuentas de prueba no están disponibles.

## Cómo funciona[​](#how-it-works "Enlace directo al Cómo funciona")

<!-- -->

El asistente se comunica con el servidor MCP en `https://mcp.monei.com`. El inicio de sesión empieza en `oauth.monei.com` y continúa en `dashboard.monei.com`, donde inicias sesión como siempre (contraseña, Google o Apple, y tu segundo factor). Si ya tienes la sesión iniciada, el asistente va directamente a la página de consentimiento.

## Añade el servidor MCP de MONEI[​](#add-connector "Enlace directo al Añade el servidor MCP de MONEI")

* Claude y Claude Desktop
* Claude Code
* ChatGPT

En un plan Free, Pro o Max:

1. En Claude, abre **Customize → Connectors**, haz clic en **+ Add** y después en **Add custom connector**.

2. Introduce el nombre `MONEI` y la URL, y haz clic en **Continue**:

   ```
   https://mcp.monei.com
   ```

3. Comprueba los ajustes de autenticación y haz clic en **Continue**.

4. En **Authentication**, elige **Sign in now**. En **OAuth client**, mantén **Use Claude's published identity**. MONEI no acepta ningún otro cliente OAuth.

5. Haz clic en **Add**. Claude abre el inicio de sesión de MONEI en tu navegador.

En un plan Team o Enterprise, solo un Owner o un Primary Owner puede añadir un conector personalizado. En Enterprise, también puede añadirlo un rol personalizado con **Manage access to Libraries**:

1. El propietario abre **Organization settings → Connectors**, hace clic en **Add**, pasa el ratón por **Custom** y selecciona **Web**.
2. El propietario introduce el nombre `MONEI` y la URL `https://mcp.monei.com`, hace clic en **Continue**, define **Authentication** y **OAuth client** como en los pasos 3 y 4 anteriores, y hace clic en **Add**.
3. Cada miembro abre **Customize → Connectors**, busca el conector de MONEI y hace clic en **Connect**. Cada miembro inicia sesión en MONEI con su propio usuario.

Un conector que añades en claude.ai también está disponible en Claude Desktop.

Ejecuta:

```
claude mcp add --transport http monei --scope user https://mcp.monei.com
```

`--scope user` hace que el servidor esté disponible en todos los proyectos. Sin esta opción, Claude Code añade el servidor solo al proyecto actual.

Después, en Claude Code, ejecuta `/mcp`, selecciona **monei** y elige **Authenticate**. Claude Code abre el inicio de sesión de MONEI en tu navegador.

Usa ChatGPT en la web. Lo que puedes hacer depende de tu plan de ChatGPT:

* **Business, Enterprise y Edu:** Lectura y Escritura. En Business, solo un administrador o un propietario del espacio de trabajo puede añadir un servidor MCP personalizado. En Enterprise y Edu, un administrador da este acceso por rol.
* **Pro:** solo Lectura. ChatGPT no usa `graphql_mutation`, así que conecta con **Lectura**.
* **Free y Plus:** no disponible.

El [artículo de ayuda](https://help.openai.com/en/articles/12584461) de OpenAI indica los requisitos actuales.

1. Abre [ChatGPT Plugins](https://chatgpt.com/plugins), selecciona el botón más y después **Add custom MCP server**.

2. Introduce el nombre `MONEI`. En **Connection**, introduce esta **Server URL**:

   ```
   https://mcp.monei.com
   ```

3. Como autenticación, elige **OAuth**. No introduzcas un client ID ni un client secret: ChatGPT se identifica ante MONEI.

4. Revisa el aviso de riesgo, selecciona **I understand and want to continue** y después **Create as a plugin**.

5. Instala el plugin. Cuando ChatGPT te pide que te conectes, abre el inicio de sesión de MONEI.

En un espacio de trabajo, solo un administrador o un propietario puede publicar el plugin en el espacio, también cuando lo añadió un miembro con acceso de desarrollador. Después, cada miembro lo instala e inicia sesión en MONEI con su propio usuario.

En un chat, escribe `@` y selecciona **MONEI** para usarlo.

## Da acceso en la página de consentimiento[​](#consent "Enlace directo al Da acceso en la página de consentimiento")

Después de iniciar sesión, el panel muestra el nombre del asistente, por ejemplo «A ChatGPT le gustaría acceder a tu cuenta MONEI».

1. **Cuenta.** Elige la cuenta a la que accede el asistente. La lista muestra la cuenta seleccionada en tu panel y cualquier otra cuenta real en la que eres [usuario autorizado](https://docs.monei.com/es/manage-account/accessing-your-dashboard.md#users-roles). Una conexión llega a una sola cuenta.

2. **Definir los permisos.** Elige una opción:

   <!-- -->

   * **Lectura** (por defecto): el asistente puede ver datos y no cambia nada.
   * **Escritura**: el asistente puede ver datos y actuar, dentro de lo que permiten tus roles.
   * **Personalizar**: elige **Ninguno**, **Lectura** o **Escritura** para cada área, como Pagos, Suscripciones o Clientes.

3. Haz clic en **Continuar** y revisa la cuenta y la lista de permisos.

4. Haz clic en **Autorizar**. El panel te devuelve al asistente. **Cancelar** no da ningún acceso.

El asistente nunca recibe más de lo que permiten tus propios roles. Si tus roles cambian después, el acceso de la conexión cambia con ellos en la siguiente petición. Una conexión dura 30 días; después, conecta de nuevo.

aviso

Autoriza solo si acabas de iniciar la conexión en el asistente. Si la página de consentimiento aparece sin que hayas iniciado una conexión, haz clic en **Cancelar**.

### Claude Code y las aplicaciones de tu ordenador[​](#loopback "Enlace directo al Claude Code y las aplicaciones de tu ordenador")

Claude Code recibe el acceso a través de una dirección local de tu ordenador (`http://localhost`). Para esta conexión, el paso de revisión muestra «La autorización te redirigirá a una aplicación de este ordenador» en lugar de la dirección del asistente. Cualquier aplicación de tu ordenador puede presentarse como Claude Code. Autoriza solo si iniciaste la conexión en Claude Code en este ordenador.

## Qué puede hacer el asistente[​](#tools "Enlace directo al Qué puede hacer el asistente")

El servidor MCP da al asistente estas herramientas:

| Herramienta        | Qué hace                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| `graphql_schema`   | Describe las operaciones y los datos que el asistente puede usar.                                |
| `graphql_query`    | Lee datos de tu cuenta, a través de la [API GraphQL](https://docs.monei.com/es/apis/graphql.md). |
| `graphql_mutation` | Cambia datos, por ejemplo crea un pago o hace un reembolso. Solo con Escritura.                  |
| `search_docs`      | Busca en esta documentación. Todas las conexiones la tienen, sean cuales sean los permisos.      |

Una conexión de **Lectura** no recibe `graphql_mutation`. Cuando una acción necesita un permiso que la conexión no tiene, el asistente recibe un error que lo nombra, por ejemplo `Not authorized: payments:refund`. Para darlo, conecta de nuevo con **Escritura**, o con esa área en **Escritura** dentro de **Personalizar**.

### Los resultados contienen texto de otras personas[​](#third-party-text "Enlace directo al Los resultados contienen texto de otras personas")

Muchos campos contienen texto que escriben otras personas: nombres y emails de clientes, descripciones de pagos, metadatos y mensajes de disputas. El asistente lee ese texto como parte del resultado de una herramienta. Un cliente puede escribir un texto que parezca una instrucción para el asistente. Revisa con cuidado lo que el asistente propone después de leer esos datos:

* Revisa cada acción antes de permitirla. El asistente te pregunta antes de usar `graphql_mutation`: lee lo que envía.
* Usa **Lectura** cuando solo necesites respuestas.

peligro

Con **Escritura**, mantén la aprobación de `graphql_mutation`. En Claude, no elijas **Allow always** para esa herramienta. En ChatGPT, no dejes que recuerde tu aprobación. Durante una investigación (Research), Claude puede usar las herramientas de los conectores sin preguntarte: usa ahí una conexión de **Lectura**, o desactiva `graphql_mutation` en el menú de herramientas del chat.

## Qué no puede hacer una conexión[​](#limits "Enlace directo al Qué no puede hacer una conexión")

Algunos datos y acciones no están disponibles para el asistente, sean cuales sean los permisos y tus roles:

* **Pagos a tarjeta (payouts) y tipos de transacción.** El asistente no puede elegir el tipo de transacción de un pago, así que no puede crear pagos a tarjeta ni preautorizaciones. No puede crear ni editar [puntos de venta](https://docs.monei.com/es/manage-account/stores-and-points-of-sale.md).
* **Tokens de pago y tarjetas guardadas.** El asistente no puede leer tokens de pago ni los métodos de pago guardados de un cliente, crear un token de pago reutilizable ni definir el método de pago por defecto de un cliente.
* **Pagos recurrentes.** El asistente no puede iniciar una secuencia de pagos (pagos recurrentes o a plazos) ni activar una suscripción.
* **Destinos permanentes para tus datos.** El asistente no puede definir las URL de callback de una suscripción, gestionar webhooks, cambiar los ajustes de los procesadores de pago o de los informes SFTP, ni cambiar quién recibe los emails de la cuenta.
* **Usuarios e identidad.** El asistente no puede gestionar usuarios autorizados, leer los datos de verificación de identidad ni listar las otras cuentas de tu usuario.
* **Credenciales, datos bancarios y archivos.** El asistente no puede leer las claves de API, ve el número de tu cuenta bancaria enmascarado y no puede crear archivos de exportación, descargar documentos o contratos, ni subir documentos.
* **Disputas y documentos de financiación.** El asistente puede leer los contracargos, pero no puede abrir la respuesta a una disputa con sus documentos ni enviar pruebas. No puede leer los documentos de financiación (MONEI Capital) ni firmar tu contrato.
* **Aplicaciones conectadas.** El asistente no puede listar ni desconectar conexiones.

## Desconecta un asistente[​](#disconnect "Enlace directo al Desconecta un asistente")

[Configuración → Aplicaciones conectadas](https://dashboard.monei.com/settings/connected-apps) lista las conexiones de tu usuario en todas las cuentas, con la cuenta de cada una. Haz clic en **Desconectar** para terminar una conexión: la siguiente petición del asistente falla, y tienes que conectar de nuevo para usarlo.

También puedes quitar el servidor MCP en el asistente:

* **Claude:** abre **Customize → Connectors** y desconecta o elimina el conector de MONEI.
* **Claude Code:** ejecuta `/mcp`, selecciona **monei** y elige **Clear authentication**, o ejecuta `claude mcp remove monei --scope user`.
* **ChatGPT:** elimina el plugin de MONEI en [ChatGPT Plugins](https://chatgpt.com/plugins).

aviso

Quitar el servidor MCP en el asistente no siempre termina el acceso en MONEI. Para asegurarte, desconecta la conexión en **Aplicaciones conectadas**.

## Preguntas frecuentes[​](#common-questions "Enlace directo al Preguntas frecuentes")

### ¿Por qué no aparece mi cuenta en la lista?[​](#account-missing "Enlace directo al ¿Por qué no aparece mi cuenta en la lista?")

La lista muestra solo cuentas reales. Tienes que ser [usuario autorizado](https://docs.monei.com/es/manage-account/accessing-your-dashboard.md#users-roles) de la cuenta. Si eres el titular de la cuenta y no estás en **Usuarios autorizados**, se aplican dos condiciones más: el email de administrador de la cuenta debe ser tu email, y la cuenta debe ser la seleccionada en tu panel. Selecciona la cuenta en el panel y conecta de nuevo.

### ¿Ve el asistente mi contraseña?[​](#password "Enlace directo al ¿Ve el asistente mi contraseña?")

No. Inicias sesión en `dashboard.monei.com`. El asistente recibe un token solo para esta conexión, y el token solo funciona con el servidor MCP de MONEI.

### ¿Puedo usar otro asistente de IA?[​](#other-clients "Enlace directo al ¿Puedo usar otro asistente de IA?")

Todavía no. El servidor MCP solo acepta Claude, Claude Desktop, Claude Code y ChatGPT. Pronto llegarán más asistentes. Para que cualquier cliente MCP busque en la documentación sin una cuenta, usa el [servidor MCP de la documentación](https://docs.monei.com/es/ai-agents.md#mcp).