Connect Codex CLI

Add Data Workers to ~/.codex/config.toml.

Local install

[mcp_servers.dataworkers]
command = "npx"
args = ["-y", "dw-claw"]
env_vars = ["DW_LOG_LEVEL"]
startup_timeout_sec = 30
tool_timeout_sec = 90
default_tools_approval_mode = "prompt"

The prompt approval mode means Codex asks before each Data Workers tool runs. Once you trust a read-only tool, you can auto-approve it individually:

[mcp_servers.dataworkers.tools.lineage_read]
approval_mode = "auto"

Hosted (Scale and Enterprise)

[mcp_servers.dataworkers]
url = "https://mcp.dataworkers.io/v1"
bearer_token_env_var = "DW_API_KEY"

Export DW_API_KEY in the shell where you run codex.

Verify

Start codex and list MCP servers — dataworkers should appear with its tool set. Then:

Test the connection to my Snowflake catalog.

See Verify your setup for what the three states mean.