OXYGENOxygen/ Docs
Surfaces

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

URLAdvertised scopeUse when
https://oxygen-agent.com/mcpCoreThe bounded golden-path toolset is enough. A bare URL means core.
https://oxygen-agent.com/mcp?toolset=coreCoreSame scope, made explicit.
https://oxygen-agent.com/mcp?toolset=crmCore + CRMThe task needs CRM record or relationship tools.
https://oxygen-agent.com/mcp?toolset=fullEvery customer toolThe 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. 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

  1. Open Claude Settings → Connectors.
  2. Remove the existing Oxygen custom connector. Changing or removing ?toolset=core is not enough: a bare Oxygen URL still selects core.
  3. Add a custom connector with this exact URL:
https://oxygen-agent.com/mcp?toolset=full
  1. Complete the Oxygen OAuth sign-in again.
  2. In Cowork, ask Oxygen to run the read-only oxygen_whoami tool and confirm the expected organization.
  3. 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, reconnect with the returned ?toolset=<toolset_pack>, or with explicit ?toolset=full for a genuinely cross-domain automation.

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.

On this page