Claude MCP Integrations

Claude Code - n8n + Supabase MCP Integration

Repositório completo para integração de Claude Code com n8n e Supabase via Model Context Protocol (MCP), com operações CRUD seguras, scripts de automação e compatibilidade CLI/Web.

📚 Índice

• Visão Geral
• Estrutura do Repositório
• Início Rápido
• Configuração Detalhada
• Documentação
• Exemplos de Uso
• Limitações e Soluções
• Contribuição
• Licença

🎯 Visão Geral

Este repositório fornece uma estrutura completa para integração do Claude Code (CLI e Web) com:

• n8n: Plataforma de automação de workflows (API REST)
• Supabase: Backend-as-a-Service com PostgreSQL (REST API + MCP)

Capacidades Principais

Diferenciais

✅ Compatibilidade Universal: Scripts funcionam em Claude Code CLI e Web ✅ Segurança: Variáveis de ambiente protegidas, .gitignore configurado ✅ Documentação Completa: Guias para setup, testes e limitações ✅ Pronto para Produção: Exemplos de CI/CD e monitoramento ✅ Zero Dependências Complexas: Apenas Python e Bash nativos

📁 Estrutura do Repositório

claude-mcp-integrations/
├── .mcp.json                   # Configuração dos servidores MCP (n8n e Supabase)
├── .env.example                # Template de variáveis de ambiente
├── .gitignore                  # Proteção de credenciais e arquivos sensíveis
│
├── scripts/                    # Scripts de automação e demonstração
│   ├── n8n_api_demo.py         # Demo completo da API n8n (CRUD)
│   ├── supabase_demo.py        # Demo completo da API Supabase
│   ├── list_n8n_workflows.sh   # Utilitário Bash para listar workflows
│   └── query_supabase.sh       # Utilitário Bash para queries SQL
│
├── docs/                       # Documentação detalhada
│   ├── MCP_SETUP.md            # Guia de configuração MCP (local e Codespaces)
│   ├── MCP_WEB_LIMITATIONS.md  # Limitações do ambiente web e soluções
│   └── TESTING_GUIDE.md        # Guia de testes e exemplos avançados
│
└── README.md                   # Este arquivo

🚀 Início Rápido

Pré-requisitos

• Python 3.8+ (para scripts Python)
• Node.js 18+ (para servidores MCP via npx)
• Credenciais:

- n8n API Key (como obter) - Supabase Service Role Key (como obter)

1. Clone o Repositório

git clone https://github.com/seu-usuario/claude-mcp-integrations.git
cd claude-mcp-integrations

2. Configure as Variáveis de Ambiente

# Copie o template
cp .env.example .env

# Edite com suas credenciais reais
nano .env

Conteúdo do .env:

# n8n
N8N_API_URL=https://seu-dominio.n8n.cloud
N8N_API_KEY=sua_api_key
N8N_INSTANCE_URL=https://seu-dominio.n8n.cloud

# Supabase
SUPABASE_URL=https://seu-projeto.supabase.co
SUPABASE_SERVICE_ROLE_KEY=sua_service_role_key

3. Carregue as Variáveis

export $(cat .env | xargs)

4. Teste as Conexões

# Teste n8n
python3 scripts/n8n_api_demo.py

# Teste Supabase
python3 scripts/supabase_demo.py

# Ou use os scripts Bash
./scripts/list_n8n_workflows.sh
./scripts/query_supabase.sh customers 5

Resultado esperado: Mensagens de sucesso e dados das APIs.

⚙️ Configuração Detalhada

Ambiente Local (Desktop)

Para usar os MCP tools diretamente no Claude Code CLI:

1. Instale o Node.js:
2. Configure o .mcp.json (já incluído)
3. Inicie o Claude Code CLI: claude-code
4. Teste os MCPs:

/mcp list
/mcp call n8n list_workflows
/mcp call supabase list_projects

Veja o guia completo: docs/MCP_SETUP.md

GitHub Codespaces (Web)

Para usar no Claude Code Web via Codespaces:

1. Vá em: Settings → Secrets and variables → Codespaces
2. Adicione os secrets:

- N8N_API_URL - N8N_API_KEY - SUPABASE_URL - SUPABASE_SERVICE_ROLE_KEY

1. Abra o Codespace e use os scripts Python/Bash (MCP não funciona diretamente no web)

Veja as limitações e soluções: docs/MCP_WEB_LIMITATIONS.md

📖 Documentação

💡 Exemplos de Uso

Exemplo 1: Listar Workflows do n8n

Via MCP (CLI)

claude-code
/mcp call n8n list_workflows

Via Script Python (CLI/Web)

python3 scripts/n8n_api_demo.py

Via Script Bash (CLI/Web)

./scripts/list_n8n_workflows.sh

Via Python Customizado (CLI/Web)

import os
import requests

url = f"{os.environ['N8N_API_URL']}/api/v1/workflows"
headers = {'X-N8N-API-KEY': os.environ['N8N_API_KEY']}
response = requests.get(url, headers=headers)

