Conecte servidores MCP ao seu bot #

Os servidores MCP permitem que seu bot de IA use ferramentas de outro sistema durante conversas ao vivo — sem que você precise criar cada ferramenta manualmente. Você aponta o bot para um servidor MCP uma vez, e todas as ferramentas que esse servidor oferece tornam-se disponíveis para o bot automaticamente.

Se você já usou Funções Personalizadas, esta é a mesma ideia, levada um passo adiante: uma função personalizada é uma ferramenta única que você configura por conta própria, enquanto um servidor MCP é um pacote pronto de ferramentas que o bot pode descobrir e chamar por conta própria.

O que é um servidor MCP? #

O MCP (Model Context Protocol) é um padrão aberto para dar aos assistentes de IA acesso a ferramentas externas. Muitos aplicativos e serviços modernos agora publicam um “servidor MCP” — um único endereço da web que expõe um conjunto de ferramentas que a IA pode chamar: pesquisar algo, buscar um registro, executar uma consulta, criar um item.

Em vez de descrever cada ferramenta para o bot, você fornece ao Your AI Connector o endereço do servidor e uma chave de acesso. O Your AI Connector pergunta ao servidor “o que você pode fazer?”, recebe a lista de ferramentas e as disponibiliza para o seu bot. Quando o servidor adiciona uma nova ferramenta, seu bot pode usá-la sem qualquer configuração extra da sua parte.

Funções Personalizadas vs. Servidores MCP — qual usar:

Você pode usar ambos ao mesmo tempo no mesmo Agente.

Como funciona (versão simples) #

1. Você registra um servidor MCP na página Servidores MCP — seu endereço web e um cabeçalho de autorização (geralmente uma chave de API).
2. O Your AI Connector conecta-se e descobre as ferramentas do servidor, e memoriza a lista.
3. Você habilita o servidor em um Agente.
4. Durante uma conversa, quando o cliente pede algo que uma ferramenta pode responder, o bot chama a ferramenta, lê o resultado e responde naturalmente.

O cliente nunca vê o funcionamento interno — ele apenas recebe uma resposta baseada em informações reais e atualizadas.

Quanto custa uma chamada de ferramenta MCP #

Uma chamada de ferramenta de um servidor MCP é cobrada exatamente como uma chamada de função personalizada, de acordo com o nível de Qualidade de IA do seu Agente:

Adicionando um servidor MCP (passo a passo) #

Na barra lateral principal, em AI Studio, clique em Servidores MCP. Em seguida, clique em + Adicionar Servidor.

Preencha o formulário:

Escolhendo como entrar: Chave de API ou OAuth #

O Your AI Connector suporta duas maneiras de autenticar com um servidor. Escolha a que a documentação do servidor indicar, usando a opção Autenticação na parte superior do formulário:

• Chave de API / cabeçalho: o método original descrito acima. Você cola uma credencial fixa (uma chave de API ou token) no campo Valor do Cabeçalho de Autenticação, e o Your AI Connector a envia em cada solicitação. Ideal para servidores que fornecem uma chave de longa duração.
• OAuth (entrar): para servidores que pedem que você faça login em vez de colar uma chave. Com o OAuth, não há chave para copiar — você aprova o acesso fazendo login, da mesma forma que o “Entrar com Google” funciona em outros sites.

Para conectar com OAuth:

1. Escolha OAuth como o método de autenticação. Os campos do Cabeçalho de Autenticação desaparecem, sendo substituídos por um cartão Conectar — você não precisará de uma chave.

2. Preencha o Nome e a URL do Servidor, e clique em Salvar. O servidor é adicionado à sua lista, mas aparece como não conectado por enquanto.
3. Clique em Conectar no servidor. Uma janela de login segura será aberta, onde você aprovará o acesso.
4. Aprove e a janela fechará sozinha. O servidor agora aparecerá como conectado, e o Your AI Connector carregará suas ferramentas.

