Early Access

DoLoop-API

Lesen und steuern Sie Ihre Aufgaben und Schleifen aus Ihren eigenen Skripten, Integrationen und KI-Assistenten.

Sie nutzen Claude, Cursor oder einen anderen KI-Assistenten? MCP einrichten ↓

1. Schlüssel erstellen

  1. 1Melden Sie sich an und öffnen Sie Mein Profil.
  2. 2Geben Sie unter API-Schlüssel einen Namen ein, wählen Sie Nur lesen oder Lesen und schreiben und bei Bedarf ein Ablaufdatum.
  3. 3Kopieren Sie den Schlüssel sofort. Er beginnt mit dl_ und wird nur ein einziges Mal angezeigt.
Meine API-Schlüssel verwalten

2. Anfrage senden

Senden Sie den Schlüssel als Bearer-Token im Authorization-Header. Dieser Aufruf listet Ihre Schleifen auf:

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

Anfragen und Antworten sind JSON, über HTTPS.

KI-Assistenten verbinden (MCP)

Mit dem MCP-Server von DoLoop können Claude, Cursor oder jeder andere MCP-Client Ihre Aufgaben und Schleifen für Sie lesen und verwalten. Er nutzt dieselben API-Schlüssel und teilt deren Limit von 60 Anfragen pro Minute; er kann nichts, was Ihr Schlüssel nicht ohnehin darf.

Server-URL:

https://api.getdoloop.com/mcp

Erstellen Sie einen Schlüssel wie in Schritt 1. Mit einem Nur-Lesen-Schlüssel erhält der Assistent 5 Werkzeuge, um Ihre Aufgaben und Schleifen anzusehen; mit einem Schlüssel für Lesen und Schreiben erhält er alle 16 und kann dann auch anlegen, bearbeiten, erledigen, abbrechen und löschen. Erstellen Sie pro Assistent einen eigenen Schlüssel, damit Sie jeden einzeln widerrufen können.

Claude Code

Führen Sie diesen Befehl in einem Terminal aus und ersetzen Sie dl_… durch Ihren Schlüssel:

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

Claude Desktop

Die integrierten Konnektoren von Claude Desktop erfordern ein Anmeldeverfahren, das DoLoop noch nicht anbietet. Bis dahin verbinden Sie sich über die Brücke mcp-remote (Node.js erforderlich): Fügen Sie dies in claude_desktop_config.json ein, ersetzen Sie dl_… durch Ihren Schlüssel und starten Sie Claude Desktop neu.

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

Cursor

Fügen Sie dies in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt) ein und ersetzen Sie dl_… durch Ihren Schlüssel:

{
  "mcpServers": {
    "doloop": {
      "url": "https://api.getdoloop.com/mcp",
      "headers": {
        "Authorization": "Bearer dl_…"
      }
    }
  }
}
  • Jeder andere MCP-Client: Verwenden Sie den Transport Streamable HTTP mit der obigen URL und demselben Authorization-Header.
  • Fragen Sie Ihren Assistenten dann zum Beispiel: „Was steht heute an?“ oder „Leg eine Schleife für meine wöchentliche Hausarbeit an.“
  • Ihr Schlüssel ist ein Passwort: Halten Sie Konfigurationsdateien, die ihn enthalten, aus git und geteilten Ordnern heraus.

Lesen oder schreiben

Nur lesen

Listet und liest Ihre Aufgaben und Schleifen. Nur GET-Anfragen.

Lesen und schreiben

Alles, was ein Nur-Lesen-Schlüssel kann, dazu Aufgaben und Schleifen anlegen, bearbeiten, erledigen, abbrechen und löschen.

Was ein Schlüssel erreicht

Die Pfade sind relativ zur Basis-URL aus dem Beispiel oben.

Aufgaben

  • 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

Schleifen

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

Ein Schlüssel kann weder Ihr Konto noch Ihr Passwort noch Ihre anderen Schlüssel antasten: Das bleibt hinter Ihrer Anmeldung.

Limits und Fehler

  • 60 Anfragen pro Minute und Schlüssel. Darüber antwortet die API mit 429 und einem Retry-After-Header: Warten Sie so viele Sekunden und versuchen Sie es dann erneut.
  • Ein Schlüssel funktioniert sofort nicht mehr, wenn Sie ihn widerrufen, wenn er abläuft, wenn Sie Ihr Passwort ändern oder zurücksetzen oder wenn Sie Ihr Konto löschen.

Fehler sind JSON, mit einem stabilen Code im Feld error:

  • 401 invalid_api_key — der Schlüssel ist fehlerhaft oder unbekannt
  • 401 api_key_revoked — der Schlüssel wurde widerrufen
  • 401 api_key_expired — der Schlüssel ist abgelaufen
  • 403 insufficient_scope — ein Nur-Lesen-Schlüssel wollte etwas ändern
  • 403 api_key_not_allowed — ein Schlüssel wurde auf einer Konto- oder Schlüssel-Route verwendet
  • 429 rate_limited — zu viele Anfragen: Retry-After abwarten

Wie wir API-Schlüssel und ihre Nutzung speichern