for wf in response.json()['data']:
    print(f"{wf['name']} - Ativo: {wf['active']}")

Exemplo 2: Consultar Tabela do Supabase

Via MCP (CLI)

claude-code
/mcp call supabase execute_sql '{
  "project_id": "seu_project_id",
  "query": "SELECT * FROM customers LIMIT 5"
}'

Via Script Python (CLI/Web)

import os
import requests

url = f"{os.environ['SUPABASE_URL']}/rest/v1/customers"
headers = {
    'apikey': os.environ['SUPABASE_SERVICE_ROLE_KEY'],
    'Authorization': f"Bearer {os.environ['SUPABASE_SERVICE_ROLE_KEY']}"
}

response = requests.get(url, headers=headers, params={'limit': 5})
print(response.json())

Via Script Bash (CLI/Web)

./scripts/query_supabase.sh customers 5

Exemplo 3: Criar Workflow n8n que Integra com Supabase

Veja o exemplo completo em: docs/TESTING_GUIDE.md#exemplo-1-criar-workflow-n8n-que-consulta-supabase

🔧 Limitações e Soluções

Claude Code Web (Browser/Codespaces)

❌ Limitação: Não pode invocar MCP tools diretamente.

✅ Solução: Use scripts Python/Bash que acessam REST APIs (todos incluídos neste repo).

Claude Code CLI (Desktop)

✅ Suporta: MCP tools nativamente + scripts Python/Bash.

Comparativo completo: docs/MCP_WEB_LIMITATIONS.md

🧪 Testes Automatizados

GitHub Actions

Exemplo de workflow CI/CD (crie em .github/workflows/test.yml):

name: Test Integrations

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
        with:
          python-version: '3.10'

      - name: Test n8n
        env:
          N8N_API_URL: ${{ secrets.N8N_API_URL }}
          N8N_API_KEY: ${{ secrets.N8N_API_KEY }}
          N8N_INSTANCE_URL: ${{ secrets.N8N_API_URL }}
        run: python3 scripts/n8n_api_demo.py

      - name: Test Supabase
        env:
          SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
          SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}
        run: python3 scripts/supabase_demo.py

🤝 Contribuição

Contribuições são bem-vindas! Para contribuir:

1. Fork este repositório
2. Crie uma branch: git checkout -b feature/nova-funcionalidade
3. Commit suas mudanças: git commit -m 'Add nova funcionalidade'
4. Push para a branch: git push origin feature/nova-funcionalidade
5. Abra um Pull Request

Checklist para PRs

• [ ] Scripts testados em ambiente CLI e Web
• [ ] Documentação atualizada se aplicável
• [ ] Variáveis sensíveis não commitadas
• [ ] Código segue os padrões do repositório

📄 Licença

Este projeto está licenciado sob a MIT License.

🆘 Suporte e Recursos

Documentação Oficial

• Claude Code Docs
• n8n API Reference
• Supabase REST API
• Model Context Protocol (MCP)

Comunidade

• Anthropic Discord
• n8n Community
• Supabase Discord

Issues

Encontrou um bug ou tem uma sugestão? Abra uma issue

📊 Status do Projeto

• ✅ Configuração MCP para n8n e Supabase
• ✅ Scripts Python de demonstração CRUD
• ✅ Scripts Bash utilitários
• ✅ Documentação completa (Setup, Testes, Limitações)
• ✅ Compatibilidade CLI e Web
• ✅ Exemplos avançados de integração
• 🚧 GitHub Actions templates (em progresso)
• 🚧 Testes unitários (planejado)

🎓 Aprenda Mais

Novato? Comece por aqui:

1. Leia o MCP_SETUP.md para configurar tudo
2. Execute python3 scripts/n8n_api_demo.py para ver a API em ação
3. Consulte o TESTING_GUIDE.md para exemplos práticos
4. Leia MCP_WEB_LIMITATIONS.md se usar o ambiente web

Experiente? Vá direto para:

• Exemplos Avançados
• Automação CI/CD

⭐ Apoie o Projeto

Se este repositório foi útil, considere:

• ⭐ Dar uma estrela no GitHub
• 🍴 Fazer um fork e contribuir
• 📢 Compartilhar com a comunidade
• 💬 Reportar bugs ou sugerir melhorias

Desenvolvido com ❤️ para a comunidade Claude Code

 ______ _                 _        ______ ______ ______
|  ____| |               | |      |  ____|  ____|  ____|
| |__  | | __ _ _   _  __| | ___  | |__  | |__  | |__
|  __| | |/ _` | | | |/ _` |/ _ \ |  __| |  __| |  __|
| |____| | (_| | |_| | (_| |  __/ | |____| |____| |
|______|_|\__,_|\__,_|\__,_|\___| |______|______|_|

        n8n + Supabase + MCP Integration

🔗 Links Rápidos

• Setup Guide → Configuração passo a passo
• Testing Guide → Exemplos práticos
• Web Limitations → CLI vs Web
• Scripts Python → Automação pronta
• Scripts Bash → Utilitários shell

Pronto para começar? Execute: cp .env.example .env e configure suas credenciais! 🚀