早期体验

DoLoop API

通过您自己的脚本、集成和 AI 助手读取和操作您的任务和循环。

在用 Claude、Cursor 或其他 AI 助手？设置 MCP ↓

1. 创建密钥

  1. 1登录并打开“我的资料”。
  2. 2在“API 密钥”下为密钥命名，选择只读或读写，如有需要再设置到期时间。
  3. 3请立即复制密钥。它以 dl_ 开头，且只显示一次。
管理我的 API 密钥

2. 发送请求

在 Authorization 请求头中以 Bearer 令牌的形式发送密钥。以下命令会列出您的循环：

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

请求和响应均为 JSON，通过 HTTPS 传输。

连接 AI 助手（MCP）

借助 DoLoop 的 MCP 服务器，Claude、Cursor 或任何其他 MCP 客户端都可以替您读取和管理任务和循环。它使用相同的 API 密钥，共用每分钟 60 次请求的限额，也无法做任何您的密钥本身不允许的事。

服务器地址：

https://api.getdoloop.com/mcp

按第 1 步创建密钥。使用只读密钥时，助手有 5 个工具可以查看您的任务和循环；使用读写密钥时可以使用全部 16 个工具，也就能创建、编辑、完成、放弃和删除。建议为每个助手单独创建一个密钥，以便分别撤销。

Claude Code

在终端中运行以下命令，并将 dl_… 替换为您的密钥：

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

Claude Desktop

Claude Desktop 的内置连接器需要一种 DoLoop 尚未提供的登录流程。在此之前，请通过 mcp-remote 桥接连接（需要 Node.js）：将以下内容添加到 claude_desktop_config.json，把 dl_… 替换为您的密钥，然后重启 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

将以下内容添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目），并将 dl_… 替换为您的密钥：

{
  "mcpServers": {
    "doloop": {
      "url": "https://api.getdoloop.com/mcp",
      "headers": {
        "Authorization": "Bearer dl_…"
      }
    }
  }
}
  • 其他任何 MCP 客户端：使用 Streamable HTTP 传输方式，以及上面的地址和相同的 Authorization 请求头。
  • 然后可以这样问您的助手：“今天有什么要做？”或“为我的每周家务建一个循环。”
  • 密钥就是密码：请勿将包含密钥的配置文件提交到 git 或放在共享文件夹中。

只读或读写

只读

列出和读取您的任务和循环。仅限 GET 请求。

读写

只读密钥能做的一切，外加创建、编辑、完成、放弃和删除任务和循环。

密钥可以访问的内容

路径相对于上面示例中的基础 URL。

任务

  • 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

循环

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

密钥无法访问您的账户、密码或其他密钥：这些仍需您登录后才能操作。

限制和错误

  • 每个密钥每分钟 60 次请求。超出后 API 返回 429 并附带 Retry-After 响应头：请等待相应秒数后再重试。
  • 在您撤销密钥、密钥到期、您修改或重置密码，或删除账户时，密钥会立即失效。

错误以 JSON 返回，error 字段中带有稳定的错误码：

  • 401 invalid_api_key — 密钥格式错误或不存在
  • 401 api_key_revoked — 密钥已被撤销
  • 401 api_key_expired — 密钥已过期
  • 403 insufficient_scope — 只读密钥尝试进行修改
  • 403 api_key_not_allowed — 在账户或密钥相关路径上使用了密钥
  • 429 rate_limited — 请求过多：请按 Retry-After 等待

我们如何存储 API 密钥及其使用情况