# A shared task list for Windsurf (Devin Desktop)

> Watch Windsurf, now Devin Desktop, work through a task list you share on a live board. Where mcp_config.json lives and how it signs in with no key.

Source: https://taskhold.com/for/windsurf
Last updated: 2026-11-11

Cognition renamed Windsurf to Devin Desktop in June 2026. The MCP setup works the same way: a JSON file listing servers, and remote servers with headers are supported.

Taskhold gives its agent a task list you share. You queue tasks in the web app, the agent works through them over MCP, and the live board shows its steps, progress and questions, with notes, blocks and summaries on each task. The [MCP config generator](https://taskhold.com/tools/mcp-config) writes the JSON for you, and the [quickstart](https://taskhold.com/docs/quickstart) walks through the first run.

## Setup

Open the file with Open MCP config file in Cascade's MCP menu. Current docs put it at ~/.config/devin/mcp_config.json on macOS and Linux (%APPDATA%\devin\mcp_config.json on Windows). The editor's MCP discovery reads a separate file, ~/.codeium/windsurf/mcp_config.json. Add the server with no key:

```json
{
  "mcpServers": {
    "taskhold": {
      "serverUrl": "https://taskhold.com/api/mcp"
    }
  }
}
```

The docs accept serverUrl or url for remote servers. Devin Desktop registers itself with Taskhold and keeps the token, so nothing secret goes in the file. Docs: docs.devin.ai/desktop/cascade/mcp

Turn the server on from the MCPs section of the agent panel's menu (Cascade's docs say to press refresh there after adding a server). When taskhold shows Needs authentication, click Authenticate and finish in your browser; in Devin CLI the same step is devin mcp login taskhold. It connects with no sign-up, and the first time the agent uses Taskhold it gives you a link to start the 7-day trial (or to use your existing account).

With an API key instead, for a machine with no browser: make a setup URL in Taskhold Settings, paste it into Cascade and say "set this up" (it carries a new key and expires after 3 days), or add the header yourself:

```json
"headers": { "Authorization": "Bearer <your atd_sk_ key>" }
```

Inside the taskhold entry, next to serverUrl.

Write the host as taskhold.com, never www.taskhold.com: the www address redirects, and the redirect drops the header.

## Rules for Cascade

Cascade reads an AGENTS.md at the workspace root as an always-on rule, and one in a subfolder as guidance for work in that folder. Workspace rules in .windsurf/rules work too, and global_rules.md applies to every workspace; each rules file is capped at 12,000 characters. Add this to the root AGENTS.md:

```markdown
# Taskhold

This workspace's tasks live in the taskhold MCP server, and the person watches them on a live board.
Use project: "<repo folder name>" in all taskhold calls.
When a conversation starts, read taskhold_get_current and taskhold_updates (save the cursor).
Begin each request with taskhold_begin, giving title, project, steps and agent: "Windsurf in <repo>". Pick up queued work through taskhold_list (status todo) and taskhold_begin with task_id.
Mark steps done with taskhold_complete (start_next: true). Send taskhold_progress on long ones, every few minutes at most.
Blocked: taskhold_block with a single question, then taskhold_updates with task_id, since and wait: 50.
Done: taskhold_complete with a summary of changes and checks. Deferred bugs and TODOs: taskhold_create or taskhold_create_from_todo.
```

## Watch the agent's progress outside the editor

