🚀 Rablo MCP Client

Cliente MCP oficial para conectar Claude Desktop con la API de Rablo.

📦 Instalación

npm install -g rablo-mcp-client

Requisitos:

• Node.js 18.0.0 o superior
• Claude Desktop instalado

⚙️ Configuración

1. Obtener Token JWT

Solicita tu token JWT a través de la plataforma Rablo o contacta a tu administrador.

2. Configurar Claude Desktop

Windows

1. Abre el archivo de configuración:

   %APPDATA%\Claude\claude_desktop_config.json

2. Agrega la configuración del servidor MCP:

{
  "mcpServers": {
    "rablo": {
      "command": "rablo-mcp-client",
      "args": [],
      "env": {
        "RABLO_MCP_TOKEN": "tu_token_jwt_completo_aqui",
        "RABLO_MCP_URL": "https://rablo-mcp-server.onrender.com"
      }
    }
  }
}

macOS / Linux

1. Abre el archivo de configuración:

   ~/Library/Application Support/Claude/claude_desktop_config.json

2. Agrega la misma configuración que arriba.

3. Reiniciar Claude Desktop

1. Cierra Claude Desktop completamente
2. Abre el Administrador de Tareas (Windows) o Activity Monitor (Mac)
3. Termina todos los procesos de "Claude"
4. Vuelve a abrir Claude Desktop
5. Ve a Settings → Developer → MCP Servers
6. Deberías ver "rablo" con un punto verde ✅

✅ Verificación

En Claude Desktop, pregunta:

¿Qué herramientas de Rablo tienes disponibles?

Claude debería listar todas las herramientas MCP disponibles (empresas, empleados, procesos, documentos, etc.).

🔧 Variables de Entorno

| Variable | Descripción | Requerido | Default | |----------|-------------|-----------|---------| | RABLO_MCP_TOKEN | Tu token JWT de autenticación | ✅ Sí | - | | RABLO_MCP_URL | URL del servidor MCP | ❌ No | https://rablo-mcp-server.onrender.com |

🆕 Actualización

Para actualizar a la última versión:

npm update -g rablo-mcp-client

🗑️ Desinstalación

npm uninstall -g rablo-mcp-client

🐛 Solución de Problemas

El MCP aparece con punto rojo 🔴

Causas comunes:

1. Token inválido o expirado

   • Obtén un nuevo token
   • Actualiza RABLO_MCP_TOKEN en claude_desktop_config.json
   • Reinicia Claude Desktop

2. Servidor no disponible

   • Verifica que RABLO_MCP_URL sea correcto
   • Prueba abrir la URL en el navegador: debe responder

3. Claude Desktop no reiniciado correctamente

   • Usa el Administrador de Tareas para terminar TODOS los procesos de Claude
   • Vuelve a abrir Claude Desktop

Ver logs de depuración

Los logs del cliente se muestran en:

• Windows: %APPDATA%\Claude\logs\mcp-server-rablo.log
• macOS: ~/Library/Logs/Claude/mcp-server-rablo.log

Para ver logs en tiempo real (desarrollo):

# Linux/Mac
tail -f ~/Library/Logs/Claude/mcp-server-rablo.log

# Windows PowerShell
Get-Content "$env:APPDATA\Claude\logs\mcp-server-rablo.log" -Wait -Tail 50

Error: "Token JWT requerido"

Asegúrate de que:

• RABLO_MCP_TOKEN esté definido en claude_desktop_config.json
• El token esté entre comillas dobles
• No haya espacios extra

Error de conexión

Si ves errores de conexión:

1. Verifica tu conexión a internet
2. Verifica que RABLO_MCP_URL sea correcto (usa https://, no http://)
3. Prueba hacer ping al servidor

💡 Ejemplos de Uso

Una vez configurado, puedes pedirle a Claude:

"Usa Rablo para listar todas las empresas"

"Obtén los empleados de la empresa ID 5"

"Crea un nuevo grupo llamado 'Ventas' en la empresa 10"

"Genera un reporte de la empresa 7"

🔒 Seguridad

• ⚠️ NO compartas tu archivo claude_desktop_config.json (contiene tu token)
• ⚠️ NO subas tu token a repositorios públicos
• ✅ Regenera tu token si crees que fue comprometido
• ✅ Los tokens tienen fecha de expiración automática

📚 Documentación Adicional

• Documentación de Rablo
• Model Context Protocol (MCP)
• Claude Desktop

🆘 Soporte

Si tienes problemas:

1. Revisa la sección de Solución de Problemas
2. Verifica los logs del cliente
3. Contacta al equipo de soporte de Rablo

📝 Licencia

MIT License - Copyright (c) 2025 Rablo Team

🔗 Enlaces

• Página de NPM
• Repositorio GitHub
• Reporte de Issues

Versión: 1.0.0 Última actualización: Enero 2025