MCP é um protocolo para conectar um assistente a ferramentas e fontes de dados. Para entender a conexão, um laboratório com arquivos fictícios é mais simples de verificar que uma conta real.

Neste exemplo, o cliente é o Claude Code e o servidor é o Filesystem, mantido no repositório do Model Context Protocol. Ele oferece leitura e escrita de arquivos: a pasta de teste delimita o exercício, mas não transforma o servidor em somente leitura. Servidor Filesystem ↗.

Prepare o laboratório

Exemplo para macOS ou Linux, com Claude Code e Node.js/npm disponíveis. Confira as versões no terminal:

Terminal · verificar pré-requisitos
node --version
npm --version
claude --version

Crie uma pasta dedicada com um arquivo fictício. Use esse nome somente se ele ainda não existir no seu ambiente:

Terminal · criar o material de teste
mkdir -p "$HOME/mcp-lab"
cd "$HOME/mcp-lab"
printf 'Teste local de MCP.\n' > exemplo.txt

Cadastre o servidor no cliente

No diretório do laboratório, registre uma conexão por stdio, transporte em que o cliente inicia o processo local. O escopo local associa o cadastro ao projeto atual. Referência de MCP no Claude Code ↗.

Terminal · cadastrar o exemplo
claude mcp add --transport stdio --scope local arquivos-lab -- \
  npx @modelcontextprotocol/server-filesystem "$HOME/mcp-lab"

O npx pode solicitar o download do pacote quando o servidor for iniciado. Confira a origem antes de aceitar. Depois, inspecione o cadastro:

Terminal · verificar e iniciar
claude mcp get arquivos-lab
claude

Comprove o acesso na sessão

Dentro do Claude Code, abra /mcp. Confirme o estado da conexão e peça ao assistente para usar o servidor arquivos-lab: primeiro listar os diretórios permitidos, depois ler exemplo.txt. Confira na chamada de ferramenta se ele usou esse MCP, em vez da leitura nativa do assistente.

O teste esperado é a pasta do laboratório na lista e a frase fictícia na leitura. Se não conectar, investigue Node/npm, caminho e mensagens de inicialização antes de adicionar novas integrações. Se o cliente enviar uma lista de roots, ela pode substituir os diretórios definidos na linha de comando; confira o escopo efetivo pela ferramenta list_allowed_directories.

O que esse teste demonstra

Um cadastro bem-sucedido mostra que a configuração foi gravada. A chamada real mostra que a sessão consegue usar aquela ferramenta. Em outro assistente, a configuração e as permissões precisam ser verificadas novamente.

Para remover apenas esse cadastro de teste, execute no mesmo diretório:

Terminal · remover o cadastro
claude mcp remove arquivos-lab --scope local

Isso não apaga a pasta do laboratório. Os comandos deste rascunho foram conferidos na documentação; a instalação não foi executada para produzir esta página.

Rascunho para revisão de Davi Wallace. Os exemplos são didáticos. Este texto ainda não foi publicado.