É isso. O Your AI Connector mantém a conexão atualizada automaticamente em segundo plano, então você normalmente nunca precisará mexer nela novamente. Se um servidor perder a conexão (por exemplo, o login expirar ou alguém revogá-lo do lado do servidor), ele aparecerá como desconectado — basta clicar em Reconectar e fazer login novamente.

Se o servidor não puder ser configurado automaticamente ao clicar em Conectar, será solicitado que você cole alguns detalhes (um endereço de login e um ID de cliente) fornecidos pela própria documentação do servidor, e então o Conectar finalizará o login.

Testar a Conexão #

Antes de salvar, clique em Testar Conexão. O Your AI Connector contata o servidor e mostra a lista de ferramentas que ele oferece. Esta é a maneira mais rápida de confirmar se sua URL e chave estão corretas — se a conexão falhar, você verá a mensagem de erro ali mesmo, em vez de descobrir no meio de uma conversa.

Quando o teste for bem-sucedido, clique em Salvar. Seu servidor aparecerá na lista com um ponto de status verde e o número de ferramentas que ele oferece.

Lendo a Lista de Servidores #

Cada servidor na lista mostra:

• Um ponto de status — verde quando a última conexão funcionou, vermelho quando a última tentativa falhou (passe o mouse para ver o erro), cinza antes da primeira conexão bem-sucedida.
• O endereço do servidor e quantas ferramentas ele oferece atualmente.
• Um interruptor liga/desliga para ativar ou desativar rapidamente todo o servidor sem excluí-lo.

O Your AI Connector atualiza a lista de ferramentas de cada servidor em segundo plano cerca de uma vez por dia, para que novas ferramentas apareçam automaticamente. Um servidor lento ou temporariamente inacessível nunca interrompe uma conversa — o bot simplesmente usa a última lista de ferramentas conhecida e retorna graciosamente caso uma chamada não possa ser concluída.

Escolhendo quais ferramentas o bot pode usar #

Um servidor geralmente oferece mais ferramentas do que você deseja que o bot acesse. Você pode ativar ou desativar ferramentas individuais sem desconectar o servidor inteiro.

1. Clique no ícone de lápis (editar) no servidor na lista.
2. Role até a seção Ferramentas — todas as ferramentas que o servidor oferece estão listadas, cada uma com seu próprio botão de ligar/desligar.
3. Desative qualquer ferramenta que você não queira que o bot chame, ou use Ativar tudo / Desativar tudo para configurá-las de uma só vez.
4. Clique em Salvar alterações.

Apenas as ferramentas que você deixar ativadas serão oferecidas ao bot. Uma ferramenta que está desativada é completamente invisível para o bot — ele não pode chamá-la e ela não contará para o limite de 40 ferramentas.

Duas coisas que vale a pena saber:

• Novas ferramentas permanecem desativadas até que você as ative. Depois de selecionar as ferramentas de um servidor, qualquer ferramenta que o servidor adicionar posteriormente chegará desativada, para que nada de novo fique disponível para o bot até que você decida habilitá-lo. (Servidores que você nunca selecionou mantêm todas as suas ferramentas ativadas, exatamente como antes.)
• Isso é separado da escolha do Agente abaixo. Aqui você decide quais ferramentas de um servidor existem, em toda a conta; no Agente, você decide quais servidores aquele Agente pode acessar — e, se desejar, restringir suas ferramentas ainda mais apenas para aquele Agente.

Definindo limites de execução por ferramenta #

Ao lado do botão liga/desliga de cada ferramenta, você encontrará um controle de Limites. Ele abre os mesmos limites de execução que você pode definir em uma função personalizada, aplicados apenas a essa ferramenta específica — útil quando a ferramenta de um servidor chama um serviço pago de terceiros, ou quando uma ferramenta deve ser executada apenas uma vez por conversa. Tudo aqui é opcional; deixe vazio e a ferramenta se comportará exatamente como antes.

