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á.
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
Configurar servidores MCP com a CLI do Q
A configuração MCP definida globalmente para o Amazon Q CLI é tratada em:
~/.aws/amazonq/cli-agents
O Amazon Q Developer CLI oferece suporte a servidores MCP locais (que são executados como processos) e servidores MCP remotos (que se comunicam por HTTP). Os servidores remotos podem usar OAuth autenticação ou ser abertos sem a necessidade de autenticação.
Para obter mais informações, consulte o guia de configuração do agente personalizado no repositório Q CLI Github e.
Configurar servidores MCP com o Q no IDE
A configuração MCP definida globalmente para o Amazon Q no IDE é tratada 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:
-
Solicitações de linguagem natural: simplesmente descreva o que você deseja fazer e o Q determinará qual ferramenta usar.
-
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-namearg1 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 meio de 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
