Solución de problemas
Solución de problemas de MCP
Resuelve los problemas habituales con el servidor MCP de Emailit, desde el inicio de sesión y los permisos que faltan hasta los espacios de trabajo equivocados, las herramientas reservadas a administradores y los clientes que cargan demasiadas herramientas.
Empieza por preguntar a tu asistente «¿A qué espacio de trabajo de Emailit estoy conectado?». El asistente llama a get-current-workspace y te indica el espacio de trabajo, tu rol y el acceso concedido, lo que explica la mayoría de los problemas siguientes.
La página de inicio de sesión dice que el cliente es desconocido
El registro del cliente está obsoleto. Quita el servidor de Emailit de tu herramienta de IA y vuelve a añadirlo para que registre un cliente nuevo.
Una herramienta dice que necesita acceso total
La conexión se aprobó solo con el permiso sending. Los clientes compatibles con la autorización escalonada (step-up), como ChatGPT, vuelven a mostrar la pantalla de aprobación: aprueba el acceso full. Con otros clientes, revoca la conexión en AccountConnected apps, vuelve a conectarte y aprueba el acceso total. Con una clave de API, usa una clave Full Access.
Los cambios se hacen en el espacio de trabajo equivocado
Indica el espacio de trabajo en tu petición, por ejemplo «En Marketing, lista los dominios», o pide al asistente que cambie: «Cambia a mi espacio de trabajo Marketing». Las claves de API siempre actúan sobre el espacio de trabajo al que pertenecen.
Falta un espacio de trabajo
La conexión solo cubre los espacios de trabajo que hayas permitido. Abre AccountConnected apps, elige Edit access y añádelo, o elige All workspaces. Si te han quitado del espacio de trabajo, pide a un administrador que vuelva a invitarte.
Una herramienta dice que necesita el rol de administrador
El error admin_role_required significa que tienes el rol Member en ese espacio de trabajo y que la herramienta gestiona claves de API o elimina un dominio. Pide a un administrador del espacio de trabajo que lo haga o que cambie tu rol.
El cliente muestra demasiadas herramientas o no consigue cargarlas
Algunos clientes limitan el número de herramientas. Carga solo lo que necesitas con ?toolsets= en la URL del servidor o con la cabecera X-MCP-Toolsets, por ejemplo https://api.emailit.com/mcp?toolsets=emails,domains. Consulta Conjuntos de herramientas y modo de solo lectura.
Se rechaza un email
El remitente debe usar un dominio de envío verificado. Pide al asistente que compruebe el dominio con get-domain, publique los registros que falten y ejecute verify-domain. Hasta que tu espacio de trabajo tenga acceso de producción, solo puedes enviar a las direcciones de email de las cuentas de los miembros del espacio de trabajo.
Falla un reintento
Solo se pueden reintentar los emails rebotados, fallidos, bloqueados o retenidos, en un plazo de 30 días y mientras su contenido siga almacenado. Consulta Reintentar y reenviar.
El cliente muestra «Method not allowed»
El servidor no tiene estado y solo acepta peticiones POST. Actualiza tu cliente a una versión compatible con el transporte Streamable HTTP o usa el servidor local por stdio.
El cliente te pide una y otra vez que inicies sesión
El token de actualización caducó tras 60 días sin usarse, se reutilizó o la conexión se revocó. Vuelve a iniciar sesión desde el cliente. Si ocurre repetidamente, asegúrate de que solo una copia del cliente usa la conexión a la vez.
¿Sigues teniendo problemas?
Pregunta en Discord o escribe a support@emailit.com indicando el nombre del cliente, la herramienta que falló y el texto del error.