AI Coding
MCP Servers: Guia Completo de Configuracao
MCP e o protocolo que conecta seu agente de IA ao mundo real — banco de dados, GitHub, APIs, filesystem. Aqui ta o guia completo pra configurar, usar
DevDoido
15 min de leitura
compartilhar
MCP
Carregando
MCP e o protocolo que conecta seu agente de IA ao mundo real — banco de dados, GitHub, APIs, filesystem. Aqui ta o guia completo pra configurar, usar
MCP Servers: Guia Completo de Configuracao. MCP e o protocolo que conecta seu agente de IA ao mundo real — banco de dados, GitHub, APIs, filesystem. Aqui ta o guia completo pra configurar, usar e ate criar seu proprio server.
Galera, MCP e tipo um USB pra agentes de IA. Assim como USB padronizou a conexao entre computador e perifericos, MCP padroniza a conexao entre um modelo de linguagem e ferramentas externas. Antes do MCP, cada integracao era customizada — agora existe um protocolo unico.
A arquitetura e cliente-servidor. O cliente e a ferramenta de IA (Claude, Cursor, Codex) e o servidor e um processo que expoe 'tools' via JSON-RPC sobre stdio ou HTTP. Quando voce pede pro Claude 'consultar o banco de dados', ele chama a tool do MCP Server de PostgreSQL, que executa a query e devolve o resultado.
Cada MCP Server expoe tres tipos de recursos: tools (funcoes que o agente pode chamar), resources (dados que o agente pode ler) e prompts (templates pre-definidos). Na pratica, tools sao o que voce mais usa — tipo 'executar SQL', 'criar issue no GitHub', 'ler arquivo'.
O mais legal e que o servidor roda local na sua maquina. Seus dados nao passam por nenhuma API externa — o agente se comunica direto com o processo local. Isso resolve a preocupacao de seguranca que muita gente tem com IA acessando dados sensiveis.
No Claude Desktop, a config fica no arquivo de configuracao do app. No Claude Code (CLI), fica no .mcp.json na raiz do projeto ou no ~/.claude/settings.json pra config global. Vou mostrar os dois.
Esse JSON vai no arquivo claude_desktop_config.json. No Mac fica em ~/Library/Application Support/Claude/. No Windows em %APPDATA%/Claude/. Salva, reinicia o Claude Desktop e pronto — os servers aparecem automaticamente.
No Claude Code, crie um arquivo .mcp.json na raiz do projeto. Ele e carregado automaticamente quando voce inicia o claude na pasta. Pra config global (todos os projetos), coloca no ~/.claude/settings.json dentro da chave mcpServers.
Dica importante: nao coloque tokens e senhas direto no JSON commitado. Use variaveis de ambiente ou um .mcp.json no .gitignore. Seguranca primeiro, galera.
Existem dezenas de MCP Servers open source prontos pra usar. Aqui vai a lista dos que realmente fazem diferenca no dia a dia de um dev.
Automacao de browser. Testes E2E com o agente.
Quando nenhum server pronto resolve seu problema, da pra criar o seu em menos de 50 linhas de TypeScript. O SDK oficial facilita muito.
Aqui vai um exemplo minimo de MCP Server que consulta o preco do dolar: