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.
| Client | Config | Key |
|---|---|---|
| Claude Code | .mcp.json in project root, or claude mcp add | mcpServers |
| Cursor | .cursor/mcp.json, or Settings โ MCP Servers | mcpServers |
| OpenCode | opencode.json | mcp |
| 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-incidentsPersists 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.