Conectar Claude al Workspace

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.

  1. Ir a claude.ai → click en tu perfil → Settings
  2. En el sidebar: Connectors
  3. Scroll abajo → Add custom connector
  4. URL: https://workspace.crearack.com/api/mcp
  5. Click Conectar → se abre pagina de login CreaRack
  6. Introduce tu token MCP personal
  7. Vuelve a Settings → Connectors → click Configurar en el connector
  8. 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.

  1. Descargar desde https://claude.ai/download
  2. Instalar y abrir
  3. Localizar el archivo de configuracion:
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  4. Anadir dentro de "mcpServers":
"workspace": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://workspace.crearack.com/api/mcp"]
}
  1. Reiniciar Claude Desktop completamente
  2. La primera vez te abrira el browser para autenticar con tu token

Nota: Claude Desktop NO soporta URLs directas — usa mcp-remote como puente.

Opcion 3: Claude Code (terminal)

Para developers (Edu, Dani). Permite que Claude Code interactue con el workspace desde la terminal.

  1. Crear archivo .mcp.json en 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"
      }
    }
  }
}
  1. Reiniciar Claude Code

Nota: .mcp.json esta en .gitignore — contiene tu token personal.


Que modelo usar

ModeloCuandoEjemplo
Haiku 4.590% de interacciones — rapido y economicoTareas, facturas, servidores, consultas
Sonnet 4.6Redaccion y analisisEmails, contratos, resumen documentos
Opus 4.6Decisiones complejasPlanificacion, 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"
HerramientaAccion
list_tasksListar con filtros (assignee, estado, prioridad)
create_taskCrear con titulo, descripcion, assignee, prioridad, fecha
update_taskCambiar estado, prioridad, asignacion
delete_taskEliminar 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"
HerramientaAccion
list_newsListar noticias (filtro: fijadas)
create_newsPublicar con titulo, contenido, categoria
update_newsEditar contenido o fijar/desfijar
delete_newsEliminar 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"
HerramientaAccion
list_alertsVer alertas activas
create_alertCrear (desactiva las anteriores automaticamente)
update_alertActivar/desactivar, cambiar mensaje
delete_alertEliminar 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"
HerramientaAccion
list_notesListar (filtro: autor)
create_noteCrear con titulo, contenido, color
update_noteEditar contenido o color
delete_noteEliminar 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"
HerramientaAccion
get_servers_statusServidores Hetzner: IP, CPU, RAM, estado
get_uptimeUptimeRobot: uptime %, response time + notas contextuales
get_metricsCreaRack Pro: usuarios, racks, dispositivos, monitores
get_dashboardResumen 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"
HerramientaAccion
github_list_prsPRs abiertos/cerrados con filtros
github_list_issuesIssues con filtros (estado, labels)
github_create_issueCrear issue con titulo, descripcion, labels, assignees
github_repo_activityCommits, 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"
HerramientaAccion
list_guidesLista todas las guias, planes y documentos
read_guideLee el contenido completo de un documento
read_worklogLee 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"
HerramientaAccion
holded_list_invoicesFacturas con filtros (pagadas, pendientes, por cliente, por fecha)
holded_create_invoiceCrear factura con lineas, IVA, cliente, vencimiento
holded_send_invoiceEnviar factura por email al cliente
holded_mark_paidMarcar como pagada (total o parcial)
holded_financial_summaryResumen: 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"
HerramientaAccion
holded_list_contactsListar clientes y proveedores
holded_create_contactCrear con nombre, NIF, email, direccion, tipo
holded_get_contactDetalle 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%"
HerramientaAccion
holded_list_productsProductos y servicios con precios
holded_create_productCrear 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?"
HerramientaAccion
holded_list_paymentsPagos registrados
holded_list_treasuryCuentas 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?"
HerramientaAccion
holded_list_leadsProspectos/leads del embudo de ventas
holded_create_leadNuevo prospecto con empresa, valor, notas
holded_list_expensesCuentas 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

ProblemaSolucion
Claude se queda cargando la herramientaSettings → Connectors → Configurar → activar TODAS las herramientas
”No tengo acceso”Verificar que el connector esta conectado
Herramientas nuevas no aparecenDesconectar y reconectar el connector
Token invalidoPedir 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