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 (la aplicación web y Claude Desktop), Claude Code y ChatGPT (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

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

Claude y Claude Desktop

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.

Claude Code

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.

ChatGPT

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 de OpenAI indica los requisitos actuales.

1. Abre ChatGPT 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

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

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

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

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

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

Configuración → Aplicaciones conectadas 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.

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

¿Por qué no aparece mi cuenta en la lista?

La lista muestra solo cuentas reales. Tienes que ser usuario autorizado 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?

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?

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.