Cómo conectar Registruti a Claude con MCP

Guía paso a paso para agregar Registruti como servidor MCP en Claude Desktop, Claude Code, Cursor u otro cliente MCP, y cargar horas o consultar tus reportes por lenguaje natural.

Registruti tiene un servidor MCP (Model Context Protocol), el estándar que usan Claude y otros asistentes para conectarse a herramientas externas. Conectándolo, podés cargar horas y consultar tus reportes hablándole en lenguaje natural a Claude, sin abrir la app. Por ejemplo:

“Cargá 2 horas de hoy para Acme, reunión de kickoff.”
“¿Cuántas horas facturables llevo este mes?”
“¿Qué clientes tengo cargados?”

MCP es un estándar abierto, así que esto no es exclusivo de Claude Desktop: funciona con cualquier cliente compatible con MCP que permita conectar un servidor remoto con un header de autorización — por ejemplo Claude Code, Cursor u otros. En esta guía usamos Claude Desktop como ejemplo porque es el más común, pero la idea es la misma en todos: apuntás el cliente al endpoint de Registruti con tu token. Lo único que cambia es dónde se pega la configuración (más abajo tenés el ejemplo para otros clientes).

Toma unos 5 minutos. Todo lo que hagas queda scopeado a tu propia cuenta: el token que generás identifica tu usuario y el asistente solo ve y toca tus datos.

Lo que necesitás

Una cuenta de Registruti (si no tenés, creala gratis primero).
Claude Desktop instalado (Mac o Windows).
Node.js instalado en tu compu — el puente de conexión corre con npx. Si no lo tenés, bajalo de nodejs.org (versión LTS).

Paso 1 · Generar tu token

En Registruti, entrá a Ajustes → Conexión MCP y tocá Generar token. Se muestra una sola vez, así que copialo en el momento con el botón de copiar. Tiene esta pinta:

reg_9f3a1c8e04b7…d2

Pensalo como una contraseña: cualquiera que lo tenga puede leer y cargar horas en tu cuenta. Podés revocarlo cuando quieras desde la misma pantalla.

Paso 2 · Configurar Claude Desktop

Claude Desktop lee los servidores MCP de un archivo llamado claude_desktop_config.json. La forma más segura de abrirlo es desde la app: Settings → Developer → Edit Config.

Si preferís ir al archivo a mano, está en:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

Ojo: en esa carpeta también hay un config.json (sin el prefijo claude_desktop_). Ese es el de preferencias de la app — no es donde va el MCP. Asegurate de editar claude_desktop_config.json.

Pegá esta configuración (si el archivo ya tiene otros servidores, agregá solo la entrada "registruti" dentro de tu "mcpServers"existente):

{
  "mcpServers": {
    "registruti": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.registruti.app/api/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer reg_tu_token_aca"
      }
    }
  }
}

Reemplazá reg_tu_token_aca por el token que copiaste en el Paso 1 — dejando el prefijo Bearer adelante.

¿Por qué el token va en “env” y no en el header directo?

Hay un detalle conocido de Claude Desktop: come los espacios dentro de los argumentos. Como el header necesita el espacio de "Bearer ", lo pasamos por la variable AUTH_HEADER (que sí admite espacios) y el argumento apunta a Authorization:${AUTH_HEADER}. Así evitás un error silencioso de autenticación.

Paso 3 · Reiniciar

Guardá el archivo y cerrá Claude Desktop del todo (en Mac es ⌘Q, no alcanza con cerrar la ventana). Volvé a abrirlo: la primera vez, npx baja el puente mcp-remote y puede tardar unos segundos.

Paso 4 · Probar

Buscá el ícono de herramientas 🔌 en Claude Desktop; deberías ver las 4 tools de Registruti. Probá con:

“¿Qué clientes tengo en Registruti?”
“Cargá 1 hora de hoy para [tu cliente], reunión de prueba.”
“¿Cómo vengo este mes? Mostrame las horas facturables por cliente.”

Qué le podés pedir

El servidor expone 4 herramientas:

Herramienta	Qué hace
`list_clients`	Lista tus clientes con tarifa, moneda y color.
`log_time`	Registra una entrada de tiempo (cliente, fecha, duración libre como “1:30” o “90m”, descripción, facturable).
`list_time_entries`	Consulta tus entradas por rango de fechas y cliente.
`report_summary`	Resumen de horas y montos facturables por cliente y período.

Si algo no funciona

No aparecen las herramientas. Casi siempre es Node.js: verificá que esté instalado. La primera conexión también puede tardar mientras baja mcp-remote — esperá unos segundos y reiniciá otra vez.
Error de conexión. Revisá que la URL sea exactamente https://www.registruti.app/api/mcp (con www) y que el token esté completo, con el Bearer adelante.
Dice “no autorizado” (401). El token no es válido o fue revocado. Generá uno nuevo en Ajustes → Conexión MCP y actualizá el archivo.

En otros clientes MCP

La configuración de arriba es puntual de Claude Desktop, pero el servidor de Registruti es un MCP remoto estándar, así que lo podés usar desde cualquier cliente compatible. Lo único que cambia es cómo se declara. Por ejemplo, en Claude Code (la CLI) es un solo comando:

claude mcp add --transport http registruti \
  https://www.registruti.app/api/mcp \
  --header "Authorization: Bearer reg_tu_token_aca"

En otros clientes como Cursor, agregás un servidor MCP remoto de tipo HTTP apuntando al mismo endpoint (https://www.registruti.app/api/mcp) y con el header Authorization: Bearer <tu-token>. Si tu cliente solo soporta servidores locales, podés usar el puente mcp-remote igual que en el ejemplo de Claude Desktop.

Esto es la primera versión de la integración: funciona con Claude Desktop, Claude Code, Cursor y cualquier otro cliente MCP que acepte un token. Estamos trabajando en el login con OAuth para sumar también Claude web y mobile. ¿Sugerencias o algo que no funcionó? Escribinos.