MCP Setup

Solução padronizada para instalação e configuração de MCP Servers no Claude Code, adaptável a qualquer tipo de projeto.

Visão Geral

O MCP Setup é uma solução que padroniza e automatiza a configuração de servidores MCP (Model Context Protocol) para o Claude Code. Permite que desenvolvedores, arquitetos e equipes configurem rapidamente as integrações necessárias para seus projetos, sem precisar repetir trabalho manual ou conhecer detalhes de autenticação de cada serviço.

Destinado a profissionais e equipes que trabalham com múltiplos projetos de software — desde sites estáticos até plataformas SaaS com pagamentos, automação e IA.

Problema

Configurar integrações MCP manualmente para cada novo projeto gera:

• Retrabalho — mesmas configurações repetidas em cada projeto
• Inconsistência — configurações divergem entre projetos e membros da equipe
• Risco de segurança — credenciais mal gerenciadas ou expostas em repositórios
• Barreira de entrada — cada integração exige conhecimento específico de autenticação e configuração

Funcionalidades

• Perfis de configuração pré-definidos por tipo de projeto (5 templates)
• Instalação automatizada e interativa de servidores MCP
• Gestão de escopos: global (user), projeto (project) e local
• Separação segura de credenciais via variáveis de ambiente
• Documentação integrada de credenciais, segurança e troubleshooting
• Suporte a 14 integrações MCP padronizadas

Templates Disponíveis

| Template | MCPs | Cenário de Uso | |----------|------|----------------| | minimal | 3 | Sites estáticos, portfólios, landing pages | | base | 9 | Projetos padrão com PM, design e deploy | | saas | 12 | SaaS, CRM, plataformas com pagamentos e banco de dados | | agents | 14+ | Projetos com agentes IA, workflows N8N, automação | | full | 14 | Setup global completo (escopo user) |

MCPs Suportados

| Categoria | MCP | Autenticação | |-----------|-----|-------------| | Desenvolvimento | GitHub | Bearer Token | | Documentação | Context7 | Nenhuma | | Design | Figma | OAuth | | | Stitch | API Key | | Gestão e Comunicação | Linear | OAuth | | | Slack | OAuth | | | ClickUp | OAuth | | Infraestrutura | Hetzner | API Token | | | Coolify | API Token | | Banco de Dados | PostgreSQL | DSN | | Workflow | N8N Docs | Nenhuma | | | N8N Instance | Bearer Token | | Segurança e Monitoramento | Semgrep | Nenhuma | | | Sentry | OAuth | | Testes | Playwright | Nenhuma |

Estrutura do Projeto

mcp-setup/
├── CLAUDE.md
├── CHANGELOG.md
├── README.md
├── LICENSE
├── .gitignore
├── .claude/
│   ├── rules/
│   └── documents/
│       ├── tbs/           # Technical Briefs
│       ├── adrs/          # Architecture Decision Records
│       ├── specs/         # Especificações
│       └── irs/           # Implementation Records
├── repo/
│   └── mcp-project-ecope/ # Protótipo e escopo original
├── templates/              # Templates MCP por tipo de projeto
├── scripts/                # Scripts de instalação e utilitários
├── docs/                   # Documentação do projeto
│   ├── credentials.md
│   ├── security.md
│   ├── scopes.md
│   └── troubleshooting.md
└── tests/                  # Testes automatizados

Quick Start

# 1. Clone o repositório
git clone <repo-url> && cd mcp-setup

# 2. Copie o arquivo de variáveis de ambiente
cp .env.example .env

# 3. Preencha as credenciais no .env
# Consulte docs/credentials.md para instruções detalhadas

# 4. Execute a instalação com o template desejado
./scripts/install.sh --template base

Instruções detalhadas de instalação serão disponibilizadas após a fase de implementação.

Documentação

| Documento | Descrição | |-----------|-----------| | Credenciais | Como obter e configurar credenciais para cada MCP | | Segurança | Boas práticas de segurança para configuração MCP | | Escopos | Gestão de escopos: user, project e local | | Troubleshooting | Resolução de problemas comuns |

Roadmap

• [ ] CLI próprio para instalação e gestão de MCPs
• [ ] Suporte nativo a Windows (PowerShell/CMD)
• [ ] Validação automática de credenciais durante instalação
• [ ] Composição dinâmica de templates (merge/overlay)
• [ ] Mecanismo de atualização de MCPs já instalados
• [ ] Testes automatizados para scripts e templates

Licença

MIT

Autor

Edilson Jr — Tech Advisor & Arquiteto e Engenheiro de Software