View a markdown version of this page

Use o Inspector MCP - Amazon Bedrock AgentCore
Solução de problemas

Use o Inspector MCP

O MCP Inspector, disponível através 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 Inspector MCP, consulte a documentação do Inspector MCP.

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 transmissível

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

  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 Inspetor MCP.

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: certifique-se de que o URL do gateway esteja 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 garanta que seus parâmetros de entrada correspondam ao esquema da ferramenta

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