Cómo conectar Registruti a Claude con MCP

Conectá Registruti a Claude (web, escritorio o celular), Claude Code o Cursor con un clic: pegás la URL del servidor MCP, autorizás con tu cuenta y cargás horas o consultás 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?”

La conexión es de un clic: pegás la URL del servidor en tu cliente, te pide autorizar el acceso con tu cuenta de Registruti y listo. No hay que instalar nada ni copiar tokens. Funciona en Claude (web, escritorio y celular), Claude Code, Cursor y cualquier otro cliente MCP que soporte servidores remotos con OAuth. Todo lo que hagas queda scopeado a tu propia cuenta: el asistente solo ve y toca tus datos, y podés cortar el acceso cuando quieras.

Lo que necesitás

Una cuenta de Registruti (si no tenés, creala gratis primero).
Un cliente MCP: la app de Claude (en un plan que incluya conectores personalizados), Claude Code, Cursor u otro.
La URL del servidor, que es siempre la misma: https://registruti.app/api/mcp (también la ves en Ajustes → Conexión con Claude).

Opción 1 · Claude (web, escritorio o celular)

En Claude, abrí Ajustes → Conectores y tocá Agregar conector personalizado.
Nombre: Registruti. URL: https://registruti.app/api/mcp. Los campos de OAuth Client ID y Client Secret se dejan vacíos. Guardá.
Tocá Conectar. Se abre Registruti: si no tenés sesión, entrás con Google y volvés solo a la pantalla de autorización. Ahí ves qué permisos pide Claude (ver tus clientes, horas y reportes; cargar horas). Tocá Autorizar.
Volvés a Claude con el conector activo. En un chat nuevo, abrí el menú de herramientas, asegurate de que Registruti esté habilitado y probá: “¿Qué clientes tengo en Registruti?”.

Como el conector queda ligado a tu cuenta de Claude, lo tenés en la web, en la app de escritorio y en el celular sin repetir nada.

Opción 2 · Claude Code

Un comando en la terminal:

claude mcp add --transport http --scope user registruti https://registruti.app/api/mcp

Después, dentro de una sesión, escribí /mcp, elegí registruti y Authenticate: se abre el browser con la pantalla de autorización de Registruti. El --scope user lo deja disponible en todos tus proyectos.

Opción 3 · Cursor y otros clientes con OAuth

En Cursor, agregá un servidor MCP remoto desde Settings → MCP → Add new MCP server, o pegá esto en tu mcp.json:

{
  "mcpServers": {
    "registruti": {
      "url": "https://registruti.app/api/mcp"
    }
  }
}

Al guardar, el servidor aparece como pendiente de login: hacé clic y autorizá en el browser. La idea es la misma en cualquier cliente que soporte servidores MCP remotos con OAuth: apuntás a https://registruti.app/api/mcp y autorizás.

Opción 4 · Token manual, para clientes sin OAuth

Algunos clientes no saben autorizar solos: por ejemplo el archivo claude_desktop_config.json de Claude Desktop, que solo levanta servidores locales, o un script tuyo. Para esos casos generás un token personal en Ajustes → Conexión con Claude → Tokens personales (se muestra una sola vez; tratalo como una contraseña) y lo mandás en el header Authorization: Bearer <token>.

Para Claude Desktop vía archivo de configuración hace falta Node.js (el puente mcp-remote corre con npx). Abrí el archivo desde Settings → Developer → Edit Config y agregá:

{
  "mcpServers": {
    "registruti": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://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 tu token, dejando el prefijo Bearer . El header va por la variable AUTH_HEADER porque Claude Desktop se come los espacios de los argumentos. Después cerrá Claude Desktop del todo (en Mac es ⌘Q) y volvé a abrirlo. Si tenés la opción de conectores personalizados, preferí la Opción 1: es más simple y los tokens se renuevan solos.

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.

“Hoy”, “esta semana” o “este mes” se interpretan en la zona horaria del país de tu perfil (Ajustes), así que cargar horas a la noche no las manda al día siguiente.

Permisos, seguridad y cómo desconectar

Al autorizar, la app recibe dos permisos: ver tus clientes, horas y reportes, y cargar horas. Nada más: no puede borrar entradas, tocar facturas ni ver otras cuentas.
Los accesos autorizados vencen cada hora y se renuevan solos; no tenés que hacer nada.
Para cortar el acceso, andá a Ajustes → Conexión con Claude → Apps conectadas y tocá Desconectar. También podés quitar el conector desde el propio cliente. Los tokens personales se revocan desde la misma pantalla.

Si algo no funciona

El cliente dice que no pudo conectar. Revisá que la URL sea exactamente https://registruti.app/api/mcp: sin www y sin barra al final. El www redirige al dominio principal y ese salto borra la autorización, así que la conexión falla aunque todo lo demás esté bien.
Se abrió Registruti pero volví al tracker en vez de a la autorización. Pasa si la sesión venció en el medio. Volvé al cliente y tocá Conectar de nuevo: ahora que ya estás logueado, la pantalla de autorización aparece directo.
No aparecen las herramientas en el chat. En Claude, abrí el menú de herramientas del chat y habilitá Registruti. Si conectaste por archivo de configuración, verificá que Node.js esté instalado y reiniciá Claude Desktop.
Dice “no autorizado” (401) con un token manual. Primero la URL (el www de arriba). Si está bien, el token fue revocado: generá uno nuevo en Ajustes y actualizá el archivo.
Me pide autorizar de nuevo. Pasa si desconectaste la app desde Ajustes o si no la usaste en más de dos meses. Autorizá otra vez y listo.

MCP es un estándar abierto, así que esto no depende de Claude: cualquier asistente que lo implemente puede hablar con Registruti. ¿Sugerencias o algo que no funcionó? Escribinos a hola@registruti.app.