Configuração MCP para Q Developer no IDE - Amazon Q Developer

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

Configuração MCP para Q Developer no IDE

Esta página aborda as opções específicas do IDE para configurar servidores MCP. Para obter informações gerais sobre a configuração do MCP, consulte Compreendendo a configuração do MCP.

Acessando a interface de usuário de configuração do MCP

A imagem a seguir mostra a GUI usada para configurar um servidor MCP para o Q Developer no IDE.

Uma GUI com campos para os principais elementos da configuração do MCP.

Para acessar a interface de usuário de configuração do MCP no Q Developer no IDE:

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

  2. Abra o painel Q Developer.

  3. Abra o painel Chat.

  4. Escolha o ícone de ferramentas. tools icon

Adicionando um servidor MCP

Para adicionar um servidor MCP ao IDE:

  1. Acesse a interface de usuário de configuração 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 and available across all your projects. If you select local scope, the configuration is stored in .amazonq/mcp.json em seu projeto atual.

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

    Por exemplo, se estivéssemos instalando o servidor MCP de AWS documentação, o nome poderia serAWS DocMCPServer.

  5. Selecione o protocolo de transporte.

    No momento, só há compatibilidade com stdio.

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

    No caso do AWS Documentation MCP Server, o comando éuvx. Esse é um alias parauv 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 AWS Documentation MCP Server, 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ção será substituído pelo painel de permissões da ferramenta.

  11. Siga o procedimento abaixoRevisando e ajustando as permissões da ferramenta.

Solucionando problemas na 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.

Habilitando um servidor MCP

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

Para habilitar um servidor MCP no IDE:

  1. Abra o painel Servidores MCP.

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

Desabilitando um servidor MCP

Para desativar um servidor MCP no IDE:

  1. Abra o painel Servidores MCP.

  2. Escolha o servidor que você deseja desativar.

  3. Escolha os três pontos ao lado de Editar configuração.

  4. Escolha Desativar servidor MCP.

Excluindo um servidor MCP atualmente habilitado

Para excluir um servidor MCP atualmente habilitado no IDE:

  1. Abra o painel Servidores MCP.

  2. Escolha o servidor que você deseja excluir.

    Um painel será aberto com detalhes sobre esse servidor.

  3. Escolha os três pontos ao lado de Editar configuração.

  4. Escolha Excluir servidor MCP.

  5. Confirme a exclusão quando solicitado.

Excluindo um servidor MCP atualmente desativado

Para excluir um servidor MCP atualmente desativado do IDE:

  1. Abra o painel Servidores MCP.

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

  3. Confirme a exclusão quando solicitado.

Revisando e ajustando as permissões da ferramenta

Para revisar e ajustar as permissões da ferramenta:

  1. Abra o painel Servidores MCP.

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

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

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

    • Sempre permitir: permita que a ferramenta seja executada sem aviso prévio.

    • Negar: Não use essa ferramenta.

  4. Escolha Salvar ou Aplicar para atualizar as configurações de permissão.