Ligar Servidores MCP ao Seu Bot #

Os servidores MCP permitem que o seu bot de IA utilize ferramentas de outro sistema durante conversas em tempo real — sem que tenha de criar cada ferramenta manualmente. Aponta o bot para um servidor MCP uma vez e todas as ferramentas que esse servidor oferece ficam automaticamente disponíveis para o bot.

Se já utilizou Funções Personalizadas, o conceito é o mesmo, mas levado um passo mais além: uma função personalizada é uma ferramenta única que configura manualmente, enquanto um servidor MCP é um conjunto de ferramentas pronto a usar que o bot pode descobrir e chamar por si próprio.

O que é um Servidor MCP? #

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

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

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

Pode utilizar ambos ao mesmo tempo no mesmo Agente.

Como Funciona (A Versão Simples) #

1. Regista um servidor MCP na página Servidores MCP — o seu endereço web e um cabeçalho de autorização (normalmente uma chave API).
2. O Your AI Connector liga-se e descobre as ferramentas do servidor, memorizando a lista.
3. Ativa o servidor num 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 mecanismo — recebe apenas uma resposta baseada em informações reais e atualizadas.

Quanto custa uma chamada de ferramenta MCP #

Uma chamada de ferramenta a partir de um servidor MCP é faturada exatamente como uma chamada de função personalizada, ao nível de Qualidade de IA do seu Agente:

Adicionar um Servidor MCP (Passo a Passo) #

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

Preencha o formulário:

Escolher como iniciar sessão: Chave de API ou OAuth #

O Your AI Connector suporta duas formas de autenticação com um servidor. Escolha a que a documentação do servidor indicar, utilizando a opção Autenticação no topo do formulário:

• Chave API / cabeçalho: o método original descrito acima. Cola uma credencial fixa (uma chave API ou token) no campo Valor do Cabeçalho de Autenticação, e o Your AI Connector envia-a em cada pedido. Ideal para servidores que lhe fornecem uma chave de longa duração.
• OAuth (iniciar sessão): para servidores que lhe pedem para iniciar sessão em vez de colar uma chave. Com OAuth, não há chave para copiar — aprova o acesso iniciando sessão, da mesma forma que o “Iniciar sessão com Google” funciona noutros sites.

Para ligar com OAuth:

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

2. Preencha o Nome e o URL do Servidor e, em seguida, clique em Guardar. O servidor é adicionado à sua lista, mas aparece como não ligado por enquanto.
3. Clique em Ligar no servidor. Abre-se uma janela de início de sessão segura onde aprova o acesso.
4. Aprove e a janela fecha-se automaticamente. O servidor aparece agora como ligado e o Your AI Connector carrega as suas ferramentas.

É tudo. O Your AI Connector mantém a ligação ativa automaticamente em segundo plano, pelo que, normalmente, nunca mais terá de lhe tocar. Se um servidor perder a ligação (por exemplo, se o início de sessão expirar ou se alguém o revogar do lado do servidor), aparecerá como desligado — basta clicar em Re-ligar e iniciar sessão novamente.

Se o servidor não puder ser configurado automaticamente ao clicar em Ligar, ser-lhe-á pedido que cole alguns detalhes (um endereço de início de sessão e um ID de cliente) que a documentação do próprio servidor fornece, e depois a ligação termina o início de sessão.

Testar a Ligação #

Antes de guardar, clique em Testar Ligação. O Your AI Connector contacta o servidor e mostra-lhe a lista de ferramentas que este oferece. Esta é a forma mais rápida de confirmar se o seu URL e chave estão corretos — se a ligação falhar, verá a mensagem de erro imediatamente, em vez de o descobrir a meio de uma conversa.

Quando o teste for bem-sucedido, clique em Guardar. O seu servidor aparece na lista com um ponto de estado verde e o número de ferramentas que oferece.

Ler a Lista de Servidores #

Cada servidor na lista mostra:

• Um ponto de estado — verde quando a última ligação funcionou, vermelho quando a última tentativa falhou (passe o rato por cima para ver o erro), cinzento antes da primeira ligação bem-sucedida.
• O endereço do servidor e quantas ferramentas oferece atualmente.
• Um interruptor de ligar/desligar para ativar ou desativar rapidamente todo o servidor sem o eliminar.

O Your AI Connector atualiza a lista de ferramentas de cada servidor em segundo plano cerca de uma vez por dia, pelo que as novas ferramentas aparecem automaticamente. Um servidor lento ou temporariamente inacessível nunca atrasa uma conversa — o bot utiliza simplesmente a última lista de ferramentas conhecida e recorre a uma alternativa de forma elegante se uma chamada não for bem-sucedida.

Escolher que ferramentas o bot pode utilizar #

Um servidor oferece frequentemente mais ferramentas do que aquelas que pretende que o bot utilize. Pode ativar ou desativar ferramentas individuais sem desligar o servidor completo.

