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á.
# Configurando servidores MCP
O aplicativo de desktop Amazon Quick oferece suporte ao Model Context Protocol (MCP), um padrão aberto que amplia os recursos do Quick com ferramentas e integrações personalizadas. Você pode conectar servidores MCP para fornecer acesso rápido a bancos de dados, APIs internas, ferramentas de desenvolvedor e outros sistemas que não estão disponíveis por meio de conexões integradas.
## O que é MCP?
O Model Context Protocol (MCP) é um protocolo que permite que assistentes de IA interajam com ferramentas externas e fontes de dados. Quando você conecta um servidor MCP ao Quick, as ferramentas fornecidas por esse servidor ficam disponíveis em suas conversas de bate-papo e agentes agendados. Por exemplo, você pode conectar um servidor MCP que fornece ferramentas de consulta de banco de dados e, em seguida, pedir ao Quick que consulte seu banco de dados diretamente no chat.
## Acessando as configurações do MCP
Para gerenciar seus servidores MCP, abra **Configurações** na barra lateral, escolha **Capacidades** e, em seguida, escolha a guia **MCP**.
A guia MCP exibe seus servidores conectados com uma barra de pesquisa, uma lista suspensa de filtros e uma opção de exibição em grade ou lista. Você pode adicionar novos servidores escolhendo **\+ Adicionar MCP.**
## Adicionar um servidor MCP
Quando você escolhe **\+ Adicionar MCP**, aparece uma caixa de diálogo com três tipos de conexão: **Local**, **Importar** e **Remota**. Escolha o tipo de conexão que corresponde à execução do seu servidor MCP.
### Local
Use o tipo de conexão **local** para executar um servidor MCP como um comando em sua máquina. Essa é a opção mais comum para ferramentas de desenvolvimento e servidores instalados localmente.
A tabela a seguir descreve os campos de uma conexão MCP local.
| Campo | Obrigatório | Description |
| --- | --- | --- |
| Nome | Sim | Um nome amigável para identificar esse servidor MCP (por exemplo, “My Database MCP”). |
| Comando | Sim | O executável a ser executado. Os valores comuns incluem python npxnode,, uvx e. |
| Arguments (Argumentos) | Não | Argumentos da linha de comando, separados por espaços (por exemplo,-m mcp\_server --port 8080). |
| Descrição | Não | Uma descrição do que esse servidor MCP faz e quais ferramentas ele fornece. Isso ajuda o Quick a entender quando usar as ferramentas do servidor. |
| Variáveis de ambiente | Não | Variáveis de ambiente exigidas pelo servidor. Escolha \+ Adicionar variável para adicionar pares de valores-chave. |
| Tempo limite (segundos) | Não | Tempo máximo de espera pela inicialização do servidor, de 5 a 300 segundos. O padrão é 30 segundos. |
**Para adicionar um servidor MCP local**
Use o procedimento a seguir.
1. Abra **Configurações** na barra lateral e escolha **Capacidades**.
1. Escolha a guia **MCP**.
1. Escolha **\+ Adicionar MCP.**
1. Escolha **Local** como o tipo de conexão.
1. Insira um **Nome** e o **Comando** a ser executado (por exemplo,`python`).
1. Insira quaisquer **argumentos** que o comando exija (por exemplo,`-m my_mcp_server`).
1. Escolha **\+ Adicionar MCP** para salvar.
### Importar
Use o tipo de conexão **Importar** para carregar as configurações do servidor MCP a partir de um arquivo de configuração existente. Isso é útil quando você já tem servidores MCP configurados para outras ferramentas e deseja reutilizar essa configuração no Quick.
O Quick oferece suporte aos arquivos de configuração das seguintes ferramentas.
+ Kiro
+ Claude Code
+ MIRAR
+ Antigravidade
+ QuickWork exportações
A tabela a seguir descreve os campos de uma conexão MCP de importação.
| Campo | Obrigatório | Description |
| --- | --- | --- |
| Config o caminho do arquivo | Sim | O caminho para o arquivo de configuração em sua máquina (por exemplo,\~/.kiro/settings/mcp.json). |
Quando você insere um caminho de arquivo de configuração, o Quick verifica automaticamente o arquivo e detecta os servidores MCP definidos nele. O Quick também detecta ferramentas instaladas em seu sistema e as exibe como chips (por exemplo, “Kiro”, “AIM”, “Claude Code”) **em Detectado** neste sistema.
**Para importar servidores MCP de um arquivo de configuração**
Use o procedimento a seguir.
1. Abra **Configurações** na barra lateral e escolha **Capacidades**.
1. Escolha a guia **MCP**.
1. Escolha **\+ Adicionar MCP.**
1. Escolha **Importar** como o tipo de conexão.
1. Insira o **caminho do arquivo Config para seu arquivo** de configuração MCP existente.
1. Analise os servidores e as ferramentas do sistema detectados.
1. Escolha **Carregar arquivo** para importar os servidores.
### Remotos
Use o tipo de conexão **remota** para se conectar a um servidor MCP executado em uma máquina remota ou serviço de nuvem via HTTP. Isso é útil para servidores de equipe compartilhados ou serviços MCP hospedados.
A tabela a seguir descreve os campos de uma conexão MCP remota.
| Campo | Obrigatório | Description |
| --- | --- | --- |
| Nome | Sim | Um nome amigável para identificar esse servidor MCP. |
| URL | Sim | O URL do endpoint MCP (por exemplo,https://mcp.example.com/sse). |
| Token | Não | Um token portador para autenticação com o servidor remoto. |
| Descrição | Não | Uma descrição do que esse servidor MCP faz e quais ferramentas ele fornece. |
| Tempo limite (segundos) | Não | Tempo máximo de espera pela resposta do servidor, de 5 a 300 segundos. O padrão é 30 segundos. |
**Para adicionar um servidor MCP remoto**
Use o procedimento a seguir.
1. Abra **Configurações** na barra lateral e escolha **Capacidades**.
1. Escolha a guia **MCP**.
1. Escolha **\+ Adicionar MCP.**
1. Escolha **Remoto** como o tipo de conexão.
1. Insira um **nome** e a **URL** do endpoint MCP.
1. (Opcional) Insira um **token** se o servidor exigir autenticação.
1. Escolha **\+ Adicionar MCP** para salvar.
## Gerenciando servidores MCP
Depois de adicionar servidores MCP, eles aparecem na guia MCP. Você pode gerenciar seus servidores usando os seguintes recursos.
+ **Pesquisar** — Use a barra de pesquisa para encontrar servidores pelo nome.
+ **Filtro** — Use o filtro suspenso para mostrar todos os servidores ou filtrar por status.
+ **Alternar visualização — Alterne** entre visualização em grade e visualização em lista.
+ **Alternar** — Ligue ou desative servidores MCP individuais sem removê-los.
+ **Editar** — Modificar a configuração do servidor.
+ **Remover** — Exclui uma conexão com o servidor.
## Agentes de codificação
A guia MCP também inclui uma seção **Agentes de codificação** abaixo dos servidores MCP. Os agentes de codificação usam o Agent Client Protocol (ACP) para delegar tarefas de codificação a agentes de codificação locais, como Kiro ou Claude Code.
**Para adicionar um agente de codificação**
Use o procedimento a seguir.
1. Abra **Configurações** na barra lateral e escolha **Capacidades**.
1. Escolha a guia **MCP**.
1. Na seção **Agentes de codificação**, escolha **\+ Adicionar agente**.
1. Defina as configurações de conexão do agente.
1. Salve a configuração.
Depois de configurar um agente de codificação, você pode delegar tarefas a ele a partir do chat. Por exemplo, você pode dizer “use o Kiro para refatorar esse módulo” ou “peça a Claude Code que escreva testes para essa função”. O Quick envia o trabalho para o agente de codificação e reporta os resultados para você.
## Usando ferramentas MCP em agentes agendados
Você pode conectar servidores MCP a agentes agendados como recursos. Ao criar ou editar um agente agendado, você pode selecionar a quais servidores MCP o agente tem acesso. Isso permite que seus agentes automatizados usem ferramentas personalizadas quando elas funcionam de acordo com sua programação.
Para anexar recursos MCP a um agente agendado, abra o agente em **Configurações** > **Capacidades** > **Tarefas agendadas**, escolha a guia **Capacidades** desse agente e selecione os servidores MCP que você deseja disponibilizar.
**nota**
Os servidores MCP devem estar em execução e acessíveis quando um agente agendado tenta usar suas ferramentas. Para servidores MCP locais, o processo do servidor é iniciado automaticamente quando necessário. Para servidores remotos, verifique se o servidor está on-line e acessível.