O que é o MCP? O Model Context Protocol explicado

O MCP, Model Context Protocol, é um protocolo aberto que liga aplicações de IA a ferramentas e dados externos de forma padronizada. Um serviço descreve uma única vez o que oferece, sob a forma de um servidor MCP, e os clientes compatíveis podem usá-lo, do Claude Code e do Cursor ao Codex e ao VS Code, desde que suportem o seu transporte, a sua autorização e a sua versão do protocolo. A Anthropic apresentou o MCP a 25 de novembro de 2024. Em dezembro de 2025, doou o protocolo à Agentic AI Foundation, um fundo dedicado (directed fund) sob a alçada da Linux Foundation.

O problema que o MCP resolve

Um modelo de linguagem só sabe o que está no seu contexto. Para ler um ticket, consultar uma base de dados ou iniciar um deploy, uma aplicação de IA precisa de uma integração com esse sistema. Antes do MCP, cada aplicação construía a sua. Nas palavras da Anthropic: «Every new data source requires its own custom implementation, making truly connected systems difficult to scale.» Ou seja, cada nova fonte de dados exigia uma integração à medida, o que tornava difícil escalar sistemas verdadeiramente ligados.

O MCP substitui essas integrações pontuais por um único protocolo. Um serviço implementa um servidor MCP, uma aplicação de IA implementa clientes MCP, e cada lado funciona com contrapartes compatíveis, dentro dos limites do transporte, da autorização, da versão e das funcionalidades que suportam. A especificação diz inspirar-se no Language Server Protocol, que padronizou o suporte a linguagens de programação nas ferramentas de desenvolvimento. Em dezembro de 2025, a Anthropic indicava o ChatGPT, o Cursor, o Gemini, o Microsoft Copilot e o Visual Studio Code entre os produtos que tinham adotado o MCP.

Hosts, clientes e servidores

• Host: a aplicação de IA em que trabalha, como o Claude Code, o Claude Desktop ou o VS Code. Coordena um ou mais clientes.
• Cliente: um componente dentro do host que mantém a ligação a um servidor. O host cria um cliente por servidor.
• Servidor: o programa que fornece ferramentas e contexto. É executado na sua máquina (servidor local) ou como serviço na internet (servidor remoto).

O cliente e o servidor trocam mensagens JSON-RPC 2.0. Quando liga o Claude Code à Nodion, o Claude Code é o host e executa um cliente para essa ligação, e quem responde é o servidor MCP alojado da Nodion.

O que um servidor oferece: ferramentas, recursos e prompts

• Ferramentas (tools): funções que o modelo pode chamar para agir, como uma chamada a uma API ou uma consulta à base de dados. Cada ferramenta tem um nome, uma descrição e um JSON Schema para os dados de entrada. As ferramentas são controladas pelo modelo: é ele que decide quando chamar uma, com base no seu pedido.
• Recursos (resources): dados que dão contexto ao modelo, como o conteúdo de ficheiros, registos de bases de dados ou respostas de APIs.
• Prompts: templates reutilizáveis para trabalhar com o modelo, como um prompt de sistema ou exemplos few-shot.

O cliente descobre as ferramentas com tools/list e executa uma com tools/call. Esta é a chamada da especificação, sem os metadados que cada pedido inclui:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": { "location": "New York" }
  }
}

Um servidor também pode pedir informações ao utilizador. Com a elicitation, o servidor responde a um pedido com um resultado que indica serem necessárias mais informações; o cliente pergunta ao utilizador e volta a enviar o pedido com a resposta. Na revisão atual, os servidores não iniciam pedidos por iniciativa própria.

Transportes: stdio e Streamable HTTP

O MCP especifica dois transportes padrão, e também são permitidos transportes personalizados:

• stdio: o host inicia o servidor como processo local e comunica com ele através da entrada e da saída padrão. É adequado para ferramentas que trabalham na sua máquina, como um servidor de sistema de ficheiros. Um servidor local serve normalmente um único cliente.
• Streamable HTTP: o cliente envia mensagens por HTTP POST, e o servidor pode transmitir as respostas em streaming com Server-Sent Events. É o transporte usado pelos servidores remotos. Suporta autenticação HTTP padrão, como bearer tokens, chaves de API e cabeçalhos personalizados, e o protocolo recomenda OAuth para obter tokens.