1. Clique no ícone de lápis (editar) no servidor na lista.
2. Desloque-se até à secção Ferramentas — todas as ferramentas que o servidor oferece estão listadas, cada uma com o seu próprio interruptor de ligar/desligar.
3. Desligue qualquer ferramenta que não pretenda que o bot utilize, ou utilize Ativar tudo / Desativar tudo para as definir de uma só vez.
4. Clique em Guardar alterações.

Apenas as ferramentas que deixar ligadas são oferecidas ao bot. Uma ferramenta que esteja desligada é completamente invisível para o bot — este não a pode chamar e não contará para o limite de 40 ferramentas.

Duas coisas que vale a pena saber:

• As novas ferramentas permanecem desligadas até que as ligue. Assim que tiver feito a curadoria das ferramentas de um servidor, qualquer ferramenta que o servidor adicione mais tarde chega desligada, pelo que nada de novo fica disponível para o bot até que decida ativá-la. (Os servidores cuja curadoria nunca fez mantêm todas as suas ferramentas ligadas, exatamente como antes.)
• Isto é separado da escolha do Agente abaixo. Aqui decide quais das ferramentas de um servidor existem, ao nível da conta; no Agente, decide a que servidores esse Agente pode aceder — e, se quiser, restringe ainda mais as suas ferramentas apenas para esse Agente.

Definir limites de execução por ferramenta #

Junto ao interruptor de ligar/desligar de cada ferramenta, encontrará um controlo de Limites. Este abre os mesmos limites de execução que pode definir numa 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 só deve ser executada uma vez por conversação. Tudo aqui é opcional; deixe em branco e a ferramenta comportar-se-á exatamente como antes.

• Apenas leitura. Alguns servidores declaram para cada ferramenta se esta apenas lê dados. Automático (definição do servidor) confia nessa declaração; pode substituir essa definição em qualquer um dos sentidos — marque uma ferramenta como Apenas leitura quando souber que esta nunca cria nem altera nada (isto permite que a IA tente novamente uma resposta interrompida de forma segura, em vez de deixar o cliente sem resposta), ou como Não é apenas leitura quando não confia na afirmação do servidor.
• Servir resultado em cache em chamadas repetidas. Quando a IA chama a ferramenta novamente com os mesmos dados de entrada, o resultado anterior é reutilizado (por até 24 horas) em vez de chamar o servidor novamente.
• Máximo de execuções por conversação e máximo de execuções por janela temporal 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 a informação que já possui — o cliente nunca fica sem resposta. As conversações de teste estão isentas.

Uma nota honesta sobre confiança: os limites controlam se e com que frequência chamamos o servidor — não podem alterar o que o servidor faz internamente depois de ser chamado. E substituir uma ferramenta de terceiros para Apenas leitura é uma afirmação mais forte do que numa função personalizada sua, porque se trata de código de outra pessoa; faça-o apenas para ferramentas que compreende.

Ativar um Servidor num Agente #

Registar um servidor torna-o disponível; continua a escolher quais os Agentes que o podem utilizar.

1. Abra o Agente e vá para o separador Capacidades de IA. (Para uma campanha que ainda mantém as suas próprias definições de IA diretamente, em vez de através de um Agente separado, a mesma lista aparece no passo Capacidades de IA dessa campanha.)
2. Encontre a secção Servidores MCP.
3. Ative cada servidor que pretende que o bot deste Agente possa utilizar.
4. Clique em Guardar alterações — as seleções só são aplicadas após serem guardadas.

Pode ativar até 5 servidores por Agente. Apenas os servidores que ativar estão disponíveis para o bot desse Agente, o que mantém o bot focado nas ferramentas que são relevantes.

Escolher que Ferramentas um Agente Pode Utilizar #

Assim que um servidor é ativado num Agente, também pode restringir quais das suas ferramentas esse Agente específico pode chamar — útil quando um Agente deve apenas ler dados enquanto outro também pode criar registos.

1. No separador Capacidades de IA, sob o servidor ativado, clique na linha “… ferramentas ativadas para este agente” para expandir a lista de ferramentas.
2. Desative qualquer ferramenta que este Agente não deva utilizar e, em seguida, clique em Guardar alterações.

Duas regras mantêm isto previsível:

• Um Agente só pode restringir, nunca alargar. As ferramentas que desativou ao nível da conta (na página Servidores MCP) não aparecem aqui e não podem ser reativadas para um único Agente.
• Os Agentes herdam por predefinição. Um Agente onde não tocou na lista de ferramentas segue simplesmente a seleção ao nível da conta — incluindo as ferramentas que ativar lá mais tarde. Assim que restringe a lista de um Agente, as novas ferramentas permanecem desligadas para esse Agente até que as ative.

