Ações MCP

O MCP (Model Context Protocol) é um padrão aberto que permite que uma IA use as ferramentas de outro serviço diretamente. Em vez de você descrever um endpoint e seus parâmetros manualmente, um servidor MCP publica as próprias ferramentas, e seu Agente de IA as descobre e utiliza.

Na maioria dos serviços, conectar leva um único clique. Vá em Ações & MCPs, clique em + Adicionar ação e escolha MCP.

Conectar pelo catálogo

A tela de MCP abre em um catálogo pesquisável de serviços conhecidos, agrupados por categoria (Populares, Suporte ao cliente, CRM & vendas, Agendamento, E-commerce, Pagamentos & faturamento, Marketing & email, Comunicação, Produtividade, Dados & analytics, Busca & web, Viagens & reservas, Design, Desenvolvimento & infra).

1. Encontre o serviço desejado, navegando pelo catálogo ou pelo campo de busca.
2. Clique no cartão dele. O Quickchat verifica o servidor e descobre as ferramentas que ele oferece.
3. Se o serviço exigir login, aparece um painel Autorização necessária. Clique em Conectar com <serviço>, aprove o acesso na janela pop-up que abrir e o painel passa para o estado conectado.
4. A ação é criada, ativada e suas ferramentas são listadas. Seu Agente de IA já pode usá-las a partir da próxima mensagem.

Nota

Depois que você inicia a autorização, o Quickchat mantém a ação e a autorização pendente caso feche o painel Ações ou o pop-up de autorização. Abra a ação novamente e clique em Abrir a autorização novamente para continuar ou em Cancelar para interromper. Se o provedor concluir a autorização depois que você fechar o painel, o Quickchat conclui a conexão em segundo plano e ativa a ação assim que houver capacidade disponível no seu plano.

Dica

Seu navegador precisa permitir pop-ups no painel do Quickchat, caso contrário a janela de autorização não consegue abrir. Se estiver bloqueada, você verá uma mensagem pedindo para liberar pop-ups e tentar de novo.

Conectar um servidor que não está no catálogo

Clique em Inserir uma URL manualmente, abaixo do catálogo, e então:

1. Cole a URL do servidor MCP (precisa começar com https://).
2. Se o servidor se autentica com um token fixo em vez de um fluxo de login, abra Cabeçalhos de conexão (opcional) e adicione o cabeçalho esperado, por exemplo Authorization: Bearer <seu-token>.
3. Clique em Conectar.

Use Explorar o catálogo para voltar à visualização em cartões. Se faltar um serviço de que você precisa, Falta uma integração? Sugira uma abre um e‑mail pré-preenchido para nossa equipe.

Escolher quais ferramentas a IA pode usar

Depois de conectada, a ação lista em Ferramentas tudo o que o servidor expõe, cada item com seu próprio botão de ativação. Desative o que você não quer que a IA chame: em um servidor de reservas, as consultas somente de leitura podem ficar ativas enquanto a ferramenta de cancelamento fica desativada.

A Ativação padrão da ferramenta define o que acontece quando o servidor adiciona uma ferramenta nova mais tarde: ativada, as novas ferramentas ficam disponíveis imediatamente; desativada, você habilita cada uma deliberadamente.

Algumas entradas do catálogo exibem o selo Ajustado pela Quickchat. A Quickchat testou esses servidores de ponta a ponta e oferece uma seleção focada de ferramentas, as regras de memória de que elas precisam e uma Mensagem de espera para cada uma. Selecione Usar recomendadas para ver o que a configuração testada mudaria: o diálogo Aplicar a configuração recomendada? lista as ferramentas que ele ativa e desativa e as regras de memória que define, e avisa se fosse sobrescrever regras que você mesmo editou. Nada é salvo até você salvar a Action, e depois você ainda pode ajustar cada ferramenta.

Dica

O Nome da ação MCP e a Descrição da ação MCP são rótulos para você e sua equipe: identificam a ação na lista de Ações, e a IA nunca os lê. O que orienta a IA são as descrições de ferramentas publicadas pelo próprio servidor MCP, junto com o Prompt principal do seu Agent. Para direcioná-la, nomeie ali as situações em que o Agent deve usar as ferramentas desse servidor (“responda a todas as consultas sobre projetos com as ferramentas do Linear”) e fixe os valores que o modelo teria de adivinhar (“pesquise sempre no workspace acme-eng”). Se você conectar o mesmo servidor duas vezes, nomeie cada conexão pela tarefa (“Notion central de ajuda”, “Notion solicitações de suporte”) e não pelo fornecedor.

Salvar o resultado de uma ferramenta MCP na memória

Expanda uma ferramenta e use Salvar na memória quando um valor do resultado for necessário mais tarde na conversa. Adicione uma expressão JSONPath para o valor e uma Chave de memória para identificá-lo. É possível salvar até 10 valores de uma ferramenta.

As chaves de memória são compartilhadas com as Ações de API do agente. Se uma Ação de API já salva na mesma chave, o campo Chave de memória avisa sobre o conflito ao salvar, então escolha outra chave.

O valor salvo passa a fazer parte dos dados da conversa que a IA pode ler em turnos posteriores. Por exemplo, uma ferramenta de reserva pode salvar o URI de um evento para que uma ferramenta de cancelamento saiba exatamente qual reunião cancelar. As ferramentas MCP não usam o placeholder {{metadata_<key>}} mostrado para Ações de API porque a IA fornece os argumentos diretamente.

As alterações em massa Ativar todas e Desativar todas mantêm as regras de memória intactas. Reconectar também mantém suas escolhas de ferramentas e regras de memória enquanto atualiza a lista de ferramentas do servidor.

O que os visitantes veem

Enquanto uma ferramenta é executada, o widget de chat mostra uma breve linha de status descrevendo o que a IA está fazendo. Cada ferramenta tem um campo Mensagem de espera no painel de ferramentas: deixe-o vazio e a linha é derivada do nome da ferramenta (uma ferramenta chamada search_flights mostra “Searching flights…”), ou escreva a sua (“Pesquisando na central de ajuda”). Servidores ajustados chegam com essas mensagens preenchidas para as ferramentas que recomendam. A linha dá ao visitante algo útil durante a pausa em vez de um simples indicador de digitação.

Reconectar e desconectar

• Reconectar: executa a autorização de novo. Use se a conexão expirou, se você quer autorizar outra conta ou se a lista de ferramentas do servidor mudou e você quer incorporar as novas.
• Desconectar: revoga a autorização armazenada e tira a ação do ar. A ação em si continua na sua lista, então você pode reconectar depois sem configurar tudo outra vez.

Alterar a URL do servidor MCP de uma ação conectada limpa a autorização e desativa a ação, porque credenciais emitidas por um servidor nunca são reaproveitadas em outro. Autorize novamente para colocá-la de volta no ar.

Solução de problemas

O que você vê	O que significa
A autorização não foi concluída	O login não foi concluído. Clique em Tentar novamente. Se você negou o acesso, aprove-o na próxima tentativa. Ao entrar em contato com o suporte, inclua o código de erro exibido.
Conectado, mas o carregamento das ferramentas falhou	A autorização funcionou, mas a lista de ferramentas não carregou. Clique em Reconectar.
Nenhuma ferramenta foi encontrada neste servidor. Tente reconectar.	O servidor autorizou, mas não publicou nenhuma ferramenta. Confirme se a conta que você aprovou tem acesso aos dados que você espera.
Insira uma URL válida, começando com https://	Não foi possível ler a URL. Use o endereço https:// completo do servidor. O Quickchat sempre conecta por https, então as credenciais nunca são enviadas sem criptografia.
A ação se desativou sozinha	A autorização expirou ou foi revogada no provedor. Abra a ação e clique em Reconectar.

Nota

As ações MCP contam para a cota de Ações Personalizadas do seu plano, igual às Ações de API.