Coloque a mão na massa: instale o Claude Desktop, conecte seu primeiro MCP Server e veja o protocolo funcionando ao vivo.
O primeiro passo para ver o MCP funcionando na prática é instalar o Claude Desktop — o aplicativo oficial da Anthropic que funciona como Host MCP. Diferente do Claude na web, o Desktop suporta conexão direta com MCP Servers locais, permitindo que o modelo acesse ferramentas no seu computador. O download está disponível em claude.ai/download, com versões para Windows, Mac e Linux.
O Claude Desktop é a aplicação nativa da Anthropic que funciona como um Host MCP. Ele não é apenas uma interface para conversar com o Claude — é o ambiente que gerencia a conexão entre o modelo de IA e os MCP Servers instalados na sua máquina. Ao usar o Claude Desktop, você tem acesso a um Client MCP embutido que se comunica com servidores locais, permitindo que o Claude interaja com arquivos, bancos de dados, APIs e qualquer outra ferramenta que tenha um MCP Server disponível.
Acesse claude.ai/download no seu navegador. Escolha a versão correspondente ao seu sistema operacional (Windows, macOS ou Linux). Faça o download do instalador, execute-o e siga as instruções na tela. Ao abrir o Claude Desktop pela primeira vez, faça login com sua conta Anthropic. Pronto — você já tem um Host MCP funcional no seu computador.
Acesse claude.ai/download e baixe o instalador para o seu sistema operacional (Windows, macOS ou Linux).
Execute o instalador e siga as instruções padrão do seu sistema. No macOS, arraste para a pasta Applications. No Windows, siga o wizard. No Linux, use o pacote .deb ou .rpm.
Abra o Claude Desktop, faça login com sua conta Anthropic e verifique que a interface carrega corretamente. Você está pronto para configurar MCP Servers.
Para que o Claude Desktop saiba quais MCP Servers estão disponíveis, você precisa registrá-los em um arquivo de configuração chamado claude_desktop_config.json. Este arquivo é o coração da integração: é nele que você declara quais servidores o Claude pode acessar, como executá-los e quais argumentos passar. Sem esse arquivo configurado corretamente, o Claude Desktop não saberá que existem ferramentas MCP disponíveis.
O claude_desktop_config.json é o arquivo onde você registra todos os MCP Servers que deseja disponibilizar para o Claude Desktop. Ele fica em um diretório específico do sistema: no macOS, em ~/Library/Application Support/Claude/; no Windows, em %APPDATA%/Claude/. A estrutura principal é um objeto JSON com o campo "mcpServers", onde cada chave é o nome do servidor e o valor contém o comando de execução e seus argumentos.
A estrutura básica do arquivo é simples. Veja o esqueleto:
{
"mcpServers": {
"nome-do-server": {
"command": "comando-para-executar",
"args": ["argumento1", "argumento2"]
}
}
}
Cada servidor é uma entrada dentro de "mcpServers". O campo "command" define como executar o servidor (ex: npx) e "args" são os argumentos passados ao comando.
Cuidado ao editar o JSON manualmente — vírgulas e aspas importam! Um erro comum é esquecer uma vírgula entre servidores ou deixar uma vírgula sobrando após o último item. Outro erro frequente é usar aspas simples em vez de aspas duplas (JSON exige aspas duplas). Se o Claude Desktop não reconhecer seus servidores, o primeiro lugar a verificar é a sintaxe do JSON. Use um validador online como jsonlint.com para checar se o arquivo está correto antes de reiniciar o aplicativo.
O @modelcontextprotocol/server-filesystem é um dos MCP Servers oficiais mais populares. Ele permite que o Claude acesse, leia, crie e edite arquivos no seu computador — mas apenas nos diretórios que você explicitamente autorizar. É o servidor perfeito para começar porque é simples de configurar e demonstra claramente o poder do MCP: o Claude passa a "enxergar" seus arquivos locais.
O Filesystem Server é um MCP Server que expõe operações de sistema de arquivos como tools MCP. Ele oferece ferramentas como read_file (ler conteúdo de um arquivo), write_file (criar ou sobrescrever arquivos), list_directory (listar arquivos de uma pasta) e outras. O servidor só permite acesso aos diretórios especificados nos argumentos de configuração — garantindo que o Claude não acesse dados fora do escopo autorizado.
Adicione esta configuração ao seu claude_desktop_config.json:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/seu-usuario/Documents"
]
}
}
}
Substitua /Users/seu-usuario/Documents pelo caminho do diretório que você quer que o Claude acesse. Você pode especificar múltiplos diretórios adicionando mais caminhos à lista de args. Pré-requisito: ter o Node.js instalado (npx vem com o Node).
Após configurar o arquivo JSON, é hora de testar se tudo está funcionando. O Claude Desktop precisa ser reiniciado para ler as novas configurações. Quando o servidor MCP é carregado com sucesso, um ícone de ferramentas (martelo) aparece na interface, indicando que tools estão disponíveis. Se o ícone não aparecer, há um problema na configuração que precisa ser investigado.
O Claude Desktop lê o arquivo de configuração apenas na inicialização. Isso significa que, após qualquer alteração no claude_desktop_config.json, você precisa fechar completamente e reabrir o aplicativo. Quando os MCP Servers são carregados com sucesso, o Claude Desktop exibe um ícone de martelo na área de input, indicando que ferramentas externas estão disponíveis. Ao clicar nesse ícone, você pode ver a lista completa de tools oferecidas pelos servidores conectados.
Feche completamente o Claude Desktop (não apenas minimizar — encerre o processo) e abra novamente.
Olhe para a área de input de mensagens. Um ícone de martelo (🔨) deve aparecer, indicando que MCP Servers foram carregados.
Clique no ícone de martelo para ver a lista de tools disponíveis. Você deve ver ferramentas como read_file, write_file, list_directory, etc.
Problemas comuns e como resolver:
node --version no terminal.Com o Filesystem Server conectado, é hora de testar as tools na prática. O mais interessante é que você não precisa dizer ao Claude qual tool usar — basta fazer perguntas em linguagem natural e o modelo decide autonomamente quando e qual ferramenta utilizar. É a inteligência do modelo combinada com as capacidades das tools MCP.
Quando o Claude Desktop tem MCP Servers conectados, o modelo recebe a descrição de todas as tools disponíveis no seu contexto. A partir daí, o modelo analisa cada prompt do usuário e decide autonomamente se alguma tool é necessária para responder. Você não precisa usar comandos especiais ou sintaxe específica — basta escrever em linguagem natural. O Claude escolhe a tool certa, executa-a através do Client MCP, recebe o resultado e formula a resposta final.
Experimente estes prompts para testar as tools do Filesystem Server:
"Liste os arquivos na pasta Documents" — usa list_directory"Leia o conteúdo do arquivo notas.txt" — usa read_file"Crie um arquivo teste-mcp.txt com a frase: MCP está funcionando!" — usa write_file"Quantos arquivos .json existem na pasta do projeto?" — combina list_directory + raciocínioObserve como o Claude pede sua permissão antes de executar cada tool — um mecanismo de segurança do protocolo.
O modelo decide autonomamente quando usar tools — esse é um dos pilares do MCP. O processo funciona assim: o Claude recebe a lista de tools disponíveis com suas descrições e parâmetros. Quando o usuário faz uma pergunta, o modelo avalia se alguma tool ajudaria a responder. Se sim, ele gera uma tool call (chamada de ferramenta) com os parâmetros apropriados. Não há regras fixas — é a inteligência do modelo que decide. Isso é fundamentalmente diferente de chatbots tradicionais que dependem de comandos explícitos como "/buscar" ou "/criar".
Quando você pediu ao Claude para listar arquivos e ele respondeu com o conteúdo real do seu diretório, uma sequência sofisticada de eventos aconteceu nos bastidores. Entender esse fluxo é essencial para dominar o MCP — porque é exatamente esse mecanismo que você vai construir e customizar nos próximos módulos.
O que parece mágico na superfície segue um fluxo preciso e padronizado por baixo. Cada interação com uma tool MCP passa por 6 etapas bem definidas: o prompt do usuário chega ao Host (Claude Desktop), o modelo identifica a necessidade de usar uma tool, o Client MCP envia uma requisição ao Server, o Server executa a operação, o resultado retorna pelo mesmo caminho, e o Claude formula a resposta final incorporando os dados obtidos. Todo esse fluxo acontece em segundos, de forma transparente para o usuário.
Você digita "Liste os arquivos na pasta Documents" no Claude Desktop. O prompt é enviado ao modelo junto com a lista de tools disponíveis.
O modelo (Host) analisa o prompt e decide que precisa da tool "list_directory" para responder. Ele gera uma tool call com o parâmetro do diretório.
O Client MCP embutido no Claude Desktop recebe a tool call e a transforma em uma requisição JSON-RPC, enviando-a ao Filesystem Server.
O Filesystem Server recebe a requisição, valida que o diretório está na lista de permitidos, executa a listagem de arquivos no sistema operacional e coleta os resultados.
O Server envia a resposta (lista de arquivos) de volta ao Client MCP, que a repassa ao modelo. Os dados reais do seu computador agora estão no contexto do Claude.
O modelo processa os dados recebidos, formata a resposta em linguagem natural e a exibe para você — como se ele próprio tivesse olhado para a pasta.
Observe que durante a execução, o Claude Desktop mostra exatamente qual tool está sendo chamada e com quais parâmetros — antes de pedir sua permissão. Essa transparência é intencional: o protocolo MCP foi projetado para que o humano sempre saiba o que está acontecendo e possa aprovar ou recusar cada ação. Preste atenção nesses detalhes durante seus testes — eles revelam o fluxo real do protocolo em ação.
Próximo Módulo: 1.5 — Tipos de Recursos: Tools, Resources, Prompts