Ir para o conteúdo
Arara Code

Guias e comparativos

MCP (Model Context Protocol): o que é e como usar

MCP (Model Context Protocol) é um padrão aberto para conectar aplicações de IA a sistemas externos, como arquivos, bancos de dados e ferramentas de busca. A Anthropic lançou o protocolo como código aberto em 25 de novembro de 2024. Para usar, você registra um servidor MCP no seu assistente, que passa a usar as ferramentas, recursos e prompts desse servidor. Prefira servidores conhecidos, com o mínimo de acesso.

Arara Code

Publicado pelo projeto Arara Code com base na documentação oficial citada.

O que é MCP e quem criou o protocolo

A Anthropic anunciou o Model Context Protocol (MCP) em 25 de novembro de 2024, já como projeto de código aberto. Segundo o anúncio, o protocolo foi criado na empresa por David Soria Parra e Justin Spahr-Summers. O anúncio parte de um problema: cada nova fonte de dados exigia uma integração feita sob medida, o que dificultava conectar assistentes de IA aos sistemas onde os dados estão. O MCP troca essas integrações isoladas por um protocolo único.

A documentação oficial do MCP compara o protocolo a uma porta USB-C para aplicações de IA: um jeito padronizado de ligar a IA a sistemas externos. Com ele, assistentes como Claude e ChatGPT podem acessar fontes de dados, como arquivos locais e bancos de dados, ferramentas, como mecanismos de busca, e fluxos de trabalho, como prompts especializados. Ferramentas de desenvolvimento como o Cursor também têm suporte. Para quem programa, a vantagem é criar a integração uma vez e usá-la em vários clientes.

Anthropic: anúncio do MCP (nov. 2024)

Como o MCP funciona: hosts, clientes, servidores e transportes

O MCP segue uma arquitetura cliente-servidor. O host é a aplicação de IA, como o Claude Code ou o Claude Desktop. Para cada servidor MCP, o host cria um cliente, que mantém uma conexão dedicada com aquele servidor. O servidor é o programa que fornece contexto e pode expor três primitivas principais: ferramentas, funções que a IA pode executar; recursos, dados que dão contexto; e prompts, templates reutilizáveis que organizam a conversa com a IA.

A comunicação usa JSON-RPC 2.0 e passa por um de dois transportes. No stdio, o servidor roda na mesma máquina, como processo local, e conversa pela entrada e pela saída padrão. O Streamable HTTP permite usar servidores remotos: o cliente envia as mensagens por HTTP POST. Esse transporte aceita autenticação HTTP comum, como bearer tokens, chaves de API e cabeçalhos próprios, e a documentação recomenda OAuth para obter os tokens. Um servidor local costuma atender um só cliente; um remoto, vários.

MCP: visão geral da arquitetura

Segurança no MCP: o que a especificação recomenda

Um servidor MCP local é um programa que roda no seu computador com os mesmos privilégios do cliente. A página de boas práticas de segurança da especificação lista os riscos de servidores de fontes não confiáveis: execução de qualquer comando, perda de dados e vazamento de informações. Por isso, um cliente que configura servidores com um clique deve mostrar o comando exato antes de executá-lo e pedir sua aprovação. Instale só servidores que você conhece e leia esse comando.

A mesma página pede o menor privilégio possível. O cliente deve iniciar servidores com acesso restrito a arquivos, rede e outros recursos do sistema, e os tokens devem ter escopos mínimos, sem curingas de acesso total. Um servidor nunca deve aceitar tokens emitidos para outro serviço. Fica ainda o risco de prompt injection: quando uma ferramenta lê conteúdo de terceiros, como uma página web, esse texto pode trazer instruções escondidas para a IA. Revise cada ação antes de aprovar.

Especificação MCP: boas práticas de segurança

Como usar MCP no Arara Code, passo a passo

No Arara Code, você cadastra os servidores MCP uma vez só. Abra Configurações do Arara › MCPs e escreva a configuração em JSON, com a chave “mcpServers”. Um servidor local leva command, args e env; um servidor remoto leva url e headers. Ao salvar, o Arara Code valida o JSON e sincroniza os servidores com Codex, Claude Code, Kiro e Google Antigravity. Cada assistente externo precisa do próprio CLI instalado e de login próprio.

Depois de salvar, clique em “Verificar conexão”: o Arara Code inicia o servidor e lista as ferramentas dele. Para um primeiro teste, use o servidor filesystem, que a documentação oficial do MCP cita como exemplo de servidor local por stdio. Dê a ele uma pasta de teste, nunca a sua pasta pessoal. Passe tokens por env ou headers, nunca pelo chat, com o menor escopo possível. O chat mostra as chamadas de ferramentas e pede permissão antes de editar arquivos ou rodar comandos.

Arara Code: repositório público da IDE

Fontes e leitura complementar

Ler em Markdown

Continue explorando

Dê espaço à sua próxima ideia.

Conheça o Arara Code no seu próprio projeto. Comece pelo instalador e revise as mudanças que seu assistente fizer.