Acceso anticipado

API de DoLoop

Lee y maneja tus tareas y bucles desde tus propios scripts, integraciones y asistentes de IA.

¿Usas Claude, Cursor u otro asistente de IA? Configura MCP ↓

1. Crea una clave

  1. 1Inicia sesión y abre Mi perfil.
  2. 2En Claves de API, ponle un nombre, elige solo lectura o lectura y escritura y, si quieres, una fecha de caducidad.
  3. 3Copia la clave enseguida. Empieza por dl_ y solo se muestra una vez.
Gestionar mis claves de API

2. Haz una solicitud

Envía la clave como token bearer en la cabecera Authorization. Esto lista tus bucles:

curl -H "Authorization: Bearer dl_…" \
  https://api.getdoloop.com/api/v1/loops

Solicitudes y respuestas en JSON, por HTTPS.

Conecta un asistente de IA (MCP)

El servidor MCP de DoLoop permite que Claude, Cursor o cualquier otro cliente MCP lea y gestione tus tareas y bucles por ti. Usa las mismas claves de API y comparte su límite de 60 solicitudes por minuto, y no puede hacer nada que tu clave no permita ya.

URL del servidor:

https://api.getdoloop.com/mcp

Crea una clave como en el paso 1. Con una clave de solo lectura, el asistente tiene 5 herramientas para consultar tus tareas y bucles; con una de lectura y escritura tiene las 16, así que también puede crear, editar, completar, abandonar y eliminar. Crea una clave por asistente para poder revocar cada una por separado.

Claude Code

Ejecuta esto en una terminal, con tu clave en lugar de dl_…:

claude mcp add --transport http doloop https://api.getdoloop.com/mcp \
  --header "Authorization: Bearer dl_…"

Claude Desktop

Los conectores integrados de Claude Desktop necesitan un inicio de sesión que DoLoop aún no ofrece. Mientras tanto, conéctate a través del puente mcp-remote (requiere Node.js): añade esto a claude_desktop_config.json, pon tu clave en lugar de dl_… y reinicia Claude Desktop.

{
  "mcpServers": {
    "doloop": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.getdoloop.com/mcp",
        "--header",
        "Authorization:${DOLOOP_AUTH}"
      ],
      "env": {
        "DOLOOP_AUTH": "Bearer dl_…"
      }
    }
  }
}

Cursor

Añade esto a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un proyecto), con tu clave en lugar de dl_…:

{
  "mcpServers": {
    "doloop": {
      "url": "https://api.getdoloop.com/mcp",
      "headers": {
        "Authorization": "Bearer dl_…"
      }
    }
  }
}
  • Cualquier otro cliente MCP: usa el transporte Streamable HTTP con la URL de arriba y la misma cabecera Authorization.
  • Después, pregúntale a tu asistente, por ejemplo: «¿Qué me toca hoy?» o «Crea un bucle para mis tareas de casa semanales».
  • Tu clave es una contraseña: mantén los archivos de configuración que la contienen fuera de git y de carpetas compartidas.

Lectura o escritura

Solo lectura

Lista y lee tus tareas y bucles. Solo solicitudes GET.

Lectura y escritura

Todo lo que permite una clave de solo lectura, además de crear, editar, completar, abandonar y eliminar tareas y bucles.

A qué llega una clave

Las rutas son relativas a la URL base del ejemplo anterior.

Tareas

  • GET /tasks
  • GET /tasks/armed
  • GET /tasks/{id}
  • POST /tasks
  • PATCH /tasks/{id}
  • DELETE /tasks/{id}
  • POST /tasks/{id}/check
  • POST /tasks/{id}/abort
  • POST /tasks/arm_all

Bucles

  • GET /loops
  • GET /loops/{id}
  • POST /loops
  • PATCH /loops/{id}
  • DELETE /loops/{id}
  • POST /loops/{id}/enqueue
  • DELETE /loops/{id}/dequeue

Una clave no puede tocar tu cuenta, tu contraseña ni tus otras claves: eso sigue detrás de tu inicio de sesión.

Límites y errores

  • 60 solicitudes por minuto y por clave. Por encima, la API responde 429 con una cabecera Retry-After: espera esos segundos y vuelve a intentarlo.
  • Una clave deja de funcionar de inmediato cuando la revocas, cuando caduca, cuando cambias o restableces tu contraseña o cuando eliminas tu cuenta.

Los errores son JSON, con un código estable en el campo error:

  • 401 invalid_api_key — la clave está mal formada o es desconocida
  • 401 api_key_revoked — la clave fue revocada
  • 401 api_key_expired — la clave ha superado su fecha de caducidad
  • 403 insufficient_scope — una clave de solo lectura intentó cambiar algo
  • 403 api_key_not_allowed — se usó una clave en una ruta de cuenta o de claves
  • 429 rate_limited — demasiadas solicitudes: espera lo que indique Retry-After

Cómo guardamos las claves de API y su uso