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.

Para acessar a interface de usuário de configuração do MCP no Q Developer no IDE:
-
Abra seu IDE (VS Code JetBrains, etc.).
-
Abra o painel Q Developer.
-
Abra o painel Chat.
-
Escolha o ícone de ferramentas.
Adicionando um servidor MCP
Para adicionar um servidor MCP ao IDE:
-
Escolha o símbolo de adição (+).
-
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.
-
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 ser AWS DocMCPServer
. -
Selecione o protocolo de transporte.
No momento, só há compatibilidade com
stdio
. -
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. -
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.
-
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 valoraws
para indicar a partição com a qual trabalharemos. -
Insira um valor de tempo limite, conforme aplicável.
No nosso exemplo, manteremos o valor recomendado de 60 (segundos).
-
Escolha Salvar.
O painel de configuração será substituído pelo painel de permissões da ferramenta.
-
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:
-
Abra o painel Servidores MCP.
-
Ao lado do servidor que você deseja habilitar, escolha Habilitar.
Desabilitando um servidor MCP
Para desativar um servidor MCP no IDE:
-
Abra o painel Servidores MCP.
-
Escolha o servidor que você deseja desativar.
-
Escolha os três pontos ao lado de Editar configuração.
-
Escolha Desativar servidor MCP.
Excluindo um servidor MCP atualmente habilitado
Para excluir um servidor MCP atualmente habilitado no IDE:
-
Abra o painel Servidores MCP.
-
Escolha o servidor que você deseja excluir.
Um painel será aberto com detalhes sobre esse servidor.
-
Escolha os três pontos ao lado de Editar configuração.
-
Escolha Excluir servidor MCP.
-
Confirme a exclusão quando solicitado.
Excluindo um servidor MCP atualmente desativado
Para excluir um servidor MCP atualmente desativado do IDE:
-
Abra o painel Servidores MCP.
-
Ao lado do servidor que você deseja excluir, escolha Excluir.
-
Confirme a exclusão quando solicitado.
Revisando e ajustando as permissões da ferramenta
Para revisar e ajustar as permissões da ferramenta:
-
Abra o painel Servidores MCP.
-
Escolha o servidor MCP para o qual você deseja revisar e ajustar as permissões.
-
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.
-
-
Escolha Salvar ou Aplicar para atualizar as configurações de permissão.