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á.
Usando o MCP com o Amazon Q Developer
O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA interajam com ferramentas e serviços externos. O Amazon Q Developer CLI agora oferece suporte ao MCP, permitindo que você amplie os recursos do Q conectando-o a ferramentas e serviços personalizados.
Tópicos
Carregamento do servidor 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.
Verificando o status do servidor
Você pode usar o /tools comando para ver quais servidores ainda estão carregando e quais ferramentas já estão disponíveis.
Configurando a inicialização do servidor
Você pode personalizar o tempo limite de inicialização do servidor usando:
$ q settings mcp.initTimeout [value]
Onde [value] está 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 instruções
Esta seção aborda como usar as ferramentas e os prompts do MCP com o Amazon Q Developer CLI.
Entendendo as ferramentas MCP
As ferramentas MCP são funções executáveis que os servidores MCP expõem ao Amazon Q Developer CLI. Eles 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 exclusivo para a ferramenta
-
Descrição: uma descrição legível por humanos 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
Descobrindo as ferramentas disponíveis
Para ver quais ferramentas estão disponíveis em sua sessão do Q CLI:
/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:
-
Aprovado 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
Você pode usar as ferramentas MCP de duas maneiras:
-
Solicitações de linguagem natural: simplesmente descreva o que você deseja fazer e Q determinará qual ferramenta usar.
-
Invocação direta da ferramenta: você também pode solicitar explicitamente que Q use uma ferramenta específica.
Trabalhando com prompts
Os servidores MCP podem fornecer solicitações predefinidas que ajudam a orientar 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 MCP
-
Padronização: use um protocolo consistente suportado por vários assistentes de IA
-
Flexibilidade: o MCP permite que você alterne entre diferentes fornecedores de LLM enquanto mantém as mesmas integrações de ferramentas
-
Segurança: mantenha seus dados em sua infraestrutura com servidores MCP locais
Arquitetura MCP
O MCP segue uma arquitetura cliente-servidor em que:
-
MCP Hosts: programas como o Amazon Q Developer CLI que desejam acessar dados por meio do MCP
-
Clientes MCP: clientes de protocolo que mantêm conexões 1:1 com servidores
-
Servidores MCP: programas leves, cada um expondo recursos específicos por meio do Model Context Protocol 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 MCP
User | v +------------------+ +-----------------+ +------------------+ | | | | | | | Amazon Q Dev | --> | MCP Client API | --> | MCP Server | | | | | | | +------------------+ +-----------------+ +------------------+ | v +------------------+ | | | External Service | | | +------------------+
Fluxo de comunicação entre usuário, Amazon Q Developer CLI e serviços externos por meio do MCP
Conceitos básicos do MCP
Ferramentas
As ferramentas são funções executáveis que os servidores MCP expõem aos clientes. Eles permitem que a Amazon Q:
-
Execute ações em sistemas externos
-
Processe dados de forma especializada
-
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 o 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:
-
Aceite argumentos dinâmicos
-
Inclua o contexto dos recursos
-
Encadeie várias interações
-
Guie fluxos de trabalho específicos
-
Superfície como elementos de interface do usuário (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
