/translations/pt-BR/03-GettingStarted/12-mcp-hosts/README.md

Configurando Clientes MCP Host Populares

Este guia cobre como configurar e usar servidores MCP com aplicações host populares de IA. Cada host tem sua própria abordagem de configuração, mas uma vez configurados, todos se comunicam com os servidores MCP usando o protocolo padronizado.

O que é um MCP Host?

Um MCP Host é uma aplicação de IA que pode se conectar a servidores MCP para expandir suas capacidades. Pense nele como a "interface" com a qual os usuários interagem, enquanto os servidores MCP fornecem as ferramentas e dados do "back end".

flowchart LR
    User[👤 Usuário] --> Host[🖥️ Host MCP]
    Host --> S1[Servidor MCP A]
    Host --> S2[Servidor MCP B]
    Host --> S3[Servidor MCP C]
    
    subgraph "Hosts Populares"
        H1[Claude Desktop]
        H2[VS Code]
        H3[Cursor]
        H4[Cline]
        H5[Windsurf]
    end

Pré-requisitos

• Um servidor MCP para se conectar (veja Módulo 3.1 - Primeiro Servidor)
• A aplicação host instalada em seu sistema
• Familiaridade básica com arquivos de configuração JSON

---

1. Claude Desktop

Claude Desktop é a aplicação oficial desktop da Anthropic que suporta MCP nativamente.

Instalação

1. Baixe o Claude Desktop em claude.ai/download
2. Instale e faça login com sua conta Anthropic

Configuração

O Claude Desktop utiliza um arquivo de configuração JSON para definir servidores MCP.

Local do arquivo de configuração:

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

Exemplo de configuração:

{
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"],
      "env": {
        "PYTHONPATH": "/path/to/your/server"
      }
    },
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-server/build/index.js"]
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
      }
    }
  }
}

Opções de Configuração

Campo	Descrição	Exemplo
command	O executável a ser executado	"python", "node", "npx"
args	Argumentos da linha de comando	["-m", "my_server"]
env	Variáveis de ambiente	{"API_KEY": "xxx"}
cwd	Diretório de trabalho	"/path/to/server"

Testando Sua Configuração

1. Salve o arquivo de configuração
2. Reinicie completamente o Claude Desktop (feche e abra novamente)
3. Abra uma nova conversa
4. Procure o ícone 🔌 indicando servidores conectados
5. Tente pedir ao Claude para usar uma de suas ferramentas

Solução de Problemas do Claude Desktop

Servidor não aparece:

• Verifique a sintaxe do arquivo de configuração com um validador JSON
• Certifique-se de que o caminho do comando está correto
• Verifique os logs do Claude Desktop: Ajuda → Mostrar Logs

Servidor trava ao iniciar:

• Teste seu servidor manualmente no terminal primeiro
• Verifique se as variáveis de ambiente estão definidas corretamente
• Garanta que todas as dependências estejam instaladas

---

2. VS Code com GitHub Copilot

O VS Code suporta MCP através das extensões GitHub Copilot Chat.

Pré-requisitos

1. VS Code 1.99+ instalado
2. Extensão GitHub Copilot instalada
3. Extensão GitHub Copilot Chat instalada

Configuração

O VS Code usa .vscode/mcp.json nas configurações do workspace ou do usuário.

Configuração do workspace (.vscode/mcp.json):

{
  "servers": {
    "my-calculator": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    },
    "my-database": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

Configuração do usuário (settings.json):

{
  "mcp.servers": {
    "global-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-memory"]
    }
  },
  "mcp.enableLogging": true
}

Usando MCP no VS Code

1. Abra o painel Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I)
2. Digite @ para ver as ferramentas MCP disponíveis
3. Use linguagem natural para invocar ferramentas: "Calcule 25 * 48 usando a calculadora"

Solução de Problemas do VS Code

Servidores MCP não carregam:

• Verifique o painel Output → "MCP" para logs de erro
• Recarregue a janela: Ctrl+Shift+P → "Developer: Reload Window"
• Verifique se o servidor roda standalone primeiro

---

3. Cursor

Cursor é um editor de código com foco em IA que suporta MCP nativamente.

Instalação

1. Baixe o Cursor em cursor.sh
2. Instale e faça login

Configuração

O Cursor usa um formato de configuração semelhante ao Claude Desktop.

