MCP Academy · Aula

Integrá-lo ao Claude Desktop

Edite a configuração para que o Claude carregue seu servidor.

Aula 2 de 413 etapas

Integrá-lo ao Claude Desktop é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.

Do script a um host real

Seu servidor está funcionando, mas ainda não há ninguém se comunicando com ele. Vamos conectá-lo a um host real: Claude Desktop. 🖥️

Ele lê um arquivo de configuração

O Claude Desktop descobre servidores a partir de um único arquivo JSON chamado claude_desktop_config.json. Você lista cada servidor nele, e o aplicativo os carrega ao iniciar.

Onde fica o arquivo

No macOS, o arquivo fica em Application Support; no Windows, ele fica na pasta de roaming do AppData. Abra-o nas configurações do aplicativo.

~/Library/Application Support/Claude/claude_desktop_config.json

A chave mcpServers

Cada servidor fica dentro do objeto mcpServers de nível superior. Cada chave é o nome escolhido por você; o valor descreve como iniciá-lo.

{
  "mcpServers": {}
}

Comando e argumentos

Para cada servidor, você fornece um comando a ser executado e uma lista de argumentos. Juntos, eles determinam exatamente como o host inicia seu processo.

{
  "weather": {
    "command": "python",
    "args": ["/abs/path/server.py"]
  }
}

Use caminhos absolutos

O host é iniciado a partir de seu próprio diretório de trabalho, portanto os caminhos relativos falham. Sempre indique nos argumentos um caminho absoluto para seu script.

uv simplifica tudo

Se seu projeto usa uv, defina o comando como uv e deixe que ele execute seu módulo no ambiente correto, sem precisar de uma instalação global.

{
  "command": "uv",
  "args": ["run", "server.py"]
}

Passe variáveis de ambiente

Segredos, como chaves de API, devem ficar em um objeto env opcional. O host os injeta ao iniciar seu servidor, mantendo-os fora do código.

"env": { "API_KEY": "sk-..." }

Reinicie para aplicar

O Claude lê a configuração apenas ao iniciar. Depois de qualquer edição, você precisa reiniciar completamente o aplicativo para que ele carregue seu novo servidor.

O ícone de martelo

Quando tudo funciona, um pequeno indicador de ferramentas aparece na conversa. Ao clicar nele, você vê as ferramentas que seu servidor agora oferece ao Claude. 🔨

Escolha o nome com cuidado

A chave escolhida em mcpServers se torna o nome do servidor. Mantenha-o curto e exclusivo para que vários servidores nunca entrem em conflito no host.

Verificação rápida

Que alteração o Claude Desktop precisa receber antes de carregar um servidor recém-adicionado?

Responda na aula interativa

Recapitulação

Você adicionou seu servidor a claude_desktop_config.json com um comando, argumentos e env, usou caminhos absolutos e reiniciou o aplicativo. Ele está ativo no Claude! ✅

Grátis para começar

Aprenda Python com um tutor de IA — grátis

Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.

Cursos: 30
Aulas: 120

Começar a aprender grátis Ver o curso completo

Perguntas Frequentes

A aula “Integrá-lo ao Claude Desktop” é grátis?

Sim — o texto completo de “Integrá-lo ao Claude Desktop” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.

O que vou aprender em “Integrá-lo ao Claude Desktop”?

Edite a configuração para que o Claude carregue seu servidor. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar MCP Academy?

Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Integrá-lo ao Claude Desktop”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de MCP Academy?

Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para MCP Academy