Guia de Instalacao de Plugins MCP

Aprenda a instalar e configurar servidores MCP (Model Context Protocol) para ampliar as capacidades do Claude com ferramentas externas, fontes de dados e integracoes.

O Model Context Protocol (MCP) e um padrao aberto criado pela Anthropic que padroniza a forma como modelos de IA se conectam a fontes de dados e ferramentas externas. Frequentemente descrito como "USB-C para IA", o MCP fornece uma interface universal para o Claude interagir com seus arquivos locais, bancos de dados, APIs e ferramentas de desenvolvimento.

Desde 2026, o MCP e suportado pela Anthropic, OpenAI, Google e Microsoft, tornando-se o padrao de integracao de fato para agentes de IA. Atualmente existem mais de 593 servidores MCP disponiveis no ecossistema, desde pacotes oficiais da Anthropic ate integracoes criadas pela comunidade.

Pre-requisitos

terminal

Node.js (LTS)

Necessario para executar a maioria dos servidores MCP via npx. Baixe em nodejs.org.

code

Python / uv (Opcional)

Alguns servidores MCP sao baseados em Python e usam uvx em vez de npx.

desktop_mac

Claude Desktop

O aplicativo Claude Desktop deve estar instalado. Disponivel para macOS e Windows.

info

Nenhuma Assinatura Necessaria

Os servidores MCP funcionam com qualquer plano do Claude, incluindo o plano gratuito.

Local do Arquivo de Configuracao

Os servidores MCP sao configurados no arquivo claude_desktop_config.json. A localizacao do arquivo depende do seu sistema operacional:

desktop_mac macOS

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

desktop_windows Windows

%APPDATA%\Claude\claude_desktop_config.json

lightbulb

Dica

Voce nao precisa criar este arquivo manualmente. O Claude Desktop pode gera-lo para voce — veja os passos de instalacao abaixo.

Instalacao Passo a Passo

Abra o Claude Desktop

Abra o aplicativo Claude Desktop no seu computador.

Abra as Configuracoes

Clique no menu hamburger → File → Settings (ou use o atalho de teclado).

Navegue ate a Aba Developer

No painel de Configuracoes, clique na aba "Developer" na barra lateral esquerda.

Clique em "Edit Config"

Isso abre (ou cria) o arquivo claude_desktop_config.json no seu editor de texto padrao.

Adicione a Configuracao do Servidor MCP

Adicione os servidores MCP desejados na chave mcpServers (veja o formato de configuracao abaixo).

Salve e Reinicie

Salve o arquivo de configuracao e reinicie o Claude Desktop completamente para que as alteracoes entrem em vigor.

Verifique a Instalacao

Procure pelo icone de martelo 🔨 na interface do Claude Desktop. Ao clicar nele, todas as ferramentas MCP disponiveis serao exibidas.

Formato de Configuracao

O arquivo de configuracao usa uma estrutura JSON simples. Cada servidor MCP e definido dentro da chave mcpServers:

data_object Estrutura Basica

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

folder Exemplo do Servidor Filesystem

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

stacks Exemplo com Multiplos Servidores

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Servidores MCP Populares

Aqui estao os servidores MCP mais utilizados no ecossistema:

Servidor	Pacote	Finalidade
Filesystem	`@modelcontextprotocol/server-filesystem`	Ler/gravar arquivos locais, criar documentos, organizar pastas
GitHub	`@modelcontextprotocol/server-github`	Ler repositorios, inspecionar PRs, acompanhar workflows
PostgreSQL	`@modelcontextprotocol/server-postgres`	Acesso somente leitura ao banco de dados com inspecao de schema
Brave Search	`@modelcontextprotocol/server-brave-search`	Capacidades de busca na web
Puppeteer	`@modelcontextprotocol/server-puppeteer`	Automacao de navegador e web scraping
Sequential Thinking	`@modelcontextprotocol/server-sequential-thinking`	Raciocinio dinamico e resolucao de problemas passo a passo
Slack	`@anthropic/mcp-server-slack`	Integracao com workspace do Slack
Google Drive	`@anthropic/mcp-server-gdrive`	Integracao com Google Docs, Sheets e Drive
Docker	`@anthropic/mcp-server-docker`	Gerenciamento e orquestracao de containers
Memory	`@modelcontextprotocol/server-memory`	Memoria persistente entre sessoes