Local do arquivo de configuração:

• macOS: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json
• Linux: ~/.cursor/mcp.json

Exemplo de configuração:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Usando MCP no Cursor

1. Abra o chat de IA do Cursor (Ctrl+L / Cmd+L)
2. As ferramentas MCP aparecem automaticamente nas sugestões
3. Peça para a IA realizar tarefas usando servidores conectados

---

4. Cline (Baseado em Terminal)

Cline é um cliente MCP baseado em terminal, ideal para fluxos de trabalho via linha de comando.

Instalação

npm install -g @anthropic/cline

Configuração

O Cline usa variáveis de ambiente e argumentos de linha de comando.

Usando variáveis de ambiente:

export ANTHROPIC_API_KEY="your-api-key"
export MCP_SERVER_CALCULATOR="python -m mcp_calculator_server"

Usando argumentos de linha de comando:

cline --mcp-server "calculator:python -m mcp_calculator_server" \
      --mcp-server "weather:node /path/to/weather/index.js"

Arquivo de configuração (~/.clinerc):

{
  "apiKey": "your-api-key",
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    }
  }
}

Usando o Cline

# Iniciar uma sessão interativa
cline

# Consulta única com MCP
cline "Calculate the square root of 144 using the calculator"

# Listar ferramentas disponíveis
cline --list-tools

---

5. Windsurf

Windsurf é outro editor de código com suporte a IA e MCP.

Instalação

1. Baixe o Windsurf em codeium.com/windsurf
2. Instale e crie uma conta

Configuração

A configuração do Windsurf é gerenciada pela interface de configurações:

1. Abra Configurações (Ctrl+, / Cmd+,)
2. Pesquise por "MCP"
3. Clique em "Editar em settings.json"

Exemplo de configuração:

{
  "windsurf.mcp.servers": {
    "my-tools": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {}
    }
  },
  "windsurf.mcp.enabled": true
}

---

Comparação dos Tipos de Transporte

Diferentes hosts suportam diferentes mecanismos de transporte:

Host	stdio	SSE/HTTP	WebSocket
Claude Desktop	✅	❌	❌
VS Code	✅	✅	❌
Cursor	✅	✅	❌
Cline	✅	✅	❌
Windsurf	✅	✅	❌

stdio (entrada/saída padrão): Melhor para servidores locais iniciados pelo host
SSE/HTTP: Melhor para servidores remotos ou servidores compartilhados entre múltiplos clientes

---

Solução de Problemas Comum

Servidor não inicia

1. Teste o servidor manualmente primeiro:

   # Para Python
   python -m your_server_module
   
   # Para Node.js
   node /path/to/server/index.js
   

2. Verifique o caminho do comando:

   • Utilize caminhos absolutos sempre que possível
   • Certifique-se que o executável está no seu PATH

3. Verifique as dependências:

   # Python
   pip list | grep mcp
   
   # Node.js
   npm list @modelcontextprotocol/sdk
   

Servidor conecta mas ferramentas não funcionam

1. Verifique os logs do servidor - A maioria dos hosts oferece opções de log
2. Verifique o registro das ferramentas - Use o MCP Inspector para testar
3. Verifique permissões - Algumas ferramentas precisam de acesso a arquivos/rede

Variáveis de ambiente não são passadas

• Alguns hosts sanitizam variáveis de ambiente
• Use o campo env da configuração explicitamente
• Evite dados sensíveis em arquivos de configuração (use gerenciamento de segredos)

---

Melhores Práticas de Segurança

1. Nunca comite chaves API em arquivos de configuração
2. Use variáveis de ambiente para dados sensíveis
3. Limite permissões do servidor ao mínimo necessário
4. Revise o código do servidor antes de conceder acesso ao seu sistema
5. Use listas de permissões para acesso ao sistema de arquivos e rede

---

Próximos Passos

• 3.13 - Depuração com MCP Inspector
• 3.1 - Crie seu primeiro servidor MCP
• Módulo 5 - Tópicos Avançados

---

Recursos Adicionais

• Documentação MCP do Claude Desktop
• Extensão MCP para VS Code
• Especificação MCP - Transportes
• Registro Oficial de Servidores MCP

---

Aviso Legal: Este documento foi traduzido utilizando o serviço de tradução automática Co-op Translator. Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.