Accès anticipé

API DoLoop

Lisez et pilotez vos tâches et vos boucles depuis vos propres scripts, intégrations et assistants IA.

Vous utilisez Claude, Cursor ou un autre assistant IA ? Configurez MCP ↓

1. Créez une clé

  1. 1Connectez-vous et ouvrez Mon profil.
  2. 2Sous Clés d'API, nommez votre clé, choisissez lecture seule ou lecture et écriture, et une date d'expiration si vous le souhaitez.
  3. 3Copiez la clé tout de suite. Elle commence par dl_ et n'est affichée qu'une seule fois.
Gérer mes clés d'API

2. Envoyez une requête

Envoyez la clé comme jeton bearer dans l'en-tête Authorization. Cette commande liste vos boucles :

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

Requêtes et réponses en JSON, via HTTPS.

Connecter un assistant IA (MCP)

Le serveur MCP de DoLoop permet à Claude, Cursor ou tout autre client MCP de lire et de gérer vos tâches et vos boucles à votre place. Il utilise les mêmes clés d'API et partage leur limite de 60 requêtes par minute, et il ne peut rien faire que votre clé ne permette déjà.

URL du serveur :

https://api.getdoloop.com/mcp

Créez une clé comme à l'étape 1. Avec une clé en lecture seule, l'assistant dispose de 5 outils pour consulter vos tâches et vos boucles ; avec une clé en lecture et écriture, il dispose des 16, et peut donc aussi créer, modifier, valider, abandonner et supprimer. Créez une clé par assistant pour pouvoir les révoquer séparément.

Claude Code

Lancez cette commande dans un terminal, en remplaçant dl_… par votre clé :

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

Claude Desktop

Les connecteurs intégrés de Claude Desktop exigent une procédure de connexion que DoLoop ne propose pas encore. En attendant, passez par le pont mcp-remote (Node.js requis) : ajoutez ceci à claude_desktop_config.json, remplacez dl_… par votre clé, puis redémarrez 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

Ajoutez ceci à ~/.cursor/mcp.json (tous les projets) ou à .cursor/mcp.json (un seul projet), en remplaçant dl_… par votre clé :

{
  "mcpServers": {
    "doloop": {
      "url": "https://api.getdoloop.com/mcp",
      "headers": {
        "Authorization": "Bearer dl_…"
      }
    }
  }
}
  • Tout autre client MCP : utilisez le transport Streamable HTTP avec l'URL ci-dessus et le même en-tête Authorization.
  • Ensuite, demandez par exemple à votre assistant : « Qu'est-ce qui est prévu aujourd'hui ? » ou « Crée une boucle pour mes tâches ménagères de la semaine. »
  • Votre clé est un mot de passe : gardez les fichiers de configuration qui la contiennent hors de git et des dossiers partagés.

Lecture ou écriture

Lecture seule

Liste et lit vos tâches et vos boucles. Requêtes GET uniquement.

Lecture et écriture

Tout ce que permet une clé en lecture seule, plus la création, la modification, la validation, l'abandon et la suppression de tâches et de boucles.

Ce qu'une clé peut atteindre

Les chemins sont relatifs à l'URL de base de l'exemple ci-dessus.

Tâches

  • 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

Boucles

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

Une clé ne peut toucher ni à votre compte, ni à votre mot de passe, ni à vos autres clés : tout cela reste derrière votre connexion.

Limites et erreurs

  • 60 requêtes par minute et par clé. Au-delà, l'API répond 429 avec un en-tête Retry-After : attendez ce nombre de secondes, puis réessayez.
  • Une clé cesse de fonctionner immédiatement quand vous la révoquez, quand elle expire, quand vous changez ou réinitialisez votre mot de passe, ou quand vous supprimez votre compte.

Les erreurs sont en JSON, avec un code stable dans le champ error :

  • 401 invalid_api_key — la clé est mal formée ou inconnue
  • 401 api_key_revoked — la clé a été révoquée
  • 401 api_key_expired — la clé a dépassé sa date d'expiration
  • 403 insufficient_scope — une clé en lecture seule a tenté de modifier quelque chose
  • 403 api_key_not_allowed — une clé a été utilisée sur une route de compte ou de clés
  • 429 rate_limited — trop de requêtes : attendez la durée Retry-After

Comment nous conservons les clés d'API et leur utilisation