• Somente leitura. Alguns servidores declaram para cada ferramenta se ela apenas lê dados. Automático (configuração do servidor) confia nessa declaração; você pode substituí-la de qualquer maneira — marque uma ferramenta como Somente leitura quando souber que ela nunca cria ou altera nada (isso permite que a IA tente novamente uma resposta interrompida com segurança, em vez de deixar o cliente sem uma resposta), ou como Não é somente leitura quando você não confia na declaração do servidor.
• Servir resultado em cache em chamadas repetidas. Quando a IA chama a ferramenta novamente com as mesmas entradas, o resultado anterior é reutilizado (por até 24 horas) em vez de chamar o servidor novamente.
• Máximo de execuções por conversa e máximo de execuções por intervalo de tempo funcionam exatamente como nas funções personalizadas: apenas execuções bem-sucedidas, e quando um limite é atingido, a IA é informada do motivo e responde com as informações que já possui — o cliente nunca fica sem resposta. Conversas de teste estão isentas.

Uma observação honesta sobre confiança: os limites controlam se e com que frequência nós chamamos o servidor — eles não podem alterar o que o servidor faz internamente depois de chamado. E substituir uma ferramenta de terceiros para Somente leitura é uma afirmação mais forte do que em sua própria função personalizada, porque é um código de outra pessoa; faça isso apenas para ferramentas que você entende.

Habilitando um Servidor em um Agente #

Registrar um servidor o torna disponível; você ainda escolhe quais Agentes podem usá-lo.

1. Abra o Agente e vá para a aba Habilidades de IA. (Para uma campanha que ainda mantém suas próprias configurações de IA diretamente, em vez de usar um Agente separado, a mesma lista aparece na etapa Habilidades de IA da própria campanha.)
2. Encontre a seção Servidores MCP.
3. Ative cada servidor que você deseja que o bot deste Agente possa usar.
4. Clique em Salvar alterações — as seleções só são aplicadas após serem salvas.

Você pode habilitar até 5 servidores por Agente. Apenas os servidores que você habilitar estarão disponíveis para o bot daquele Agente, o que mantém o bot focado nas ferramentas que são relevantes.

Escolhendo quais ferramentas um Agente pode usar #

Uma vez que um servidor é habilitado em um Agente, você também pode restringir quais de suas ferramentas aquele Agente específico pode chamar — útil quando um Agente deve apenas ler dados enquanto outro também pode criar registros.

1. Na aba Habilidades de IA, sob o servidor habilitado, clique na linha “… ferramentas habilitadas para este agente” para expandir a lista de ferramentas.
2. Desative qualquer ferramenta que este Agente não deva usar e clique em Salvar alterações.

Duas regras mantêm isso previsível:

• Um Agente só pode restringir, nunca ampliar. Ferramentas que você desativou em toda a conta (na página Servidores MCP) não aparecem aqui e não podem ser reativadas para um único Agente.
• Agentes herdam por padrão. Um Agente onde você não tocou na lista de ferramentas simplesmente segue a seleção de toda a conta — incluindo ferramentas que você habilitar lá posteriormente. Depois de restringir a lista de um Agente, novas ferramentas permanecem desativadas para esse Agente até que você as habilite.

Exemplo Pronto: Conecte uma Loja Shopify #

Toda loja Shopify vem com um servidor MCP integrado — sem aplicativo para instalar, sem chave para criar. A Shopify o hospeda no próprio endereço web da loja com /api/mcp adicionado ao final.

O que o bot obtém dele:

• Busca de produtos — encontre produtos descrevendo o que o cliente deseja (“uma jaqueta de corrida quente por menos de $100”), com preços em tempo real, variantes e estoque.
• Detalhes do produto — informações completas sobre um produto específico, incluindo opções e disponibilidade.
• Políticas da loja e FAQs — perguntas sobre envio, devoluções, reembolso e privacidade, respondidas a partir das próprias páginas da loja.
• Carrinho — monte um carrinho para o cliente e forneça a ele um link de checkout.

Para conectar uma, adicione um servidor com:

Salve, clique em Test Connection e ative o servidor no seu agente — essa é toda a configuração.

Duas coisas para saber:

