Leonobitech MCP Infrastructure

Configuración de MCP servers (Model Context Protocol) que conectan Claude Code con la infraestructura completa de Leonobitech en el VPS.

✅ Estado del proyecto: COMPLETADO

Fase	Descripción	Estado	Fecha
Fase 0	Setup del proyecto	✅ Completada	1 Feb 2026
Fase 1	Bypass de Traefik/Core para APIs	✅ Completada	2 Feb 2026
Fase 2.1	SSH MCP Server	✅ Completada	2 Feb 2026
Fase 2.2	n8n MCP + Skills	✅ Completada	2 Feb 2026
Fase 2.3	Baserow MCP	✅ Completada	2 Feb 2026
Fase 3	CLAUDE.md y config	✅ Completada	2 Feb 2026
Fase 4	Testing end-to-end	✅ Completada	2 Feb 2026
Fase 5	Workflow diario documentado	✅ Completada	2 Feb 2026

---

Qué hace este proyecto

Permite administrar n8n, Baserow y el VPS completo desde Claude Code usando lenguaje natural, con respaldo en Git.

Claude Code (VSCode)
├── ssh-manager    → administración del VPS (30 contenedores)
├── n8n-mcp        → crear/editar/desplegar workflows
├── baserow-mcp    → CRUD de tablas y datos (8 tablas)
├── n8n-skills     → conocimiento experto de 1,084 nodos
└── Filesystem     → backups y versionado en Git

---

MCPs Configurados

MCP	Función	Validación
ssh-manager	Acceso SSH al VPS	✅ 30 contenedores visibles
n8n-mcp	Gestión de workflows	✅ 5 workflows con tag "leonobitech"
baserow-mcp	CRUD de datos	✅ 8 tablas accesibles
notion-mcp	Documentación en Notion	✅ Markdown completo (headings, código, tablas)

---

APIs Configuradas

Servicio	URL	Auth	Estado
n8n	https://n8n.leonobitech.com/api/v1/*	X-N8N-API-KEY header	✅ Bypass activo
Baserow	https://br.leonobitech.com/api/*	Authorization: Token xxx	✅ Bypass activo
Baserow MCP	https://br.leonobitech.com/mcp/*	Token en URL	✅ Bypass activo

---

Stack

• VPS: Docker Compose + Traefik + Core (auth)
• Servicios: n8n, Baserow, Chatwoot, Odoo, Qdrant
• Local: VSCode + Claude Code + MCP servers

---

Estructura del repo

├── CLAUDE.md                      # ⭐ Contexto para Claude Code
├── README.md                      # Este archivo
├── configs/
│   ├── mcp/                       # Configs de cada MCP server
│   └── traefik/                   # Reglas de bypass para APIs
├── docs/
│   ├── PROJECT_PLAN.md            # Plan original del proyecto
│   ├── ARCHITECTURE.md            # Diagrama de arquitectura
│   ├── FASE1_COMPLETED.md         # Bypass de Traefik/Core
│   ├── FASE2_SSH_IMPLEMENTATION.md # SSH MCP
│   ├── FASE2_N8N_MCP.md           # n8n MCP + Skills
│   ├── FASE2_BASEROW_MCP.md       # Baserow MCP
│   ├── FASE4_TESTING.md           # Testing end-to-end
│   ├── WORKFLOW_DIARIO.md         # Flujo de trabajo diario
│   ├── TROUBLESHOOTING.md         # Problemas comunes
│   └── PROJECT_CLOSURE.md         # Cierre del proyecto
├── scripts/
│   ├── setup-mcp.sh               # Instalación de MCPs
│   └── backup-workflows.sh        # Backup de workflows n8n
└── workflows/
    └── n8n/                       # JSONs de workflows exportados

---

Uso rápido

Ver estado del VPS

Usando ssh-manager, conectate a lnbt y ejecutá sudo docker ps

Listar workflows de n8n

Usando n8n-mcp, listá los workflows activos con tag "leonobitech"

Ver datos de Baserow

Usando baserow-mcp, ejecutá list_table_rows con table_id=851 y limit=5

---

Documentación

• CLAUDE.md — ⭐ Contexto para Claude Code (empezar acá)
• Workflow diario — Cómo usar día a día
• Troubleshooting — Problemas comunes
• Arquitectura — Diagrama del sistema
• Cierre del proyecto — Resumen final

---

Leonobitech — Automatización con IA para PyMEs en Latinoamérica