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.

2. Escolha a guia MCP.

3. Escolha + Adicionar MCP.

4. Escolha Local como o tipo de conexão.

5. Insira um Nome e o Comando a ser executado (por exemplo,python).

6. Insira quaisquer argumentos que o comando exija (por exemplo,-m my_mcp_server).

7. 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.

2. Escolha a guia MCP.

3. Escolha + Adicionar MCP.

4. Escolha Importar como o tipo de conexão.

5. Insira o caminho do arquivo Config para seu arquivo de configuração MCP existente.

6. Analise os servidores e as ferramentas do sistema detectados.

7. 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.

2. Escolha a guia MCP.

3. Escolha + Adicionar MCP.

4. Escolha Remoto como o tipo de conexão.

5. Insira um nome e a URL do endpoint MCP.

6. (Opcional) Insira um token se o servidor exigir autenticação.

7. 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.

2. Escolha a guia MCP.

3. Na seção Agentes de codificação, escolha + Adicionar agente.

4. Defina as configurações de conexão do agente.

5. 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.