|Documentation
dataworkers

Client Setup

Open source ยท Apache 2.0. This section documents the open-source core. The Data Workers platform is covered separately - see What the platform adds.

Every agent is a standard MCP stdio server, so the same binary works across clients. Only the location of the config file differs.

ClientConfigKey
Claude Code.mcp.json in project root, or claude mcp addmcpServers
Cursor.cursor/mcp.json, or Settings โ†’ MCP ServersmcpServers
OpenCodeopencode.jsonmcp
Codex CLI~/.codex/config.toml-

Note the OpenCode format differs: it uses an mcp key, and command is an array rather than a command plus args.

These four are the clients we test against. Setup notes for OpenClaw, GitHub Copilot, Microsoft Copilot and Gemini CLI are in docs/setup/ in the repository - they work, we just don't test every release against them. Any client that speaks MCP over stdio will connect using the same pattern.

Claude Code

claude mcp add dw-incidents -- /path/to/dataworkers-claw-community/start-agent.sh dw-incidents

Persists across sessions. claude mcp list shows status; claude mcp remove dw-incidents undoes it. Data Workers runs alongside other MCP servers without conflict.

Or install the plugin: claude plugin marketplace add DataWorkersProject/dataworkers-claw-community

Cursor

Create .cursor/mcp.json:

{ "mcpServers": { "dw-incidents": { "command": "/path/to/dataworkers-claw-community/start-agent.sh", "args": ["dw-incidents"] } } }

Project-scoped. For every project, add it through Cursor Settings instead. Restart Cursor after editing.

OpenCode

The repo ships ready-made configs under configs/.

Codex CLI

Add the server to ~/.codex/config.toml.

Troubleshooting

Tools don't appear. Restart the editor - most clients only read MCP config at startup.

Transport error / connection refused. The server process exited. Run the command by hand in a terminal to see why.

Config key mismatch. Most clients use mcpServers. Using the wrong key fails silently.