Configurar o MCP para o Q Developer no IDE - Amazon Q Developer
Com o IDEAdicionar um servidor MCPSolucionar problemas de configuração do MCPHabilitar um servidor MCPDesabilitar um servidor MCPExcluir um servidor MCP atualmente habilitadoExcluir um servidor MCP atualmente desabilitadoRevisar e ajustar as permissões da ferramenta

Configurar o MCP para o Q Developer no IDE

Esta página aborda as opções específicas do IDE para configurar servidores MCP.

Acessar a IU de configurações do MCP

Como acessar a IU de configurações do MCP no Q Developer no IDE:

  1. Abra seu IDE (VS Code, JetBrains etc.).

  2. Abra o painel do Q Developer.

  3. Abra o painel Chat.

  4. Escolha o ícone de ferramentas. tools icon

Adicionar um servidor MCP

Existem dois mecanismos principais de transporte para comunicação entre clientes de IA e servidores MCP: STDIO e HTTP.

Adicionar um servidor HTTP MCP

Como adicionar um servidor HTTP MCP ao IDE:

  1. Acesse a IU de configurações do MCP.

  2. Escolha o símbolo de adição (+).

  3. Selecione o escopo: global ou local.

    Se você selecionar o escopo global, a configuração do servidor MCP será armazenada em ~/.aws/amazonq/agents/default.json e estará disponível em todos os seus projetos. Se você selecionar o escopo local, a configuração será armazenada em .aws/amazonq/agents/default.json no seu projeto atual.

  4. No campo Nome, insira o nome do servidor MCP.

  5. Selecione http como o protocolo de transporte.

  6. No campo URL, insira o URL que o servidor MCP chamará ao inicializar.

  7. Em Cabeçalhos - opcional, você pode inserir pares de valores-chave que devem ser enviados como cabeçalhos de solicitação HTTP.

  8. Insira um valor de tempo limite, conforme aplicável.

  9. Escolha Salvar.

    O painel de configurações será substituído pelo painel de permissões da ferramenta.

  10. Siga o procedimento em Revisar e ajustar as permissões da ferramenta.

nota

Se o endpoint HTTP do MCP exigir autorização, o Amazon Q abrirá automaticamente uma página do navegador para que você possa autorizar o Amazon Q a acessar o servidor MCP.

Adicionar um servidor MCP STDIO

Como adicionar um servidor MCP STDIO ao IDE:

  1. Acesse a IU de configurações do MCP.

  2. Escolha o símbolo de adição (+).

  3. Selecione o escopo: global ou local.

    Se você selecionar o escopo global, a configuração do servidor MCP será armazenada em ~/.aws/amazonq/mcp.json e estará disponível em todos os seus projetos. Se você selecionar o escopo local, a configuração será armazenada em .amazonq/mcp.json no seu projeto atual.

  4. No campo Nome, insira o nome do servidor MCP.

    Por exemplo, se estivéssemos instalando o servidor MCP da documentação da AWS, o nome poderia ser AWSDocMCPServer.

  5. Selecione stdio como o protocolo de transporte.

  6. No campo Comando, insira o comando shell que o servidor MCP executará ao inicializar.

    No caso do servidor MCP da documentação da AWS, o comando é uvx. Esse é um alias para uv tool run, que cria um ambiente Python efêmero.

  7. No campo Argumentos, insira um argumento a ser fornecido ao comando shell, se aplicável.

    No caso do servidor MCP da documentação daAWS, o argumento é awslabs.aws-documentation-mcp-server@latest. Esse é um identificador de pacote Python que aponta para um pacote hospedado no PyPI (Python Package Index).

    Adicione mais argumentos conforme necessário.

  8. Preencha as variáveis de ambiente conforme aplicável.

    No caso do nosso exemplo, primeiro preenchemos Nome: FASTMCP_LOG_LEVEL e Valor: ERROR.

    Também usaremos o nome AWS_DOCUMENTATION_PARTITION e o valor aws para indicar a partição com a qual trabalharemos.

  9. Insira um valor de tempo limite, conforme aplicável.

    No nosso exemplo, manteremos o valor recomendado de 60 (segundos).

  10. Escolha Salvar.

    O painel de configurações será substituído pelo painel de permissões da ferramenta.

  11. Siga o procedimento em Revisar e ajustar as permissões da ferramenta.

Solucionar problemas de configuração do MCP

Depois de adicionar um servidor MCP no IDE, o Amazon Q tentará se conectar a ele.

Se houver problemas de conexão, um alerta será exibido na parte superior do painel. Você não deve esperar que as ferramentas desse servidor MCP funcionem adequadamente até que o alerta seja resolvido.

Escolha Corrigir configuração para retornar à tela de configuração do MCP para que você possa fazer as alterações apropriadas.

Habilitar um servidor MCP

O procedimento a seguir pressupõe que o servidor MCP em questão ainda não esteja habilitado.

Como habilitar um servidor MCP no IDE:

  1. Abra o painel Servidores MCP.

  2. Ao lado do servidor que deseja habilitar, escolha Habilitar.

Desabilitar um servidor MCP

Como desabilitar um servidor MCP no IDE:

  1. Abra o painel Servidores MCP.

  2. Escolha o servidor que deseja desabilitar.

  3. Clique nos três pontos ao lado de Editar configuração.

  4. Escolha Desabilitar servidor MCP.

Excluir um servidor MCP atualmente habilitado

Como excluir um servidor MCP atualmente habilitado no IDE:

  1. Abra o painel Servidores MCP.

  2. Escolha o servidor que deseja excluir.

    Um painel será aberto com detalhes sobre esse servidor.

  3. Clique nos três pontos ao lado de Editar configuração.

  4. Escolha Excluir servidor MCP.

  5. Quando solicitado, confirme a exclusão.

Excluir um servidor MCP atualmente desabilitado

Como excluir um servidor MCP atualmente desabilitado do IDE:

  1. Abra o painel Servidores MCP.

  2. Ao lado do servidor que você deseja excluir, selecione Excluir.

  3. Quando solicitado, confirme a exclusão.

Revisar e ajustar as permissões da ferramenta

Como revisar e ajustar as permissões da ferramenta:

  1. Abra o painel Servidores MCP.

  2. Escolha o servidor MCP para o qual deseja revisar e ajustar as permissões.

  3. Para cada ferramenta, você pode definir um dos seguintes níveis de permissão:

    • Perguntar: solicitar permissão sempre que a ferramenta for usada.

    • Sempre permitir: permitir que a ferramenta seja executada sem solicitação.

    • Negar: não usar essa ferramenta.