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 IDE-specific opções para configurar servidores MCP. ## Compreendendo 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 LegacyMcpJson campo use 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](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#uselegacymcpjson-field) 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 das Built-in ferramentas.](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field) ## 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.). 1. Abra o painel do Q Developer. 1. Abra o painel **Chat**. 1. Escolha o ícone de ferramentas. ![tools icon](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/tools-icon-full.png) ## 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](#mcp-ide-configuration-access-ui). 1. Escolha o símbolo de adição (\+). 1. 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 e disponível em todos os seus projetos. Se você selecionar o escopo local, a configuração será armazenada em. amazonq/default.json em seu projeto atual. 1. No campo **Nome**, insira o nome do servidor MCP. 1. Selecione `http` como o protocolo de transporte. 1. No campo **URL**, insira o URL que o servidor MCP chamará ao inicializar. 1. Em **Cabeçalhos - opcional**, você pode inserir pares de valores-chave que devem ser enviados como cabeçalhos de solicitação HTTP. 1. Insira um valor de **tempo limite**, conforme aplicável. 1. Escolha **Salvar**. O painel de configurações será substituído pelo painel de permissões da ferramenta. 1. Siga o procedimento em [Revisar e ajustar as permissões da ferramenta](#mcp-ide-configuration-review-adjust-tool). **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](#mcp-ide-configuration-access-ui). 1. Escolha o símbolo de adição (\+). 1. 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 e disponível em todos os seus projetos. Se você selecionar o escopo local, a configuração será armazenada em. amazonq/default.json em seu projeto atual. 1. No campo **Nome**, insira o nome do servidor MCP. Por exemplo, se estivéssemos instalando o [servidor MCP de AWS documentação](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/), o nome poderia ser{{AWS DocMCPServer}}. 1. Selecione `stdio` como o protocolo de transporte. 1. 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. 1. 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. 1. 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](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html) com a qual trabalharemos. 1. Insira um valor de **tempo limite**, conforme aplicável. No nosso exemplo, manteremos o valor recomendado de 60 (segundos). 1. Escolha **Salvar**. O painel de configurações será substituído pelo painel de permissões da ferramenta. 1. Siga o procedimento em [Revisar e ajustar as permissões da ferramenta](#mcp-ide-configuration-review-adjust-tool). ## 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. 1. 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. 1. Escolha o servidor que deseja desabilitar. 1. Clique nos três pontos ao lado de **Editar configuração**. 1. 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. 1. Escolha o servidor que deseja excluir. Um painel será aberto com detalhes sobre esse servidor. 1. Clique nos três pontos ao lado de **Editar configuração**. 1. Escolha **Excluir servidor MCP**. 1. 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. 1. Ao lado do servidor que você deseja excluir, selecione **Excluir**. 1. 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. 1. Escolha o servidor MCP para o qual deseja revisar e ajustar as permissões. 1. 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.