Conectar Claude al Workspace
Para: Todos (Txell, Dani, Edu) Requisito: Cuenta Claude Max activa + token MCP personal (pedir a Edu) 43 herramientas disponibles: tareas, noticias, servidores, GitHub, Holded ERP, documentacion
Como conectar
Opcion 1: claude.ai (web) — Recomendado
Funciona en cualquier navegador, sin instalar nada.
- Ir a claude.ai → click en tu perfil → Settings
- En el sidebar: Connectors
- Scroll abajo → Add custom connector
- URL:
https://workspace.crearack.com/api/mcp - Click Conectar → se abre pagina de login CreaRack
- Introduce tu token MCP personal
- Vuelve a Settings → Connectors → click Configurar en el connector
- Activa TODAS las herramientas (importante — sin esto Claude se cuelga)
Listo. Abre un chat nuevo y prueba: “¿Que tareas hay pendientes?”
Opcion 2: Claude Desktop (app Cowork)
Incluye funciones extra: tareas programadas, Desktop Control, Dispatch.
- Descargar desde https://claude.ai/download
- Instalar y abrir
- Localizar el archivo de configuracion:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
- Anadir dentro de
"mcpServers":
"workspace": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://workspace.crearack.com/api/mcp"]
}
- Reiniciar Claude Desktop completamente
- La primera vez te abrira el browser para autenticar con tu token
Nota: Claude Desktop NO soporta URLs directas — usa
mcp-remotecomo puente.
Opcion 3: Claude Code (terminal)
Para developers (Edu, Dani). Permite que Claude Code interactue con el workspace desde la terminal.
- Crear archivo
.mcp.jsonen la raiz del proyecto (C:\dev\CreaRack-Pro\):
{
"mcpServers": {
"workspace": {
"type": "url",
"url": "https://workspace.crearack.com/api/mcp",
"headers": {
"Authorization": "Bearer TU_TOKEN_AQUI"
}
}
}
}
- Reiniciar Claude Code
Nota:
.mcp.jsonesta en.gitignore— contiene tu token personal.
Que modelo usar
| Modelo | Cuando | Ejemplo |
|---|---|---|
| Haiku 4.5 | 90% de interacciones — rapido y economico | Tareas, facturas, servidores, consultas |
| Sonnet 4.6 | Redaccion y analisis | Emails, contratos, resumen documentos |
| Opus 4.6 | Decisiones complejas | Planificacion, arquitectura, informes |
Todas las capacidades (43 herramientas)
Tareas del equipo
Gestionar el kanban del workspace: crear, asignar, priorizar, completar.
"Crea una tarea para Dani: revisar PRs abiertos, prioridad alta, para el viernes"
"Lista todas las tareas urgentes"
"Que tareas tiene Edu pendientes?"
"Mueve la tarea de backups a completada"
"Elimina la tarea de prueba"
| Herramienta | Accion |
|---|---|
list_tasks | Listar con filtros (assignee, estado, prioridad) |
create_task | Crear con titulo, descripcion, assignee, prioridad, fecha |
update_task | Cambiar estado, prioridad, asignacion |
delete_task | Eliminar por ID |
Noticias y comunicados
Publicar avisos, actas de reunion, comunicados internos.
"Publica una noticia: reunion de equipo el jueves a las 10:00"
"Edita la ultima noticia, cambia la hora a las 11:00"
"Lista las noticias recientes"
"Elimina la noticia de prueba"
| Herramienta | Accion |
|---|---|
list_news | Listar noticias (filtro: fijadas) |
create_news | Publicar con titulo, contenido, categoria |
update_news | Editar contenido o fijar/desfijar |
delete_news | Eliminar por ID |
Alertas del sistema
Alertas urgentes visibles para todo el equipo en el dashboard.
"Crea una alerta: mantenimiento programado manana de 8:00 a 10:00"
"Hay alertas activas?"
"Desactiva la alerta actual"
"Elimina las alertas antiguas"
| Herramienta | Accion |
|---|---|
list_alerts | Ver alertas activas |
create_alert | Crear (desactiva las anteriores automaticamente) |
update_alert | Activar/desactivar, cambiar mensaje |
delete_alert | Eliminar por ID |
Notas rapidas
Post-its del equipo con colores.
"Crea una nota: recordar llamar al proveedor de fibra"
"Lista mis notas"
"Cambia el color de la nota a rojo"
"Elimina la nota de prueba"
| Herramienta | Accion |
|---|---|
list_notes | Listar (filtro: autor) |
create_note | Crear con titulo, contenido, color |
update_note | Editar contenido o color |
delete_note | Eliminar por ID |
Servidores e infraestructura
Estado en tiempo real de PROD, Staging y Workspace.
"Como estan los servidores?"
"Cual es el uptime de produccion?"
"Dame las metricas de CreaRack Pro"
"Dame un resumen completo del workspace"
| Herramienta | Accion |
|---|---|
get_servers_status | Servidores Hetzner: IP, CPU, RAM, estado |
get_uptime | UptimeRobot: uptime %, response time + notas contextuales |
get_metrics | CreaRack Pro: usuarios, racks, dispositivos, monitores |
get_dashboard | Resumen completo: tareas + noticias + alertas |
Nota: Staging puede aparecer como “Down” en uptime — es normal, no tiene Django activo permanentemente.
GitHub
PRs, issues y actividad del repositorio sin salir de Claude.
"Hay PRs abiertos en CreaRack-Pro?"
"Lista los issues abiertos"
"Crea un issue: revisar facturacion de marzo, asignalo a Edu"
"Resume la actividad de GitHub de la ultima semana"
| Herramienta | Accion |
|---|---|
github_list_prs | PRs abiertos/cerrados con filtros |
github_list_issues | Issues con filtros (estado, labels) |
github_create_issue | Crear issue con titulo, descripcion, labels, assignees |
github_repo_activity | Commits, PRs mergeados, contributors por periodo |
Documentacion del workspace
Leer guias, planes y el worklog del equipo directamente desde Claude.
"Muestrame la guia de onboarding de Txell"
"Que guias hay disponibles?"
"Lee el worklog del equipo"
"Muestrame el plan del ecosistema Cowork"
| Herramienta | Accion |
|---|---|
list_guides | Lista todas las guias, planes y documentos |
read_guide | Lee el contenido completo de un documento |
read_worklog | Lee el dietario de actividad del equipo |
Holded ERP — Facturacion
Crear, consultar y enviar facturas con IVA directamente desde Claude.
"Crea una factura para DataCenter Solutions por 2.500 euros de servicio mensual con IVA 21%"
"Lista las facturas pendientes de cobro"
"Cuanto hemos facturado este trimestre?"
"Envia la factura al cliente por email"
"Marca la factura como pagada por transferencia bancaria"
| Herramienta | Accion |
|---|---|
holded_list_invoices | Facturas con filtros (pagadas, pendientes, por cliente, por fecha) |
holded_create_invoice | Crear factura con lineas, IVA, cliente, vencimiento |
holded_send_invoice | Enviar factura por email al cliente |
holded_mark_paid | Marcar como pagada (total o parcial) |
holded_financial_summary | Resumen: total facturado, cobrado, pendiente por periodo |
Holded ERP — Contactos y clientes
Gestionar la cartera de clientes y proveedores.
"Lista todos los clientes"
"Crea un contacto: empresa NetworkPro SL, NIF B12345678, Barcelona"
"Dame los datos del cliente DataCenter Solutions"
| Herramienta | Accion |
|---|---|
holded_list_contacts | Listar clientes y proveedores |
holded_create_contact | Crear con nombre, NIF, email, direccion, tipo |
holded_get_contact | Detalle completo de un contacto |
Holded ERP — Productos y servicios
Gestionar el catalogo de productos y servicios.
"Que servicios tenemos dados de alta?"
"Crea un servicio: Plan Enterprise, 299 euros/mes, IVA 21%"
| Herramienta | Accion |
|---|---|
holded_list_products | Productos y servicios con precios |
holded_create_product | Crear producto o servicio con precio e IVA |
Holded ERP — Pagos y tesoreria
Consultar pagos registrados y saldos bancarios.
"Lista los pagos recibidos"
"Cual es el saldo de las cuentas bancarias?"
| Herramienta | Accion |
|---|---|
holded_list_payments | Pagos registrados |
holded_list_treasury | Cuentas bancarias con saldos |
Holded ERP — CRM y gastos
Prospectos comerciales y control de gastos.
"Crea un prospecto: empresa TechVision, valor potencial 5.000 euros"
"Lista los leads del CRM"
"Que categorias de gastos tenemos?"
| Herramienta | Accion |
|---|---|
holded_list_leads | Prospectos/leads del embudo de ventas |
holded_create_lead | Nuevo prospecto con empresa, valor, notas |
holded_list_expenses | Cuentas de gastos configuradas |
Acciones combinadas
Lo mas potente del connector es combinar herramientas en una sola peticion:
"Crea una factura para todos los clientes con tareas completadas este mes"
"Revisa las facturas pendientes de mas de 30 dias y crea una tarea de cobro para cada una"
"Dame un informe completo: servidores, facturas pendientes y tareas urgentes"
"Crea un contacto en Holded para el nuevo cliente y asignale una tarea de onboarding a Txell"
Claude combina automaticamente las herramientas necesarias para completar la accion.
Problemas frecuentes
| Problema | Solucion |
|---|---|
| Claude se queda cargando la herramienta | Settings → Connectors → Configurar → activar TODAS las herramientas |
| ”No tengo acceso” | Verificar que el connector esta conectado |
| Herramientas nuevas no aparecen | Desconectar y reconectar el connector |
| Token invalido | Pedir token nuevo a Edu |
| Desktop: “configuracion invalida” | Usar mcp-remote, no formato url directo |
| Holded: “API key not configured” | Verificar env var HOLDED_API_KEY en Cloudflare Pages |