Conecta
Captura
Entende
Age
Mede e prevê
Conheça os agentes da StellanKnowledge Agent, AI SDR, Briefer, Deal Monitor e CRM Copilot.Ver os agentes →DesenvolvedoresMCPResolver problemas do MCP
Resolver problemas do MCP
Diagnóstico rápido para instalação, OAuth, callback, escopos, catálogo e chamadas de ferramentas.
Checklist de dois minutos
- Confirme que o servidor configurado é exatamente https://mcp.aivyro.io/mcp.
- Atualize a entrada com npx @aivyro/mcp@latest setup e recarregue o cliente.
- Entre na Aivyro no navegador e confirme a organização ativa antes de autorizar.
- Peça tools/list ou aivyro.getting_started; não valide a conexão apenas pelo status visual do cliente.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| No grantable scopes | A conexão pediu permissões que a conta, o papel ou a política atual não pode conceder. | Confirme a organização e o papel; desconecte o grant antigo; atualize o cliente e autorize de novo. Se persistir, um administrador deve revisar as permissões da conta. |
| O navegador conclui, mas o cliente continua desconectado | Callback local expirado, bloqueado ou pertencente a outra tentativa. | Feche a tentativa, inicie uma nova conexão no cliente e conclua somente a URL mais recente. Não reutilize links de callback. |
| 401 ou pedido de login repetido | Token ausente, expirado ou revogado. | Desconecte a Aivyro no cliente, remova a autorização antiga e conecte novamente. |
| A ferramenta esperada não aparece | Escopo, papel, política, licença ou saúde do serviço não admite a ferramenta. | Atualize tools/list, confira a organização e as permissões e não use uma lista de ferramentas em cache. |
| A ação pede confirmação e não avança | O cliente não concluiu ou não suporta a solicitação de confirmação. | Aprove ou recuse no cliente. Se não houver interface de confirmação, use um cliente compatível; a Aivyro não executa a ação silenciosamente. |
| A ferramenta retorna 403 | A autenticação funcionou, mas a ação não é permitida para aquele usuário ou recurso. | Não repita com IDs diferentes. Confira o papel e solicite a permissão correta ao administrador. |
| A ferramenta retorna 429 | O limite de chamadas foi atingido. | Aguarde o tempo indicado, reduza repetição e paginação agressiva e tente novamente. |
Refazer a configuração
Troque codex pelo identificador do seu cliente. Depois, recarregue o cliente e complete uma nova autorização. Remover a configuração local não revoga sozinho um token já concedido.
O que enviar ao suporte
- Nome e versão do cliente e do pacote @aivyro/mcp.
- Horário aproximado, organização afetada e nome da ferramenta.
- Código público do erro e traceId, quando exibido.
- O passo que falhou: descoberta, navegador, callback, tools/list ou tools/call.