--- title: "Solución de problemas con conexiones de… | Metaintro" canonical: "https://www.metaintro.com/es/help/ai-agent-troubleshooting" language: "es" author: "Metaintro" published: "2026-10-20T20:26:12.823Z" modified: "2026-10-20T23:52:05.311Z" --- # Solución de problemas con conexiones de agentes de IA Soluciona problemas comunes al conectar un agente de IA a Metaintro: inicio de sesión, acceso de solo lectura, acceso a organizaciones, límites y acciones fallidas. Última actualización: October 20, 2026[Solución de problemas](/es/help/category/troubleshooting) Pégalo en Claude, ChatGPT, Codex, Cursor o Pi. ## 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: 1. 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. 2. Asegúrate de iniciar sesión en la cuenta de Metaintro que quieres que use el agente. 3. 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. 4. Revisa la dirección que agregaste. Debe ser exactamente `https://www.metaintro.com/api/mcp`, o `https://www.metaintro.com/api/mcp/org/` 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](/settings/agents), 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-`. 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/`) 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](/help/ai-agents-for-case-managers). ## "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](/help/ai-agent-approvals). ## 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 1. Ve a [Configuración > Agentes](/settings/agents), o a la pestaña **Mis agentes de IA** en la configuración de tu organización. 2. Busca el agente en **Agentes que has conectado** y selecciona su botón de eliminar (papelera). 3. 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: 1. 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. 2. 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`. 3. Si un cambio se rechaza por **insufficient scope**, la conexión es de **Solo lectura**. Díselo a la persona y no lo reintentes. 4. Si se te indica que lo intentes de nuevo en unos segundos, espera ese tiempo antes de la siguiente llamada. 5. Si un cambio se rechaza porque el registro cambió, vuelve a leerlo y reintenta con la nueva versión. ## ¿Sigues con problemas? [Contáctanos](/help/contact-us) e incluye el mensaje de error. Si incluye un ID de solicitud, inclúyelo también; nos ayuda a encontrar qué pasó. ### Fue util este articulo? ## Artículos relacionados - [Seguridad y privacidad de los agentes de IAQué puede ver y hacer un agente de IA conectado en Metaintro, en qué se diferencian las claves del inicio de sesión y cómo revocar el acceso en cualquier momento.](/es/help/ai-agent-security-and-privacy) - [Aprobar lo que hace tu agente de IAElige qué acciones de tus agentes esperan tu aprobación, y aprueba o rechaza solicitudes en la lista Esperando tu aprobación.](/es/help/ai-agent-approvals) - [Usar agentes de IA como administrador de casosConecta un agente de IA a una organización para que te ayude con tus casos: seguimientos, notas, check-ins, tareas, listas de empleos y respuestas.](/es/help/ai-agents-for-case-managers) - [Conecta un agente de IA a MetaintroDeja que Claude, ChatGPT, Cursor u otro agente de IA te ayude con tu búsqueda de empleo en Metaintro, con tu propia cuenta y tus permisos.](/es/help/connect-ai-agents-to-metaintro) [Volver a la navegación](#main-navigation)