Exemplo pronto a usar: Ligar uma loja Shopify #

Todas as lojas Shopify vêm com um servidor MCP integrado — não há nenhuma aplicação para instalar, nem chaves para criar. A Shopify aloja-o no próprio endereço web da loja com /api/mcp adicionado ao final.

O que o bot obtém a partir dele:

• Pesquisa de produtos — encontre produtos descrevendo o que o cliente pretende (“um casaco de corrida quente por menos de 100 $”), com preços em tempo real, variantes e stock.
• Detalhes do produto — informações completas sobre um produto específico, incluindo opções e disponibilidade.
• Políticas da loja e FAQs — questões sobre envio, devoluções, reembolsos e privacidade, respondidas a partir das próprias páginas da loja.
• Carrinho — crie um carrinho para o cliente e forneça-lhe uma ligação para finalizar a compra.

Para ligar uma, adicione um servidor com:

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

Duas coisas a saber:

• As encomendas não estão neste servidor. A Shopify mantém deliberadamente os dados das encomendas fora deste ponto final público. Para questões do tipo “onde está a minha encomenda?”, emparelhe este servidor com uma função personalizada — veja o exemplo de estado de encomenda Shopify.
• Funciona para qualquer loja Shopify — incluindo a loja de um cliente, caso gere contas para terceiros. Tudo o que precisa é do endereço web da loja.

Segurança — Ligue Apenas Servidores em que Confia #

Um servidor MCP que ligar pode ser chamado pelo seu bot e pode devolver texto que o bot lê e sobre o qual atua. Trate-o como qualquer outra integração que possua uma chave de acesso aos seus sistemas:

• Registe apenas servidores que controla ou em que confia plenamente. A descrição de uma ferramenta é escrita por quem gere o servidor, e o bot lê essas descrições para decidir quando utilizar uma ferramenta.
• Utilize uma chave de API dedicada e limitada, não uma credencial de administrador. A sua chave é armazenada de forma segura e nunca é apresentada em exportações de dados. O mesmo se aplica a inícios de sessão OAuth — os tokens de acesso são armazenados de forma segura e ocultados em qualquer exportação.
• O URL deve ser um endereço https:// público. Endereços internos, localhost e de redes privadas são rejeitados por motivos de segurança.
• Desative um servidor no momento em que deixar de confiar nele — desative-o ou elimine-o, e este será removido imediatamente de todos os Agentes.

Resolução de Problemas #

• Ponto de estado vermelho / falha na ligação: Reabra o servidor e clique em Testar Ligação para ver o erro exato. As causas mais comuns são uma chave incorreta ou expirada, um erro de digitação no URL ou o servidor exigir um nome de cabeçalho diferente de Authorization.
• Um servidor OAuth deixou de funcionar / pede para voltar a ligar: Os inícios de sessão OAuth podem ser revogados ou expirar do lado do servidor. Abra o servidor e clique em Ligar novamente para iniciar sessão. Tenha em atenção que os inícios de sessão OAuth nunca são copiados entre contas, pelo que os servidores de um Agente ou campanha copiados devem ser ligados novamente na conta para a qual os copiou.
• O bot não está a utilizar uma ferramenta: Primeiro, verifique se a ferramenta está ligada na secção Ferramentas do servidor (edite o servidor para ver a lista) — uma ferramenta desligada é invisível para o bot. Depois, certifique-se de que o servidor está ativado nesse Agente específico e que o pedido do cliente corresponde claramente ao que a ferramenta faz. Tal como acontece com as funções personalizadas, nomes e descrições claros das ferramentas do lado do servidor ajudam o bot a escolher corretamente.
• Uma ferramenta que o servidor oferece não aparece para o bot: Se selecionou as ferramentas deste servidor, lembre-se de que qualquer ferramenta adicionada após a sua seleção chega desligada. Edite o servidor, abra a secção Ferramentas e ligue-a.
• O conector lida com sessões HTTP MCP? Sim. Se o seu servidor emitir um cabeçalho mcp-session-id quando a ligação é estabelecida, armazenamo-lo e enviamo-lo de volta em cada pedido subsequente, juntamente com o cabeçalho MCP-Protocol-Version. Os servidores com estado funcionam sem qualquer configuração adicional da sua parte.
• Uma ferramenta foi ignorada: Um Agente pode utilizar, 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 — desligue as ferramentas de que não necessita na secção Ferramentas do servidor ou mantenha cada servidor focado nas ferramentas que realmente utiliza.

Requisitos do Plano #

Os servidores MCP fazem parte do conjunto de ferramentas de desenvolvimento, juntamente com as funções personalizadas. Se não vir MCP Servers na secção AI Studio da barra lateral, o seu plano atual não o inclui — atualize para um plano com ferramentas de desenvolvimento para o ativar.

Próximos Passos #

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