• Pedidos não estão neste servidor. A Shopify mantém deliberadamente os dados de pedidos fora deste endpoint público. Para perguntas do tipo “onde está meu pedido?”, combine este servidor com uma função personalizada — veja o exemplo de status de pedido da Shopify.
• Funciona para qualquer loja Shopify — incluindo a loja de um cliente, caso você gerencie contas para terceiros. Tudo o que você precisa é do endereço web da loja.

Segurança — Conecte Apenas Servidores em que Você Confia #

Um servidor MCP que você conecta pode ser chamado pelo seu bot e pode retornar texto que o bot lê e sobre o qual age. Trate-o como qualquer outra integração que possua uma chave para seus sistemas:

• Registre apenas servidores que você controla ou nos quais confia plenamente. A descrição de uma ferramenta é escrita por quem opera o servidor, e o bot lê essas descrições para decidir quando usar uma ferramenta.
• Use uma chave de API dedicada e limitada, não uma credencial de administrador. Sua chave é armazenada com segurança e nunca é exibida em exportações de dados. O mesmo se aplica a logins OAuth — os tokens de acesso são armazenados com segurança e omitidos de qualquer exportação.
• A URL deve ser um endereço https:// público. Endereços internos, localhost e de rede privada são rejeitados por motivos de segurança.
• Desative um servidor no momento em que parar de confiar nele — desative-o ou exclua-o, e ele será removido imediatamente de todos os Agentes.

Solução de problemas #

• Ponto de status vermelho / falha na conexão: Reabra o servidor e clique em Test Connection para ver o erro exato. As causas mais comuns são uma chave incorreta ou expirada, um erro de digitação na URL ou o servidor exigindo um nome de cabeçalho diferente de Authorization.
• Um servidor OAuth parou de funcionar / solicita reconexão: Logins OAuth podem ser revogados ou expirar no lado do servidor. Abra o servidor e clique em Connect novamente para entrar. Observe que logins OAuth nunca são copiados entre contas, portanto, servidores de um Agente ou campanha copiado devem ser reconectados na conta para a qual você o copiou.
• O bot não está usando uma ferramenta: Primeiro, verifique se a ferramenta está ativada na seção Tools do servidor (edite o servidor para ver a lista) — uma ferramenta desativada fica invisível para o bot. Em seguida, certifique-se de que o servidor esteja habilitado nesse Agente específico e que a solicitação do cliente corresponda claramente ao que a ferramenta faz. Assim como nas funções personalizadas, nomes e descrições claros das ferramentas no lado do servidor ajudam o bot a escolher corretamente.
• Uma ferramenta oferecida pelo servidor não está aparecendo para o bot: Se você fez a curadoria das ferramentas deste servidor, lembre-se de que qualquer ferramenta adicionada após a curadoria chega desativada. Edite o servidor, abra a seção Tools e ative-a.
• O conector lida com sessões HTTP MCP? Sim. Se o seu servidor emitir um cabeçalho mcp-session-id quando a conexão for estabelecida, nós o armazenamos e o enviamos de volta em cada solicitação subsequente, juntamente com o cabeçalho MCP-Protocol-Version. Servidores com estado funcionam sem qualquer configuração extra do seu lado.
• Uma ferramenta foi ignorada: Um Agente pode usar no máximo 5 servidores e 40 ferramentas MCP ao mesmo tempo. Se um servidor oferecer um número muito grande de ferramentas, algumas podem não ser carregadas — desative as ferramentas de que você não precisa na seção Tools do servidor ou mantenha cada servidor focado nas ferramentas que você realmente usa.

Requisitos do Plano #

Os servidores MCP fazem parte do conjunto de ferramentas do desenvolvedor, juntamente com as funções personalizadas. Se você não vir Servidores MCP na seção AI Studio da barra lateral, seu plano atual não o inclui — faça upgrade para um plano com ferramentas de desenvolvedor para ativá-lo.

Próximos passos #

• Funções Personalizadas — configure uma única ferramenta manualmente em vez de conectar um servidor inteiro.
• Agentes de IA — onde os servidores MCP são habilitados para um bot.
• Agentes de IA — a página principal do grupo AI Studio onde residem os Servidores MCP.