Solución de problemas con conexiones de…

El agente no puede iniciar sesión

Si tu app de IA muestra un error de inicio de sesión o te sigue pidiendo que te conectes:

Vuelve a iniciar la conexión desde tu app de IA. En Claude Code, escribe /mcp, elige la conexión de Metaintro y vuelve a iniciar sesión.
Asegúrate de iniciar sesión en la cuenta de Metaintro que quieres que use el agente.
En la página de Metaintro que se abre, selecciona Permitir. Si ves "Este enlace ha caducado", vuelve a tu app de IA y empieza de nuevo.
Revisa la dirección que agregaste. Debe ser exactamente https://www.metaintro.com/api/mcp, o https://www.metaintro.com/api/mcp/org/<org-slug> para una organización. Primeros pasos en Configuración > Agentes, o en la pestaña Mis agentes de IA de la configuración de tu organización, muestra la dirección correcta con un botón para copiarla.

Si te conectaste con una clave personal, es posible que el agente vea: "Sign in through your AI client, or send a Metaintro personal API key…". Esto significa que la clave falta, está mal escrita, caducó o se desconectó. Las claves duran 90 días. En Configuración > Agentes, abre la pestaña Otras apps en Primeros pasos, selecciona Crear una clave API y actualiza la configuración de tu app.

En Codex, ejecuta codex mcp login metaintro. En Pi, ejecuta pi mcp login metaintro. Para una organización, usa el nombre de su conexión, por ejemplo metaintro-<org-slug>. Con la extensión pi-mcp-adapter, inicia sesión dentro de Pi con /mcp-auth metaintro. Para ver si la app está conectada, ejecuta codex mcp list o pi mcp list.

El agente puede leer pero no hacer cambios

Si el agente informa insufficient scope, o dice que no puede hacer cambios, está conectado como Solo lectura: Agentes que has conectado muestra Solo lectura junto a él. Desconéctalo y vuelve a conectarlo. Con una clave API, elige Leer y actuar en Lo que puede hacer. Cuando inicies sesión desde tu app, comprueba que la página de Metaintro incluya hacer cambios por ti antes de seleccionar Permitir.

Si el mensaje dice "This credential cannot use the MCP server", la clave se creó sin acceso para agentes. Selecciona Crear una clave API en la pestaña Otras apps de Configuración > Agentes, o vuelve a iniciar sesión desde tu app de IA y permite el acceso.

"Organization keys name no person to act as"

Las claves de API de organización (mi_org_…) no se pueden usar con agentes de IA. Un agente siempre actúa como una persona, para que cada cambio quede registrado a nombre de alguien. Usa una clave personal de Configuración > Agentes, o inicia sesión desde tu app de IA.

"You aren't on this organization's staff"

La conexión de una organización (/api/mcp/org/<org-slug>) solo funciona para personas con un rol de personal en esa organización. Si ves este mensaje:

Revisa el nombre de la organización en la dirección.
Pregúntale a un administrador de la organización si tienes un rol de personal. Solo el personal ve la pestaña Mis agentes de IA en la configuración de la organización.
Para tu propia búsqueda de empleo, usa la dirección personal https://www.metaintro.com/api/mcp.

"This connection only reaches…"

La conexión de cada organización funciona solo en esa organización. Si el agente intenta trabajar con otra organización, se rechaza. Agrega una conexión aparte desde la pestaña Mis agentes de IA en la configuración de la otra organización.

El agente no encuentra las herramientas de administrador de casos

La conexión personal solo llega a tu propia búsqueda de empleo. Para trabajar con los miembros de una organización, conéctate a la dirección de esa organización. Consulta Usar agentes de IA como administrador de casos.

"Too many calls from this key. Try again in N seconds."

Para que Metaintro siga siendo rápido para todos, cada conexión tiene límites por minuto en lecturas, cambios, solicitudes a Cabinet y conversaciones con el asistente. Espera los segundos indicados y vuelve a intentarlo. Si sigue pasando, pídele a tu agente que haga menos solicitudes, pero más grandes.

"Too many requests" o "Metaintro is temporarily unavailable" suelen resolverse en menos de un minuto.

Una acción está esperando aprobación

Si el agente dice que una acción está esperando aprobación, no está atascada. Apruébala o recházala en Esperando tu aprobación, en Configuración > Agentes, o en la pestaña Mis agentes de IA de la configuración de tu organización si llegó por la conexión de esa organización. Las solicitudes caducan a los 7 días. Consulta Aprobar lo que hace tu agente de IA.

Una acción falló después de que la aprobaste

Si ves "Aprobada, pero la acción falló", pídele a tu agente que revise la solicitud. Puede leer el motivo con su herramienta de estado de solicitudes (get_action_request). Motivos comunes:

El registro cambió mientras tanto. Pídele al agente que lo vuelva a leer y lo intente de nuevo.
El agente se desconectó antes de que aprobaras, así que no se ejecutó nada.
Ya no tienes acceso a lo que la acción necesitaba.

El agente dice que un registro cambió

Algunos cambios comprueban que el agente tenga la versión más reciente de un registro. Si otra persona lo editó primero, el cambio se rechaza para no sobrescribir nada. Pídele al agente que vuelva a leer el registro y lo intente de nuevo.

Desconectar o volver a conectar un agente

Ve a Configuración > Agentes, o a la pestaña Mis agentes de IA en la configuración de tu organización.
Busca el agente en Agentes que has conectado y selecciona su botón de eliminar (papelera).
Confirma con Desconectar.

Deja de funcionar de inmediato, en todas partes. Para volver a usarlo, conéctalo de nuevo desde tu app de IA.

Para agentes de IA: comprueba la conexión

Sigue estos pasos en orden:

Llama a whoami. Si funciona, la conexión está bien. Fíjate en qué conexión es y en la configuración de aprobación.
Si recibes un error de inicio de sesión, pide a la persona que vuelva a iniciar sesión (/mcp en Claude Code, codex mcp login metaintro en Codex, pi mcp login metaintro en Pi (o /mcp-auth metaintro dentro de Pi con la extensión pi-mcp-adapter)). Comprueba que la dirección sea exactamente https://www.metaintro.com/api/mcp.
Si un cambio se rechaza por insufficient scope, la conexión es de Solo lectura. Díselo a la persona y no lo reintentes.
Si se te indica que lo intentes de nuevo en unos segundos, espera ese tiempo antes de la siguiente llamada.
Si un cambio se rechaza porque el registro cambió, vuelve a leerlo y reintenta con la nueva versión.

¿Sigues con problemas?

Contáctanos e incluye el mensaje de error. Si incluye un ID de solicitud, inclúyelo también; nos ayuda a encontrar qué pasó.

Solución de problemas con conexiones de agentes de IA