MÓDULO 2.4

🖥️ Instalando o Claude Desktop

Instale e configure o Claude Desktop — o Host MCP que usaremos durante todo o curso.

6
Tópicos
20
Minutos
Básico
Nível
Prático
Tipo
1

🖥️ O Que é o Claude Desktop

O Claude Desktop é a aplicação oficial da Anthropic que traz o modelo Claude diretamente para o seu computador. Mais do que um simples chat, ele funciona como um Host MCP completo — contendo o modelo de linguagem Claude e um Client MCP integrado que permite a conexão com servidores externos. Isso o torna a peça central do nosso ambiente de desenvolvimento MCP.

💎 Conceito Principal

O Claude Desktop é uma aplicação desktop da Anthropic que funciona como Host MCP. Na arquitetura MCP, o Host é a aplicação que contém o modelo de IA e o Client MCP integrado. Isso significa que, ao instalar o Claude Desktop, você ganha automaticamente: o modelo Claude para processar linguagem natural, um Client MCP capaz de se conectar a múltiplos MCP Servers, e uma interface gráfica para interagir com tudo isso. É gratuito para uso básico e será a ferramenta principal ao longo de todo o curso.

📊 Dados e Pesquisa

O Claude Desktop foi um dos primeiros hosts MCP disponíveis ao público, lançado pela Anthropic junto com a especificação do protocolo. Ele suporta múltiplos MCP Servers simultâneos, permitindo que o Claude acesse dezenas de ferramentas ao mesmo tempo. A aplicação está disponível para Windows, macOS e Linux, cobrindo os três principais sistemas operacionais usados por desenvolvedores. A Anthropic mantém atualizações regulares que expandem as capacidades MCP do desktop.

2

📥 Download e Instalação

O processo de download e instalação do Claude Desktop é direto e simples. A Anthropic disponibiliza instaladores nativos para cada sistema operacional, garantindo uma experiência de instalação familiar e sem surpresas. Em poucos minutos, você terá o aplicativo pronto para uso.

💎 Conceito Principal

O Claude Desktop está disponível para download em claude.ai/download. O site detecta automaticamente o seu sistema operacional e oferece o instalador correto. Para Windows, você recebe um arquivo .exe que executa o instalador padrão. Para macOS, um arquivo .dmg que basta arrastar para a pasta Aplicativos. Para Linux, estão disponíveis pacotes .deb (Ubuntu/Debian) e .AppImage (universal). A instalação não requer privilégios de administrador na maioria dos casos.

📋 Passos para instalação
Passo 1

Acesse claude.ai/download no seu navegador. O site detectará automaticamente seu sistema operacional e mostrará o botão de download correto.

Passo 2

Baixe o instalador e execute-o. Windows: duplo-clique no .exe e siga o wizard. Mac: abra o .dmg e arraste o ícone para Aplicativos. Linux: instale o .deb com sudo dpkg -i ou execute o .AppImage.

Passo 3

Abra o Claude Desktop após a instalação. Na primeira execução, você será direcionado para a tela de login. O aplicativo estará pronto para configuração.

🚨 Alerta

O Claude Desktop requer uma conta Anthropic para funcionar. Se você ainda não tem uma, crie gratuitamente em claude.ai antes de prosseguir. O plano gratuito é suficiente para acompanhar todo o curso. Certifique-se também de que seu sistema atende aos requisitos mínimos: Windows 10+, macOS 12+ ou uma distribuição Linux moderna com suporte a .deb ou AppImage.

3

🔑 Configuração Inicial

Ao abrir o Claude Desktop pela primeira vez, você passará por um processo rápido de configuração inicial. É simples e intuitivo — basta fazer login com sua conta Anthropic, aceitar os termos de uso e familiarizar-se com a interface principal. Em menos de dois minutos, você estará pronto para usar o Claude localmente.

💎 Conceito Principal

A configuração inicial do Claude Desktop envolve três etapas simples: fazer login com sua conta Anthropic (e-mail e senha ou login social), aceitar os termos de uso e política de privacidade, e explorar a interface principal. A interface consiste em um campo de chat central onde você conversa com o Claude, uma sidebar lateral para gerenciar conversas, e um menu de configurações onde futuramente veremos as opções relacionadas ao MCP. Neste momento, o Claude funciona como um assistente de chat padrão — ainda sem acesso a ferramentas externas.

💡 Dica Prática

Aproveite este momento para explorar a interface sem pressa. Envie algumas mensagens de teste, crie uma nova conversa, teste o atalho de teclado para nova conversa (geralmente Ctrl+N ou Cmd+N). Familiarize-se com a sidebar e com o botão de configurações. Quanto mais confortável você estiver com a interface básica, mais fácil será quando começarmos a adicionar MCP Servers e a interface ganhar novos elementos visuais.

4

🔌 Onde Ficam os MCP Servers

A configuração dos MCP Servers no Claude Desktop é feita através de um arquivo JSON específico. Este arquivo é o coração da integração MCP — é nele que você declara quais servers o Claude pode acessar, como iniciá-los e quais argumentos passar. Saber onde ele fica no seu sistema operacional é essencial para os próximos passos.

💎 Conceito Principal

O arquivo de configuração dos MCP Servers chama-se claude_desktop_config.json e fica em locais diferentes dependendo do sistema operacional:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Este arquivo é lido pelo Claude Desktop na inicialização. Qualquer alteração nele requer que você reinicie o aplicativo para que as mudanças sejam aplicadas.

