Connect an agent over MCP

These create a space and report into it. Already have one? Open it and come back through the Connect menu, and its UUID is filled in for you.

Claude Code

Added for this project and for you alone, so the uuid stays out of the repository.

VS Code

It goes into your user profile.

Cursor

Add it to .cursor/mcp.json in your home directory.

{
  "mcpServers": {
    "progress-watch": {
      "url": "https://progress.watch/mcp/$SPACE_UUID"
    }
  }
}

Codex

Add it to .codex/config.toml in your home directory.

[mcp_servers.progress-watch]
url = "https://progress.watch/mcp/$SPACE_UUID"

Gemini CLI

-s user keeps it out of the project's .gemini/settings.json.

The uuid is a credential: whoever has it can read and write here. Keep it in these per-user places, not in a project file that gets committed. Outside Claude Code that means one space for every project in that client.

To keep the uuid out of the path, send it as a header.

Four tools: create_space, create_task, update_task, complete_task. Connected with a space, the agent is told to report its own work there without being asked: anything that edits files or runs commands. Claude Code passes that on to the model; with a client that does not, ask the agent once. One connected without a space can call create_space and hand you back the URL, so it is never stuck with nowhere to report.