Protocolos de Transporte

O MCP suporta diferentes mecanismos de transporte para a comunicacao entre o Claude e os servidores MCP:

terminal

stdio (Entrada/Saida Padrao)

O transporte padrao para o Claude Desktop. O cliente inicia o servidor MCP como um processo local e se comunica via stdin/stdout. E isso que os campos command e args na configuracao definem.

check Recomendado para uso local

cloud

StreamableHTTP

O protocolo recomendado para acesso web e remoto. Suporta multiplos clientes simultaneos e e o sucessor do transporte SSE, que foi descontinuado.

language Para servidores remotos/web

do_not_disturb

SSE (Server-Sent Events)

Descontinuado em favor do StreamableHTTP. Evite usar em novas integracoes.

Consideracoes de Seguranca

warning

Importante

Os servidores MCP rodam localmente com acesso ao seu sistema. Em janeiro de 2026, vulnerabilidades criticas foram descobertas no servidor MCP oficial de Git da Anthropic. Sempre siga as boas praticas de seguranca.

check_circle

Instale apenas de fontes verificadas — Use pacotes oficiais da Anthropic ou servidores comunitarios conhecidos com manutencao ativa.

check_circle

Mantenha os servidores atualizados — Execute npx @package/server-name regularmente para obter as correcoes de seguranca mais recentes.

check_circle

Use variaveis de ambiente para segredos — Nunca insira chaves de API diretamente no arquivo de configuracao. Use o campo env ou variaveis de ambiente do sistema.

check_circle

Restrinja o escopo do sistema de arquivos — Ao usar o servidor filesystem, conceda acesso apenas aos diretorios especificos que voce precisa.

check_circle

Remova servidores nao utilizados — Cada servidor MCP aumenta sua superficie de ataque. Remova qualquer um que voce nao esteja usando ativamente.

arrow_forward Leia nosso Guia Completo de Seguranca contra Prompt Injection

Solucao de Problemas

O icone de martelo nao aparece apos reiniciar expand_more

Isso geralmente significa que o arquivo de configuracao tem um erro de sintaxe JSON. Problemas comuns:

Virgulas faltando ou extras entre as entradas de servidores
Colchetes ou chaves sem correspondencia
Uso de aspas simples em vez de aspas duplas

Valide seu JSON em jsonlint.com ou use node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"

O servidor MCP nao inicia expand_more

Verifique o seguinte:

Certifique-se de que o Node.js esta instalado e que o npx esta disponivel no seu PATH
Tente executar o comando npx manualmente no terminal para ver a saida de erro
Verifique se o nome do pacote esta correto (erros de digitacao sao comuns)
Para servidores que exigem chaves de API, verifique se a chave e valida e esta configurada corretamente no campo env

Erros de permissao negada expand_more

Os servidores MCP herdam as permissoes do processo do Claude Desktop:

No macOS, verifique Ajustes do Sistema → Privacidade e Seguranca para as permissoes relevantes
Certifique-se de que os diretorios especificados na configuracao sao acessiveis pela sua conta de usuario
Para o servidor filesystem, verifique se os caminhos em args existem e sao legiveis

extension

Explore o Ecossistema MCP

Com mais de 593 servidores MCP disponiveis, provavelmente existe um servidor para o seu caso de uso. Navegue pelo diretorio oficial de servidores MCP em modelcontextprotocol.io ou confira listas curadas pela comunidade no GitHub para as adicoes mais recentes.