💡 Dica Prática

Para navegar até o arquivo de configuração, use o terminal. No macOS: open ~/Library/Application\ Support/Claude/. No Windows: explorer %APPDATA%\Claude. No Linux: xdg-open ~/.config/Claude/. Se a pasta ou o arquivo não existirem ainda, não se preocupe — criaremos no próximo módulo. Muitas vezes o arquivo só é criado após a primeira configuração manual.

❌ Evitar
  • Editar o arquivo com o Claude Desktop aberto sem reiniciar depois
  • Colocar o arquivo em local diferente do padrão do OS
  • Usar editores que adicionam BOM ou formatação invisível
  • Tentar encontrar configurações MCP dentro da interface gráfica
✅ Fazer
  • Usar VS Code ou outro editor com suporte a JSON
  • Sempre reiniciar o Claude Desktop após editar o config
  • Fazer backup do arquivo antes de grandes mudanças
  • Validar o JSON antes de salvar (JSONLint ou extensão do editor)
5

✅ Verificando a Instalação

Antes de prosseguir para os próximos módulos, é importante verificar que tudo está funcionando corretamente. Uma instalação bem-sucedida do Claude Desktop é pré-requisito para todo o restante do curso. Vamos passar por um checklist completo para garantir que nada ficou para trás.

💎 Conceito Principal

A verificação da instalação envolve quatro pontos essenciais: o aplicativo abre sem erros ou crashes, o login funciona e você consegue acessar sua conta, o chat responde a mensagens normalmente (indicando conexão com o modelo), e o diretório de configuração existe no caminho esperado para o seu sistema operacional. Se todos esses quatro pontos estiverem OK, sua instalação está completa e pronta para receber configurações MCP.

📋 Checklist de verificação
Verificação 1 — Aplicativo abre

Clique no ícone do Claude Desktop. Ele deve abrir sem mensagens de erro, sem crashes e sem travamentos. A tela de chat deve aparecer normalmente.

Verificação 2 — Login funciona

Você deve estar logado com sua conta Anthropic. Se pediu login, insira suas credenciais e confirme que a autenticação foi bem-sucedida.

Verificação 3 — Chat responde

Envie uma mensagem simples como "Olá!" e verifique que o Claude responde. Isso confirma que a conexão com o modelo está funcionando.

Verificação 4 — Diretório config existe

Navegue até o diretório de configuração do seu OS e confirme que ele existe. Se o arquivo claude_desktop_config.json ainda não existir, tudo bem — criaremos no próximo módulo.

🚨 Alerta

Se o Claude Desktop não abrir ou apresentar erros, tente: reinstalar o aplicativo, verificar se o seu sistema operacional está atualizado, desativar temporariamente o antivírus (alguns bloqueiam a primeira execução), ou checar a página de status da Anthropic para possíveis indisponibilidades do serviço. Se o chat não responder, verifique sua conexão com a internet — o Claude Desktop precisa de acesso à rede para funcionar.

6

🧪 Primeiro Uso

Com o Claude Desktop instalado e funcionando, vamos fazer o primeiro uso intencional. O objetivo é verificar que a comunicação com o modelo funciona perfeitamente e, ao mesmo tempo, observar o que ainda falta — as ferramentas MCP. Esse contraste será fundamental para entender o valor que os MCP Servers trarão nos próximos módulos.

💎 Conceito Principal

Envie a seguinte mensagem ao Claude: "Olá, como você pode me ajudar?". O Claude deve responder normalmente, listando suas capacidades de linguagem natural. Agora observe a interface com atenção: note que não há ícone de martelo (🔨) na área de input. Esse ícone aparece quando há MCP Servers conectados e tools disponíveis. Sua ausência confirma que, neste momento, o Claude funciona apenas como assistente de chat — sem acesso a ferramentas externas. Nos próximos módulos, ao configurar MCP Servers, esse ícone aparecerá e o Claude ganhará superpoderes.

💡 Dica Prática

Experimente pedir ao Claude algo que ele não pode fazer sem ferramentas: "Leia o arquivo README.md da minha pasta de projetos" ou "Qual é o clima agora na minha cidade?". Ele vai explicar que não tem acesso a arquivos ou à internet. Guarde essa experiência na memória — quando configurarmos os MCP Servers, você vai pedir exatamente as mesmas coisas e o Claude vai executá-las de verdade. A diferença será impressionante.

📝 Resumo do Módulo

  • O Claude Desktop é a aplicação oficial da Anthropic que funciona como Host MCP, contendo o modelo Claude e um Client MCP integrado.
  • O download é feito em claude.ai/download, com instaladores nativos para Windows (.exe), macOS (.dmg) e Linux (.deb/.AppImage).
  • A configuração inicial requer login com conta Anthropic e é concluída em menos de dois minutos.
  • O arquivo de configuração MCP (claude_desktop_config.json) fica em diretórios específicos por sistema operacional.
  • A verificação da instalação inclui: app abre, login funciona, chat responde e diretório de config existe.
  • Sem MCP Servers configurados, o Claude Desktop funciona apenas como chat — o ícone de martelo (tools) ainda não aparece.

Próximo Módulo: 2.5 — Configurando o claude_desktop_config.json