Skip to main content
When something in OpenWork looks wrong, the fastest debugger is usually the agent itself: it can read its own configuration, probe servers, and verify fixes in-band. This page collects paste-able diagnostic prompts. Copy the whole block for your situation into a chat and let the agent work through it. Each prompt is safe by default: it gathers evidence first, redacts secrets, and asks before changing anything.

1. Cloud search shows old or missing capabilities

Symptoms
  • search_capabilities returns fewer tools than you expect (for example, only postCapabilitiesGoogleWorkspaceGmailDrafts when newer Google Workspace capabilities should exist).
  • execute_capability returns unknown_capability for a tool name that should exist.
  • The cloud dashboard says a connection is “Connected as you”, but the agent reports connected: false.
What is usually wrong Your agent’s openwork-cloud MCP entry is a snapshot: it stores a server URL and token from the moment it was connected. If it was created against a local development server or an old deployment — including via a leftover desktop-bootstrap.json file that overrides server URLs beneath the Settings UI — the agent keeps querying that old world forever, while the dashboard shows the current one. Paste this to your agent
Expected passing state
  • The openwork-cloud entry’s url points at your real server and ends in /mcp/agent (either a direct API host or the web app’s /api/den proxy).
  • search_capabilities reflects your server’s current catalog.
  • execute_capability on a known capability returns data or an actionable connection message — never unknown_capability.
If the agent completes all phases and verification still fails, open an issue and paste the agent’s final report (it is already redacted).

2. Cloud MCP is configured, but its tools are missing

Symptoms
  • Settings shows an openwork-cloud MCP entry, but the agent calls openwork_docs_search for requests involving connected services.
  • The agent claims that search_capabilities and execute_capability are only “conceptual capabilities” rather than callable tools.
  • A connected service such as ServiceNow appears ready in OpenWork Cloud, but the task does not expose openwork-cloud_search_capabilities or openwork-cloud_execute_capability.
What this diagnostic checks The prompt below runs OpenWork’s bundled OpenCode executable against its generated runtime config and checks whether a fresh OpenCode process can connect to openwork-cloud. It does not attach to the OpenCode server already running inside OpenWork, so it combines that result with the live status shown in OpenWork and a forced tool call from a new task. Paste this to your agent
Verify inside OpenWork
  1. In the affected workspace, open Settings → Extensions and click Refresh.
  2. Click Show hidden, then find OpenWork Cloud Control under Your apps. This row shows live OpenCode MCP status; the catalog card only proves that the entry is configured.
  3. Expand the row and retain its status and non-secret error: Ready, Issue, Sign in needed, Offline, or Paused.
  4. Return to the task, open the command palette, run Reload OpenCode config, and create a new task in the same workspace.
  5. Repeat the forced Cloud tool call from Phase 1.
How to interpret both results