Configurar o MCP para o Q Developer no IDE - Amazon Q Developer
Arquivos de configuração do MCP IDEAcessando a interface do usuárioAdicionar 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

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

Configurar o MCP para o Q Developer no IDE

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

Entendendo os arquivos de configuração MCP para Q Developer no IDE

Quando você usa a GUI para adicionar um servidor MCP ao Q Developer no IDE, a configuração é armazenada em um dos dois arquivos:

  • No escopo global: ~/. aws/amazonq/default.json

  • No escopo local: .amazonq/default.json

No entanto, por motivos legados, também é possível colocar as informações de configuração do MCP em dois outros locais:

  • No escopo global: ~/. aws/amazonq/mcp.json

  • No escopo local: .amazonq/mcp.json

O Q Developer dá precedência às configurações em nível de espaço de trabalho para servidores MCP, suas permissões e as configurações armazenadas.

nota

Se você já tiver definido uma configuração MCP em um arquivo mcp.json e estiver usando a GUI de configuração MCP pela primeira vez, verá essa configuração na GUI.

O suporte para arquivos mcp.json legados é habilitado pelo campo useLegacyMcp Json em seu arquivo de configuração global default.json. Por padrão, esse campo é definido como verdadeiro. Para obter mais informações, consulte UseLegacyMcpJson Campo no repositório Q Developer CLI GitHub .

Observe que os arquivos mcp.json também podem ser usados pela Q CLI.

Para obter informações sobre como definir controles granulares nas ferramentas MCP, consulte a referência de ferramentas integradas.

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/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json em 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/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default.json em seu projeto atual.

  4. No campo Nome, insira 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 stdio como o protocolo de transporte.

  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 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 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çõ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.