Cascade's panel shows the conversation in front of you. The [live board](https://taskhold.com/demo/live), open in any browser, shows the plan Cascade made, the step it is on and any question it left you. [How to monitor a coding agent's progress](https://taskhold.com/guides/monitor-coding-agent-progress) goes through the board, and the [MCP tools reference](https://taskhold.com/docs/mcp-tools) explains each call the rule asks for.

## How do I keep the key out of mcp_config.json?

Cascade interpolates environment variables in command, args, env, serverUrl, url and headers, written as ${env:NAME}. Keep the key in an environment variable instead of the config:

```json
{
  "mcpServers": {
    "taskhold": {
      "serverUrl": "https://taskhold.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:TASKHOLD_API_KEY}" }
    }
  }
}
```

Set TASKHOLD_API_KEY in the environment Devin Desktop starts from. If the header arrives without a working key, Taskhold answers 401 and names the reason. Docs: docs.devin.ai/windsurf/plugins/cascade/mcp (Config Interpolation)

To hide Taskhold tools you don't use, list them in disabledTools inside the taskhold entry. Keep the ones live progress runs on: taskhold_list, taskhold_get_current, taskhold_begin, taskhold_start, taskhold_plan, taskhold_progress, taskhold_block, taskhold_updates and taskhold_complete.

```json
"disabledTools": ["taskhold_list_labels", "taskhold_set_priority", "taskhold_search"]
```

Inside the taskhold entry.

On a Teams or Enterprise plan, an admin can turn MCP off or allow only approved servers. If Taskhold doesn't appear in the MCPs list, ask them to add https://taskhold.com/api/mcp.

## Disconnecting Cascade

Cascade sends Taskhold only task text, steps, progress and notes. Turn the server off in the MCPs list to pause it, or delete the taskhold entry to remove it. Revoking its key in Taskhold Settings > API keys ends access at once with 401.

For a server that stays red or never lists its tools, see [Windsurf MCP server not connecting](https://taskhold.com/guides/windsurf-mcp-server-not-connecting).

## FAQ

### Is this the same as Windsurf?

Yes. Cognition renamed Windsurf to Devin Desktop on June 2, 2026. Setup is the same remote MCP server either way.

### Is my code sent to Taskhold?

No. Only the task text, notes, and any file path and line number the agent attaches.

### What does it cost?

Taskhold is $12 a month or $120 a year for each person, with a 7-day trial that needs a card.

## Sources

- [Devin docs: Windsurf Cascade MCP configuration (mcp_config.json, interpolation, admin allowlist)](https://docs.devin.ai/windsurf/plugins/cascade/mcp), checked 2026-11-11
- [Devin docs: Devin Desktop MCP (Streamable HTTP and SSE with OAuth, Authenticate)](https://docs.devin.ai/desktop/cascade/mcp), checked 2026-11-11
- [Devin CLI docs: MCP authentication (dynamic client registration, devin mcp login)](https://docs.devin.ai/cli/extensibility/mcp/configuration), checked 2026-11-11
- [Devin docs: Cascade AGENTS.md](https://docs.devin.ai/desktop/cascade/agents-md), checked 2026-11-11
- [Devin docs: Cascade memories and rules (global_rules.md, .windsurf/rules, 12,000 characters)](https://docs.devin.ai/windsurf/plugins/cascade/memories), checked 2026-11-11

## Related

- [Cursor task list over MCP: watch every task live](https://taskhold.com/for/cursor.md)
- [How to see what Claude Code is doing, live](https://taskhold.com/guides/monitor-coding-agent-progress.md)
- [VS Code Copilot task list over MCP: watch it live](https://taskhold.com/for/vs-code.md)
- [How to hand tasks to your coding agent](https://taskhold.com/guides/hand-tasks-to-your-coding-agent.md)
- [Windsurf MCP server not connecting: the fix](https://taskhold.com/guides/windsurf-mcp-server-not-connecting.md)
- [Task managers for AI coding agents, compared](https://taskhold.com/vs/ai-coding-agent-task-managers.md)
- [Windsurf Cascade hook: each reply on the board](https://taskhold.com/integrations/windsurf-hooks.md)

## About Taskhold

Taskhold is a hosted task list shared by a person and their AI coding agents over MCP. Agents break tasks into steps and report progress, and the person watches a live board. $12/month or $120/year per person, 7-day trial with a card, no free plan. Made by Great Work LLC.

To try it, add the MCP server https://taskhold.com/api/mcp to your agent. It connects with no sign-up, and the first time the agent uses Taskhold it gives you a link to start the trial.

- Pricing: https://taskhold.com/pricing.md
- Agent index: https://taskhold.com/llms.txt
