View a markdown version of this page

Use o Inspetor MCP - Base da Amazônia AgentCore
Solução de problemas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Use o Inspetor MCP

O MCP Inspector, disponível por meio do Model Context Protocol (MCP), é uma ferramenta de desenvolvedor que ajuda você a testar e depurar servidores MCP por meio de uma interface interativa. Você pode conectar seu AgentCore gateway ao inspetor MCP para ajudá-lo a depurar seus alvos de gateway.

Para obter mais informações sobre o MCP Inspector, consulte a documentação do MCP Inspector.

Para conectar seu gateway ao inspetor

  1. Abra um terminal e execute npx @modelcontextprotocol/inspector para fazer o seguinte:

    1. Instale o inspetor

    2. Inicie o inspetor no localhost.

    3. Gere um token de sessão para autenticação.

    4. Abra seu navegador na interface do inspetor.

  2. Na interface do inspetor, configure os seguintes campos:

    • Tipo de transporte — Selecione HTTP transmitido

    • URL — Insira a URL do endpoint do gateway retornada quando você criou seu gateway.

    • Expanda a autenticação. A seção Cabeçalhos personalizados deve ser pré-preenchida com um par de valores-chave.

      • O nome da chave deve serAuthorization.

      • Substitua o valor pelas credenciais de autorização de entrada do seu gateway.

  3. Selecione Conectar. Você será conectado ao seu gateway. Você pode usar o MCP Inspector como uma ferramenta para examinar e testar seu gateway antes de integrá-lo ao seu agente.

Para obter mais informações sobre como você pode inspecionar o servidor MCP ao qual seu gateway está conectado, consulte Visão geral do recurso na documentação do MCP Inspector.

Importante

O MCP Inspector é uma ferramenta de desenvolvimento e não deve ser usado em ambientes de produção. Sempre proteja seus tokens de acesso e credenciais de gateway.

Solução de problemas

Se você encontrar problemas ao usar o MCP Inspector com seu gateway, verifique o seguinte:

  • Problemas de conexão: verifique se o URL do gateway está correto e acessível a partir da sua rede

  • Problemas de autenticação: verifique se seu token de acesso é válido e não expirou

  • Erros de invocação da ferramenta: verifique as mensagens de erro na resposta e certifique-se de que seus parâmetros de entrada correspondam ao esquema da ferramenta

  • Erros de proxy: Se você ver erros relacionados à conexão de proxy, tente reiniciar o MCP Inspector