Accesso anticipato

API di DoLoop

Leggi e gestisci le tue attività e i tuoi cicli dai tuoi script, dalle tue integrazioni e dai tuoi assistenti IA.

Usi Claude, Cursor o un altro assistente IA? Configura MCP ↓

1. Crea una chiave

  1. 1Accedi e apri Il mio profilo.
  2. 2In Chiavi API, dai un nome alla chiave, scegli sola lettura o lettura e scrittura e, se vuoi, una scadenza.
  3. 3Copia subito la chiave. Inizia con dl_ e viene mostrata una sola volta.
Gestisci le mie chiavi API

2. Invia una richiesta

Invia la chiave come token bearer nell'header Authorization. Questo elenca i tuoi cicli:

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

Richieste e risposte in JSON, via HTTPS.

Collega un assistente IA (MCP)

Il server MCP di DoLoop permette a Claude, Cursor o a qualsiasi altro client MCP di leggere e gestire le tue attività e i tuoi cicli al posto tuo. Usa le stesse chiavi API e ne condivide il limite di 60 richieste al minuto, e non può fare nulla che la tua chiave non permetta già.

URL del server:

https://api.getdoloop.com/mcp

Crea una chiave come al passo 1. Con una chiave di sola lettura l'assistente ha 5 strumenti per consultare le tue attività e i tuoi cicli; con una di lettura e scrittura li ha tutti e 16, quindi può anche creare, modificare, completare, abbandonare ed eliminare. Crea una chiave per ogni assistente, così puoi revocarle una per una.

Claude Code

Esegui questo comando in un terminale, sostituendo dl_… con la tua chiave:

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

Claude Desktop

I connettori integrati di Claude Desktop richiedono una procedura di accesso che DoLoop non offre ancora. Nel frattempo collegati tramite il bridge mcp-remote (serve Node.js): aggiungi questo a claude_desktop_config.json, sostituisci dl_… con la tua chiave e riavvia 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

Aggiungi questo a ~/.cursor/mcp.json (tutti i progetti) o a .cursor/mcp.json (un solo progetto), sostituendo dl_… con la tua chiave:

{
  "mcpServers": {
    "doloop": {
      "url": "https://api.getdoloop.com/mcp",
      "headers": {
        "Authorization": "Bearer dl_…"
      }
    }
  }
}
  • Qualsiasi altro client MCP: usa il trasporto Streamable HTTP con l'URL qui sopra e lo stesso header Authorization.
  • Poi chiedi al tuo assistente, per esempio: «Cosa devo fare oggi?» oppure «Crea un ciclo per le faccende settimanali».
  • La tua chiave è una password: tieni i file di configurazione che la contengono fuori da git e dalle cartelle condivise.

Lettura o scrittura

Sola lettura

Elenca e legge le tue attività e i tuoi cicli. Solo richieste GET.

Lettura e scrittura

Tutto ciò che può fare una chiave di sola lettura, più creare, modificare, completare, abbandonare ed eliminare attività e cicli.

Cosa raggiunge una chiave

I percorsi sono relativi all'URL di base dell'esempio qui sopra.

Attività

  • 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

Cicli

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

Una chiave non può toccare il tuo account, la tua password né le tue altre chiavi: restano dietro il tuo accesso.

Limiti ed errori

  • 60 richieste al minuto per chiave. Oltre, l'API risponde 429 con un header Retry-After: attendi quei secondi, poi riprova.
  • Una chiave smette subito di funzionare quando la revochi, quando scade, quando cambi o reimposti la password o quando elimini il tuo account.

Gli errori sono in JSON, con un codice stabile nel campo error:

  • 401 invalid_api_key — la chiave non è valida o è sconosciuta
  • 401 api_key_revoked — la chiave è stata revocata
  • 401 api_key_expired — la chiave ha superato la scadenza
  • 403 insufficient_scope — una chiave di sola lettura ha tentato di modificare qualcosa
  • 403 api_key_not_allowed — una chiave è stata usata su un percorso di account o di chiavi
  • 429 rate_limited — troppe richieste: attendi il tempo di Retry-After

Come conserviamo le chiavi API e il loro utilizzo