Solução de problemas com conexões de agentes…

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:

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.
Confira se você está entrando na conta da Metaintro que quer que o agente use.
Na página da Metaintro que abrir, selecione Permitir. Se aparecer "Este link expirou", volte ao seu app de IA e comece de novo.
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/<org-slug> 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, 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-<org-slug>. 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/<org-slug>) 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.

"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.

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

Acesse Configurações > Agentes ou a aba Meus agentes de IA nas configurações da sua organização.
Encontre o agente em Agentes que você conectou e selecione o botão de excluir (lixeira) dele.
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:

Chame whoami. Se funcionar, a conexão está certa. Observe qual é a conexão e a configuração de aprovação.
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.
Se uma alteração for recusada por insufficient scope, a conexão é Somente leitura. Avise a pessoa e não tente de novo.
Se pedirem para tentar de novo em alguns segundos, espere esse tempo antes da próxima chamada.
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 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.

Solução de problemas com conexões de agentes de IA