--- title: "Solução de problemas com conexões de agentes… | Metaintro" canonical: "https://www.metaintro.com/pt/help/ai-agent-troubleshooting" language: "pt" author: "Metaintro" published: "2026-10-20T20:26:12.823Z" modified: "2026-10-20T23:52:05.311Z" --- # Solução de problemas com conexões de agentes de IA Resolva problemas comuns ao conectar um agente de IA à Metaintro: login, acesso somente leitura, acesso à organização, limites de uso e ações que falharam. Última atualização: October 20, 2026[Solução de problemas](/pt/help/category/troubleshooting) Cole no Claude, ChatGPT, Codex, Cursor ou Pi. ## O agente não consegue fazer login Se o seu app de IA mostrar um erro de login ou continuar pedindo para você se conectar: 1. Comece a conexão de novo pelo seu app de IA. No Claude Code, digite `/mcp`, escolha a conexão da Metaintro e faça login novamente. 2. Confira se você está entrando na conta da Metaintro que quer que o agente use. 3. Na página da Metaintro que abrir, selecione **Permitir**. Se aparecer "Este link expirou", volte ao seu app de IA e comece de novo. 4. Verifique o endereço que você adicionou. Ele deve ser exatamente `https://www.metaintro.com/api/mcp`, ou `https://www.metaintro.com/api/mcp/org/` para uma organização. **Primeiros passos**, em Configurações > Agentes ou na aba **Meus agentes de IA** das configurações da sua organização, mostra o endereço certo com um botão para copiá-lo. Se você se conectou com uma chave pessoal, o agente pode ver: "Sign in through your AI client, or send a Metaintro personal API key…". Isso significa que a chave está faltando, foi digitada errado, expirou ou foi desconectada. As chaves valem por 90 dias. Em [Configurações > Agentes](/settings/agents), abra a aba **Outros apps** em **Primeiros passos**, selecione **Criar uma chave de API** e atualize a configuração do seu app. No Codex, execute `codex mcp login metaintro`. No Pi, execute `pi mcp login metaintro`. Para uma organização, use o nome da conexão dela, como `metaintro-`. Com a extensão pi-mcp-adapter, entre dentro do Pi com `/mcp-auth metaintro`. Para ver se o app está conectado, execute `codex mcp list` ou `pi mcp list`. ## O agente consegue ler, mas não consegue fazer alterações Se o agente informar **insufficient scope** ou disser que não pode fazer alterações, ele está conectado como **Somente leitura**: **Agentes que você conectou** mostra **Somente leitura** ao lado dele. Desconecte-o e conecte-o de novo. Com uma chave de API, escolha **Ler e agir** em **O que ele pode fazer**. Quando você entra pelo seu app, confira se a página da Metaintro lista fazer alterações por você antes de selecionar **Permitir**. Se a mensagem disser "This credential cannot use the MCP server", a chave foi criada sem acesso para agentes. Selecione **Criar uma chave de API** na aba **Outros apps**, em Configurações > Agentes, ou faça login de novo pelo seu app de IA e permita o acesso. ## "Organization keys name no person to act as" As chaves de API de organização (`mi_org_…`) não podem ser usadas com agentes de IA. Um agente sempre age como uma pessoa, para que toda alteração fique registrada no nome de alguém. Use uma chave pessoal de Configurações > Agentes ou faça login pelo seu app de IA. ## "You aren't on this organization's staff" A conexão de uma organização (`/api/mcp/org/`) só funciona para pessoas com uma função na equipe dessa organização. Se você vir essa mensagem: - Confira o nome da organização no endereço. - Pergunte a um administrador da organização se você tem uma função na equipe. Só a equipe vê a aba **Meus agentes de IA** nas configurações da organização. - Para a sua própria busca de emprego, use o endereço pessoal `https://www.metaintro.com/api/mcp`. ## "This connection only reaches…" A conexão de cada organização funciona apenas nessa organização. Se o agente tentar trabalhar com outra organização, o pedido é recusado. Adicione uma conexão separada pela aba **Meus agentes de IA** nas configurações da outra organização. ## O agente não encontra as ferramentas de gestor de caso A conexão pessoal alcança apenas a sua própria busca de emprego. Para trabalhar com os membros de uma organização, conecte-se ao endereço dessa organização. Veja [Como usar agentes de IA como gestor de caso](/help/ai-agents-for-case-managers). ## "Too many calls from this key. Try again in N seconds." Para manter a Metaintro rápida para todos, cada conexão tem limites por minuto para leituras, alterações, pedidos ao Cabinet e conversas com o assistente. Espere o número de segundos indicado e tente de novo. Se isso continuar acontecendo, peça ao seu agente que faça menos pedidos, porém maiores. "Too many requests" ou "Metaintro is temporarily unavailable" costumam se resolver em até um minuto. ## Uma ação está aguardando aprovação Se o agente disser que uma ação está **aguardando aprovação**, ela não travou. Aprove ou recuse em **Aguardando sua aprovação**, em Configurações > Agentes, ou na aba **Meus agentes de IA** nas configurações da sua organização, se ela veio pela conexão dessa organização. As solicitações expiram após 7 dias. Veja [Como aprovar o que seu agente de IA faz](/help/ai-agent-approvals). ## Uma ação falhou depois que você a aprovou Se você vir "Aprovada, mas a ação falhou", peça ao seu agente que verifique a solicitação. Ele pode ler o motivo com a ferramenta de status de solicitações (`get_action_request`). Motivos comuns: - O registro mudou nesse meio-tempo. Peça ao agente que o leia de novo e tente outra vez. - O agente foi desconectado antes de você aprovar, então nada foi executado. - Você não tem mais acesso ao que a ação precisava. ## O agente diz que um registro mudou Algumas alterações verificam se o agente tem a versão mais recente de um registro. Se outra pessoa o editou antes, a alteração é recusada para que nada seja sobrescrito. Peça ao agente que leia o registro de novo e tente outra vez. ## Desconectar ou reconectar um agente 1. Acesse [Configurações > Agentes](/settings/agents) ou a aba **Meus agentes de IA** nas configurações da sua organização. 2. Encontre o agente em **Agentes que você conectou** e selecione o botão de excluir (lixeira) dele. 3. Confirme com **Desconectar**. Ele para de funcionar na hora, em todos os lugares. Para usá-lo de novo, conecte-o outra vez pelo seu app de IA. ## Para agentes de IA: verifique a conexão Siga estes passos em ordem: 1. Chame `whoami`. Se funcionar, a conexão está certa. Observe qual é a conexão e a configuração de aprovação. 2. Se receber um erro de login, peça à pessoa que entre de novo (`/mcp` no Claude Code, `codex mcp login metaintro` no Codex, `pi mcp login metaintro` no Pi (ou `/mcp-auth metaintro` dentro do Pi com a extensão pi-mcp-adapter)). Confira se o endereço é exatamente `https://www.metaintro.com/api/mcp`. 3. Se uma alteração for recusada por **insufficient scope**, a conexão é **Somente leitura**. Avise a pessoa e não tente de novo. 4. Se pedirem para tentar de novo em alguns segundos, espere esse tempo antes da próxima chamada. 5. Se uma alteração for recusada porque o registro mudou, leia-o de novo e tente com a nova versão. ## Ainda com problemas? [Fale conosco](/help/contact-us) e inclua a mensagem de erro. Se ela tiver um ID de pedido (request ID), inclua-o também; isso nos ajuda a descobrir o que aconteceu. ### Este artigo foi útil? ## Artigos relacionados - [Segurança e privacidade de agentes de IAO que um agente de IA conectado pode ver e fazer na Metaintro, a diferença entre chaves e login, e como revogar o acesso a qualquer momento.](/pt/help/ai-agent-security-and-privacy) - [Como aprovar o que seu agente de IA fazEscolha quais ações do agente esperam sua aprovação e aprove ou recuse solicitações na lista Aguardando sua aprovação.](/pt/help/ai-agent-approvals) - [Como usar agentes de IA como gestor de casoConecte um agente de IA a uma organização para ajudar na sua carteira de casos: follow-ups, notas, check-ins, tarefas, listas de vagas e respostas.](/pt/help/ai-agents-for-case-managers) - [Conectar um agente de IA à MetaintroDeixe o Claude, o ChatGPT, o Cursor ou outro agente de IA ajudar na sua busca de emprego na Metaintro, usando sua própria conta e suas permissões.](/pt/help/connect-ai-agents-to-metaintro) [Voltar à navegação](#main-navigation)