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.
**Topics**
+ [Visão geral do MCP](qdev-mcp-overview.md)
+ [Configuração do MCP na CLI](command-line-mcp-config-CLI.md)
+ [Configuração do MCP](#mcp-configuration)
+ [Ferramentas e prompts](#command-line-mcp-tools-prompts)
+ [Configurar o MCP para o Q Developer no IDE](mcp-ide.md)
+ [Benefícios principais](#command-line-mcp-benefits)
+ [Arquitetura do MCP](#command-line-mcp-architecture)
+ [Conceitos principais do MCP](#command-line-mcp-concepts)
+ [Segurança do MCP](command-line-mcp-security.md)
+ [Governança de MCP para Q Developer](mcp-governance.md)
## 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.](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#mcpservers-field) [Servidores MCP remotos](command-line-mcp-config-CLI.md#command-line-mcp-remote-servers)
### 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](mcp-ide.md).
### 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.
1. **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 meio de APIs) aos quais os servidores MCP podem se conectar
**Example 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