A revisão atual da especificação tem data de 2026-07-28. Nela, o protocolo é stateless (sem estado): cada pedido inclui a versão do protocolo e as capacidades de que precisa, por isso um servidor pode tratar cada pedido de forma independente. A revisão descreve ainda extensões opcionais como Tasks e MCP Apps; os detalhes estão na especificação.

Porque é que o MCP é importante para os agentes de programação

Os agentes de programação já leem, escrevem e testam o código do seu repositório. Grande parte do trabalho em torno desse código acontece noutros sistemas: o issue tracker, a base de dados, a monitorização de erros e a plataforma de alojamento. O MCP permite que o agente trabalhe também nesses sistemas.

• Uma integração para muitos agentes: um serviço que disponibiliza um servidor MCP funciona com clientes compatíveis como o Claude Code, o Cursor e o Codex, sem um plugin separado para cada um, desde que suportem o seu transporte, a sua autorização e as suas funcionalidades.
• Pedidos em linguagem corrente: os nomes, as descrições e os esquemas de entrada das ferramentas dizem ao modelo o que pode fazer, por isso «mostre-me os erros mais recentes» transforma-se na chamada de ferramenta certa.
• Nada para instalar nos servidores remotos: um servidor alojado só precisa do seu URL e de uma chave ou de um início de sessão.

Segurança: o que verificar antes de ligar um servidor

O MCP dá a um modelo acesso a sistemas reais, e a especificação é direta quanto a isso: as ferramentas representam execução arbitrária de código, e os hosts têm de obter o consentimento explícito do utilizador antes de invocar qualquer ferramenta. Na prática:

• Confirme as ações de escrita. Exija confirmação humana (human in the loop): a especificação pede às aplicações que mostrem que ferramentas estão expostas e que peçam confirmação, e são as definições de permissões do seu cliente que decidem se isso acontece. Não confie numa flag do lado do servidor que o próprio agente pode definir.
• Use chaves com privilégios mínimos. Dê a cada servidor uma credencial apenas com os scopes de que precisa, e use uma chave por agente para a poder revogar isoladamente. As orientações de segurança da especificação chamam a isto minimização de scopes (scope minimization).
• Ligue apenas servidores de confiança. Os clientes têm de tratar as descrições e anotações das ferramentas como não fiáveis, a menos que venham de um servidor de confiança.
• Verifique os servidores locais. Um servidor local é executado com os mesmos privilégios que o cliente que o inicia. Leia o comando exato antes de adicionar um.
• Mantenha os segredos fora do chat. Os tokens pertencem à configuração do cliente, não a um prompt.

O servidor MCP alojado da Nodion

A Nodion aloja um servidor MCP remoto em https://mcp.nodion.net/mcp. O seu agente usa a sua conta do dashboard, e não precisa de instalar nenhum processo local. Depois de ligado, basta pedir em linguagem corrente: criar um projeto, fazer deploy de uma aplicação a partir do repositório atual, associar uma base de dados, definir variáveis de ambiente, ler logs e verificar se uma release já está online. O facto de lhe ser pedida confirmação antes de cada chamada de ferramenta depende das definições de permissões do seu cliente. A Nodion também exige uma flag de confirmação explícita nas ferramentas de escrita para chaves pessoais, mas é o agente que define essa flag, por isso não substitui uma revisão humana.

O Claude Code liga-se com um único comando e uma chave pessoal criada em Account → Security:

claude mcp add nodion --transport http https://mcp.nodion.net/mcp \
  --header "Authorization: Bearer nodion_your_key"

As chaves pessoais têm scopes como read, write, deploy, env:read e logs:read, e pode limitar uma chave a projetos específicos. Um agente que só deve investigar erros não precisa de write nem de deploy.

O Cursor usa o mesmo tipo de chave. O Claude Desktop, o ChatGPT e o Codex ligam-se antes por OAuth: inicia sessão na página de autorização da Nodion e associa um ou mais projetos. Os segredos ficam no dashboard; a ligação não recolhe palavras-passe nem valores de ambiente no chat. O Windsurf, o Zed, o VS Code Copilot e o OpenCode usam o mesmo URL de servidor, https://mcp.nodion.net/mcp.

A configuração de cada cliente está em Ligue a Nodion ao seu agente de IA, e a referência completa está na documentação do MCP.