Problemas comunes

Los problemas más habituales con el MCP, con la causa y cómo resolverlos. Para el paso a paso de cada asistente, consulta Conectar Claude, Conectar ChatGPT y Conectar Claude Code y Cursor.

#La conexión

#"No autorizado", 401 o "token caducado"

El asistente no tiene una llave válida.

La llave de acceso dura 1 hora y se renueva sola; si el asistente pide conectar de nuevo con frecuencia, quita el conector y vuelve a añadirlo.

#"Esta solicitud de acceso no es válida"

La pantalla de autorización recibió una solicitud incompleta, o de una dirección de retorno que no coincide. Quita el conector en el asistente, añádelo de nuevo y conéctalo.

#La comunidad no aparece en la pantalla de autorización

La cuenta con la que has entrado no participa en ella. Cierra la sesión de Memberfy en el navegador e inicia sesión con la cuenta correcta antes de conectar.

#Las herramientas

#No aparece una herramienta

El asistente solo ve las herramientas que tu rol puede usar. Un moderador no ve create_plan; un miembro no ve list_members; Finanzas no ve request_payout. Comprueba tu rol con "¿a qué comunidad estás conectado y con qué rol?" y compáralo con Herramientas.

Otras causas:

• La conexión se autorizó solo para lectura: las de creación y de dinero no aparecen. Conecta de nuevo con lectura y escritura.
• El conector está desactivado en la conversación (Claude) o no se ha seleccionado (ChatGPT).

#El asistente usa nombres antiguos, como criar_post

El 6 de octubre de 2026 las herramientas pasaron a tener nombres en inglés (create_post, list_spaces, issue_certificate). Una conversación abierta antes puede seguir con la lista antigua, y la llamada falla porque la herramienta ya no existe. Abre una conversación nueva; si no se resuelve, vuelve a conectar el conector. Los nombres actuales están en Herramientas.

#Falta una herramienta, o el asistente dice que no existe

Algunos asistentes guardan la lista de herramientas de Memberfy del principio de la conversación. Si Memberfy actualizó el servidor después, el asistente sigue con la lista antigua: no ve una herramienta nueva, o intenta usar una que cambió de nombre.

1. Abre una conversación nueva.
2. Si no se resuelve, desconecta y vuelve a conectar el conector de Memberfy en el asistente.

Cuando el asistente intenta usar una herramienta que cambió de nombre o que no está en su lista, Memberfy lo avisa en la propia respuesta: da el nombre nuevo, o pide abrir una conversación nueva o volver a conectar.

El propietario y los administradores de la comunidad pueden ver qué versión de la lista recibió cada conexión y si está al día. Por ahora eso está en la API, en el diagnóstico de la conexión, todavía sin pantalla en el panel. Consulta Versión del servidor y de la lista.

#"Tu rol (…) no permite esta acción en esta comunidad."

La herramienta aparece, pero esa acción concreta se rechaza. Ejemplos:

• un miembro publicando en un espacio con Quién puede publicar = Equipo;
• un moderador usando create_event con entrada, o sin indicar un espacio que ya exista;
• una acción en un espacio que tu rol no ve.

#"La API rechazó (400): …"

Un valor no válido: un precio a cero, un título demasiado corto, una fecha sin zona horaria, un id de otra cosa. El mensaje dice qué campo. Pide al asistente que lo corrija y lo intente de nuevo.

#Una compuesta falló a mitad

La respuesta dice qué paso falló y que se deshizo todo. Corrige la causa (por ejemplo, usa un espacio del módulo correcto) y vuelve a pedirlo. Si la respuesta dice que algo no se pudo deshacer, revisa en el panel el elemento indicado y bórralo a mano.

#"Demasiadas llamadas en poco tiempo"

El límite es de 120 llamadas de herramienta por minuto por conexión. Ocurre con peticiones grandes (responder a 200 comentarios de una vez). Espera un minuto, o pídelo por partes.

#La comunidad equivocada

El asistente creó algo en la comunidad equivocada porque estaba conectado a ella. Cada conexión es de una sola comunidad.

1. Pregunta: "¿a qué comunidad estás conectado?".
2. Desactiva en la conversación el conector de la comunidad equivocada y activa el de la correcta. Si no existe, crea una conexión para la otra comunidad.
3. Borra desde el panel lo que se creó en el sitio equivocado (no hay herramienta de borrar).

Para evitarlo: pon nombres claros a los conectores (Memberfy · Escuela, Memberfy · Coworking) y deja activado solo uno por conversación.

#La confirmación de dinero y de eliminación

#"Confirmación no válida, vencida, ya usada o con argumentos distintos"

#El asistente ejecutó sin preguntar

Las herramientas de dinero y de eliminación siempre devuelven primero un resumen. Si el asistente siguió sin mostrarlo, no siguió las instrucciones. Revisa en el panel lo que se hizo, desconecta y vuelve a conectar, y di de forma explícita al principio de la conversación: "enséñame siempre el resumen antes de confirmar cualquier cosa con dinero o eliminación".

Las invitaciones, el cambio de rol, la configuración y la emisión de certificados no piden la confirmación de Memberfy: se ejecutan en la primera llamada. Si quieres revisarlas antes, pide "enséñamelo antes de hacerlo", y mantén esas herramientas como "preguntar antes" en los permisos del asistente.

#Lo que todavía no se puede hacer

El MCP todavía no cubre todo lo que hace el panel. Esto queda para más adelante, y sigue haciéndose desde el panel:

#Relacionados

• Visión general del MCP
• Seguridad y límites
• Herramientas