Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Introdução ao MCP para Programadores

Aula 1 de 14 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Por que razão o MCP é revolucionário para programadores
  2. A Arquitetura Cliente-Servidor
  3. Como o MCP difere da invocação de funções
  4. As Três Primitivas do Protocolo
  5. O Fluxo de Decisão do Modelo
  6. Um Ecossistema em Rápida Expansão
  7. Pontos-chave

Atualização de 2 de novembro de 2026 — O Le Chat é agora o Vibe. Desde 28 de maio de 2026, o Le Chat foi rebatizado como Vibe (ainda em chat.mistral.ai): um único agente para trabalho e código, que mantém as suas conversas, definições e subscrições. A experiência legada do Le Chat permanece acessível no modo Chat; no modo Work, os agentes tornaram-se competências (invocadas com @), as memórias transformaram-se na base de conhecimentos e a pesquisa profunda converteu-se na competência Deep Research. Os planos designam-se agora por Mistral Free, Pro, Team e Enterprise. Esta lição utiliza o nome Vibe; alguns menus aqui descritos podem ter alterado de nome ou de localização.

Por que razão o MCP é revolucionário para programadores

O Model Context Protocol (MCP) é um padrão aberto que redefine a forma como as aplicações de IA interagem com o mundo exterior. Antes do MCP, cada estrutura impunha a sua própria gramática para declarar e invocar uma ferramenta: o LangChain tinha uma, o CrewAI outra, e os Mistral Agents e os OpenAI Assistants tinham ainda outras. Na prática, um programador que escrevesse um conetor para a sua API de faturação no LangChain tinha de o reescrever totalmente para funcionar no CrewAI e, depois, uma terceira vez para um agente interno personalizado. O trabalho era duplicado a cada alteração de ferramentas e a partilha de uma ferramenta entre equipas era um esforço remendado.

O MCP resolve este problema com um protocolo de comunicação unificado entre um cliente de IA e servidores de ferramentas. A melhor analogia é uma porta USB: independentemente do cliente — Claude, Vibe, Cursor, VS Code — e do servidor — GitHub, Notion, a sua API interna —, o formato da ligação permanece o mesmo. Escreve o seu conetor uma vez e ele funciona em todo o lado.

A Arquitetura Cliente-Servidor

O MCP baseia-se numa arquitetura cliente-servidor deliberadamente simples. De um lado, o cliente é a aplicação que implementa a IA: um chatbot como o Vibe da Mistral ou o Claude, um ambiente de desenvolvimento como o VS Code ou o Cursor, ou um SDK de agente como o Mistral Agent SDK ou o Claude Agent SDK. Do outro lado, o servidor é o programa que expõe capacidades — ferramentas, recursos e prompts — a esse cliente.

Toda a conversa entre os dois ocorre em JSON. O cliente começa por perguntar ao servidor que ferramentas oferece; o servidor responde com uma descrição textual de cada uma: o seu nome, parâmetros, função e formato de retorno. O modelo de linguagem utiliza esta descrição, e apenas esta, para decidir quando e como invocar uma ferramenta.

Client (Vibe)                 MCP Server (GitHub)
      |                              |
      |--- "What tools do you have?" ->|
      |<-- JSON tool descriptions -----|
      |                              |
      |--- Call: create_issue({}) --->|
      |<-- JSON Result ---------------|

Como o MCP difere da invocação de funções

A invocação clássica de funções e o MCP não são mutuamente exclusivos; simplesmente traçam a fronteira em locais diferentes. Com a invocação de funções, define as ferramentas no lado do cliente, passa-as ao modelo e gere a sua execução — tendo cada estrutura o seu próprio formato de definição. Com o MCP, as ferramentas residem num servidor, local ou remoto; o cliente conhece apenas a descrição textual e o servidor trata da execução.

A vantagem decisiva é a reutilização. Um servidor MCP do GitHub, escrito uma única vez, integra-se indiferentemente no Vibe, no Claude, no Cursor ou no seu próprio SDK sem uma única linha de reescrita. É isto que transforma um conetor interno num bloco de construção partilhável à escala empresarial.

As Três Primitivas do Protocolo

O MCP não se limita a ferramentas. O protocolo define três tipos de capacidades, distinguindo-se pelo que o servidor efetivamente disponibiliza. As ferramentas são funções executáveis: criar um ticket, enviar um e-mail, consultar uma API — o modelo aciona-as para agir sobre o mundo. Os recursos são dados legíveis — ficheiros, bases de dados, documentação — que o cliente pode ler sem desencadear qualquer ação; expor o conteúdo de um ficheiro de configuração enquadra-se nesta categoria, e não na das ferramentas. Por fim, os prompts são modelos de prompts reutilizáveis com parâmetros: um servidor de equipa pode assim distribuir uma instrução de revisão de código comprovada, em vez de deixar cada um a reescrevê-la de memória.

Na prática, as ferramentas representam cerca de 90% dos casos de utilização atuais: são o que liga primeiro e, frequentemente, as únicas coisas que implementa. No entanto, os recursos e os prompts abrem possibilidades que exploraremos em detalhe na Lição 3.

O Fluxo de Decisão do Modelo

Quando um utilizador faz uma pergunta ao cliente, o modelo percorre um ciclo de cinco etapas:

  1. Recebe a pergunta e a lista de ferramentas disponíveis (descrições MCP)
  2. Decide: responder diretamente ou invocar uma ferramenta?
  3. Se invocar uma ferramenta, formula os argumentos em JSON
  4. O servidor executa e devolve o resultado
  5. O modelo integra o resultado e formula a sua resposta (ou invoca outra ferramenta)

Este ciclo repete-se tantas vezes quantas as necessárias para a tarefa. Imagine um utilizador a pedir para transformar uma reclamação detetada no Reddit num ticket de desenvolvimento: o modelo consulta o Reddit, cria uma entrada no Linear e, em seguida, abre a issue correspondente no GitHub — três servidores encadeados, sem que o utilizador alguma vez saia da interface de chat.

Um Ecossistema em Rápida Expansão

Em abril de 2026, existem centenas de servidores MCP disponíveis: GitHub, Notion, Slack, Gmail, PayPal, Hugging Face, Semgrep e muitos outros. Os principais clientes de IA suportam o protocolo nativamente. Mais importante ainda, nada o limita a consumir o que já existe: pode criar os seus próprios servidores para expor as suas ferramentas internas, bases de dados empresariais ou procedimentos personalizados.

Esse é precisamente o objetivo deste curso: capacitá-lo a compreender, utilizar e construir servidores MCP em Python.

Pontos-chave

  • O MCP é um padrão aberto para comunicação cliente-servidor em IA
  • Unifica o ecossistema fragmentado de invocação de funções
  • A arquitetura baseia-se num cliente (chatbot, IDE, SDK) e num servidor (ferramentas, recursos, prompts)
  • A comunicação ocorre em JSON utilizando descrições textuais
  • Um servidor MCP é reutilizável em todos os clientes compatíveis