Claude Cowork
Connect Claude Cowork to Oxygen and choose the tool scope scheduled tasks can actually dispatch.
Claude Cowork uses Oxygen through a hosted custom connector. Scheduled tasks reuse the connectors available to Cowork, so the connector URL determines which Oxygen tools a task can call.
Choose the connector scope
| URL | Advertised scope | Use when |
|---|---|---|
https://oxygen-agent.com/mcp | Core | The bounded golden-path toolset is enough. A bare URL means core. |
https://oxygen-agent.com/mcp?toolset=core | Core | Same scope, made explicit. |
https://oxygen-agent.com/mcp?toolset=crm | Core + CRM | The task needs CRM record or relationship tools. |
https://oxygen-agent.com/mcp?toolset=full | Every customer tool | The task spans several domains or an existing automation requires the former full scope. |
Core stays the default because the full registry's schemas consume most of a context window before the user says anything, and tool-selection accuracy degrades as the advertised list grows. In core, every other customer tool is still reachable without reconnecting through oxygen_capabilities_read (read-only tools) or oxygen_capabilities_call (anything else), so a pack is optional. Domain packs are additive on core, and several can be combined (?toolset=crm,tables). The MCP tool reference lists every pack and the tools it advertises.
Restore the full scope
- Open Claude Settings → Connectors.
- Remove the existing Oxygen custom connector. Changing or removing
?toolset=coreis not enough: a bare Oxygen URL still selects core. - Add a custom connector with this exact URL:
https://oxygen-agent.com/mcp?toolset=full- Complete the Oxygen OAuth sign-in again.
- In Cowork, ask Oxygen to run the read-only
oxygen_whoamitool and confirm the expected organization. - Re-run the scheduled task. No Oxygen data or schedule definition needs to be recreated.
For a CRM-only task, use https://oxygen-agent.com/mcp?toolset=crm instead. That pack advertises oxygen_crm_record_assert and oxygen_crm_relationship_upsert without loading unrelated domains.
Why capability search alone may not unblock Cowork
oxygen_capabilities_search and oxygen_capabilities_schema can discover every Oxygen tool. Their results include toolset_pack, the smallest connector profile that advertises the selected tool.
The Oxygen server can dispatch an exact hidden tool name, but Cowork rejects a name that was not in its connector's tools/list before the call reaches Oxygen. If Cowork reports No such tool available, run the same tool through oxygen_capabilities_call (or oxygen_capabilities_read for a read-only tool) with { "tool": "<exact name>", "arguments": { ... } }. Both are listed in every scope, so no reconnect is needed. Reconnect with the returned ?toolset=<toolset_pack> only when a task should see those tools listed by name.
Cost and approval posture
Changing the advertised tool scope does not authorize spending or external writes. Paid calls and external mutations still require their normal preview, exact scope, approval, and credit ceiling.