Usar o MCP com o Amazon Q Developer - Amazon Q Developer
Configuração do MCPFerramentas e promptsBenefícios principaisArquitetura do MCPConceitos principais do MCP

Usar o MCP com o Amazon Q Developer

O protocolo de contexto para modelos (MCP) é um padrão aberto que permite que assistentes de IA interajam com ferramentas e serviços externos. A CLI do Amazon Q Developer agora oferece suporte ao MCP, permitindo que você amplie os recursos do Q conectando-o a ferramentas e serviços personalizados.

Tópicos

Configuração do MCP

Desabilitar o MCP para sua organização

Dependendo da sua configuração, você pode ter a opção de desabilitar os servidores MCP para sua conta da AWS ou organização no console do Amazon Q Developer. Isso se aplicará se:

  • Você estiver gerenciando uma organização da sua conta gerencial ou usando uma conta autônoma.

  • Você estiver usando o Amazon Q Developer em um IDE compatível.

nota

Essa configuração é aplicada no lado do cliente. Esteja ciente de que seus usuários finais podem contornar isso.

Para desabilitar o MCP em sua conta ou organização:

  1. Abra o console do Amazon Q Developer.

  2. Escolha Settings.

  3. Em Preferências, escolha Editar.

  4. No pop-up Editar preferências, desative o Protocolo de contexto para modelos (MCP).

  5. Escolha Salvar.

Configurar servidores MCP com a CLI do Q

A configuração do MCP para a CLI do Amazon Q definida globalmente é feita em:

~/.aws/amazonq/cli-agents

Para obter mais informações, consulte o guia de configuração do agente personalizado no repositório Github da CLI do Q.

Configurar servidores MCP com o Q no IDE

A configuração do MCP para o Amazon Q no IDE é feita em:

~/.aws/amazonq/agents/default.json

Para obter mais informações, consulte Configurar o MCP para o Q Developer no IDE.

Carregar servidores MCP

O Amazon Q carrega servidores MCP em segundo plano, permitindo que você comece a interagir imediatamente sem esperar que todos os servidores sejam inicializados. As ferramentas ficam disponíveis progressivamente à medida que seus respectivos servidores terminam de carregar.

Verificar status do servidor

Você pode usar o comando /tools para ver quais servidores ainda estão carregando e quais ferramentas já estão disponíveis.

Configurar inicialização do servidor

Você pode personalizar o tempo limite de inicialização do servidor usando:

$ q settings mcp.initTimeout [value]

Em que [value] é o tempo limite em milissegundos. Essa configuração controla quanto tempo o Amazon Q aguardará a inicialização dos servidores antes de permitir que você comece a interagir.

Ferramentas e prompts

Esta seção aborda como usar as ferramentas e prompts do MCP com a CLI do Amazon Q Developer.

Noções básicas sobre ferramentas do MCP

As ferramentas do MCP são funções executáveis que os servidores MCP expõem à CLI do Amazon Q Developer. Elas permitem que o Amazon Q Developer execute ações, processe dados e interaja com sistemas externos em seu nome.

Cada ferramenta no MCP tem:

  • Nome: um identificador único para a ferramenta

  • Descrição: uma descrição humanamente legível do que a ferramenta faz

  • Esquema de entrada: um esquema JSON que define os parâmetros que a ferramenta aceita

  • Anotações: dicas opcionais sobre o comportamento e os efeitos da ferramenta

Descobrir as ferramentas disponíveis

Para ver quais ferramentas estão disponíveis em sua sessão da CLI do Q:

/tools

Esse comando exibe todas as ferramentas disponíveis, incluindo as ferramentas integradas e as fornecidas pelos servidores MCP.

As ferramentas podem ter diferentes níveis de permissão que determinam como elas são usadas:

  • Aprovada automaticamente: essas ferramentas podem ser usadas sem permissão explícita para cada invocação

  • Requer aprovação: essas ferramentas precisam de sua permissão explícita sempre que são usadas

  • Perigosas: essas ferramentas são marcadas como potencialmente arriscadas e exigem uma análise cuidadosa antes da aprovação

Como usar ferramentas do

É possível usar as ferramentas do MCP de duas maneiras:

  1. Solicitações de linguagem natural: simplesmente descreva o que você deseja fazer e o Q determinará qual ferramenta usar.

  2. Invocação direta da ferramenta: você também pode solicitar explicitamente que o Q use uma ferramenta específica.

Trabalhar com prompts

Os servidores MCP podem fornecer prompts predefinidos que ajudam a orientar o Q em tarefas específicas:

  • Liste os prompts disponíveis: /prompts

  • Use um prompt:

    • @ prompt-name arg1 arg2

Exemplo de uso de um prompt com argumentos:

@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html

Benefícios principais

  • Extensibilidade: conecte o Amazon Q a ferramentas especializadas para domínios ou fluxos de trabalho específicos

  • Personalização: crie ferramentas personalizadas adaptadas às suas necessidades específicas

  • Integração de ecossistemas: aproveite o crescente ecossistema de ferramentas compatíveis com o MCP

  • Padronização: use um protocolo consistente compatível com vários assistentes de IA

  • Flexibilidade: o MCP permite que você alterne entre diferentes provedores de LLM enquanto mantém as mesmas integrações de ferramentas

  • Segurança: mantenha seus dados em sua infraestrutura com servidores MCP locais

Arquitetura do MCP

O MCP segue uma arquitetura cliente-servidor em que:

  • Hosts MCP: programas como a CLI do Amazon Q Developer que desejam acessar dados pelo MCP

  • Clientes MCP: clientes de protocolo que mantêm conexões 1:1 com servidores

  • Servidores MCP: programas leves que expõem recursos específicos pelo protocolo de contexto para modelos padronizado

  • Fontes de dados locais: arquivos, bancos de dados e serviços do seu computador que os servidores MCP podem acessar com segurança

  • Serviços remotos: sistemas externos disponíveis pela internet (por exemplo, por APIs) aos quais os servidores MCP podem se conectar

exemplo Fluxo de comunicação do MCP

  User
   |
   v
+------------------+     +-----------------+     +------------------+
|                  |     |                 |     |                  |
| Amazon Q Dev     | --> | MCP Client API  | --> | MCP Server       |
|                  |     |                 |     |                  |
+------------------+     +-----------------+     +------------------+
                                                        |
                                                        v
                                                 +------------------+
                                                 |                  |
                                                 | External Service |
                                                 |                  |
                                                 +------------------+

Fluxo de comunicação entre o usuário, a CLI do Amazon Q Developer e os serviços externos pelo MCP

Conceitos principais do MCP

Ferramentas

As ferramentas são funções executáveis que os servidores MCP expõem aos clientes. Elas permitem que o Amazon Q:

  • Execute ações em sistemas externos

  • Processe dados de maneiras especializadas

  • Interaja com APIs e serviços

  • Execute comandos em seu nome

As ferramentas são definidas com um nome exclusivo, uma descrição, um esquema de entrada (usando esquema JSON) e anotações opcionais sobre o comportamento da ferramenta.

Solicitações

Os prompts são modelos predefinidos que ajudam a orientar o Amazon Q em tarefas específicas. Ele pode:

  • Aceitar argumentos dinâmicos

  • Incluir o contexto dos recursos

  • Encadear múltiplas interações

  • Orientar fluxos de trabalho específicos

  • Aparecer como elementos de IU (como comandos de barra)

Recursos

Os recursos representam dados que os servidores MCP podem fornecer ao Amazon Q, como:

  • Conteúdo do arquivo

  • Registros do banco de dados

  • Respostas da API

  • Documentação

  • Dados de configuração