Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Servidor MCP

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Servidor MCP é o processo que expõe um conjunto de ferramentas a qualquer cliente que fale o protocolo, descrevendo o que cada ferramenta faz, que parâmetros aceita e o que devolve.

Ele é a metade do Model Context Protocol que fica junto do sistema de dados. Quem mantém um serviço decide o que dele vale a pena colocar ao alcance de um modelo, embrulha essas ações em ferramentas e publica o servidor; a partir daí, qualquer cliente compatível ganha acesso àquele conjunto sem escrever uma linha de integração. O modelo continua não sabendo nada sobre a implementação interna: ele enxerga apenas os nomes e as descrições, como um orquestrador enxerga seus subagentes.

A descrição da ferramenta é o contrato lido pelo modelo

Cada ferramenta declara três coisas: um nome de identificação, uma descrição e uma lista de parâmetros. Os parâmetros funcionam como os de uma função comum — têm tipo, indicação de obrigatoriedade e uma explicação do que representam.

O que muda em relação a uma função comum é quem lê essa assinatura. A escolha da ferramenta certa a cada pedido do usuário nasce da descrição, não do código: é ela que o modelo interpreta para decidir se aquela ação resolve o que foi pedido. Uma descrição vaga de ferramenta ou de parâmetro produz chamadas erradas mesmo com a implementação perfeita, o que aproxima a construção de um servidor MCP de um exercício de Engenharia de Prompt tanto quanto de programação.

O que o servidor não expõe, o modelo não faz

A força de um servidor MCP é decidida por quem o publica. Um servidor de e-mail que expõe apenas a criação de rascunhos, e não o envio, limita o agente a rascunhos por mais capaz que o modelo seja. Antes de projetar um fluxo em cima de um servidor de terceiro, vale ler a lista de ferramentas que ele documenta.

Granularidade: um servidor por sistema, enxuto

Um servidor MCP existe para ensinar o modelo a interagir com um sistema em particular, e por isso costuma ser específico daquele sistema. A interoperabilidade não vem de juntar serviços: vem do protocolo, que faz qualquer cliente entender qualquer servidor da mesma forma.

É tecnicamente possível agregar vários serviços dentro de um servidor único, funcionando como gateway, mas a prática não é recomendada. Quanto mais ferramentas um servidor expõe, mais ambígua fica a decisão do modelo a cada pergunta, e maior o risco de ele escolher errado entre opções parecidas. A recomendação prática é a inversa: quanto mais enxuto e focado nas ações reais do sistema, melhores tendem a ser as interações.

Vale distinguir esse ponto de outro, confundido com ele: ter muitos servidores conectados a um mesmo cliente não costuma pesar tanto quanto ter um servidor inchado. O cliente carrega a lista de ferramentas e decide de forma geral se algum daqueles servidores tem a ver com a pergunta, sem interpretar em profundidade as ferramentas dos que não têm relação. O custo se parece com o de escolher um livro numa biblioteca pelo título e pelo sumário, em vez de ler cada volume — ainda assim, cada servidor ocupa espaço na lista e entra no Custo de Tokens de toda chamada.

O servidor como porta de entrada de contexto

A leitura mais óbvia de um servidor MCP é a de executor de ações, mas ele também serve para alimentar contexto. Um servidor de quadro colaborativo que expõe leitura e criação de elementos permite que um agente construa um diagrama inteiro a partir de um pedido em linguagem natural, escolhendo sozinho a estrutura e emitindo uma sequência de chamadas para montá-la. O caminho inverso vale igualmente: quadros grandes que documentam um projeto viram fonte de contexto para o modelo entender um sistema antes de mexer nele.

Esse mesmo exemplo mostra um limite. Um servidor só pode expor o que o sistema por baixo dele permite fazer programaticamente; se o serviço de origem não oferece a operação, nenhum servidor MCP a inventa. Já do lado da operação, a Arquitetura Stateless do MCP permite que o servidor rode atrás de um balanceador como qualquer serviço web.