Troubleshooting
The MCP host does not show workflow
Section titled “The MCP host does not show workflow”Run the MCP help command:
MCP server help · shell command
npx -y @automatalabs/workflows mcp --helpThe result must show the MCP subcommand usage. If it does, inspect the MCP host process log.
Make sure that the configuration uses command: "npx". Make sure that its arguments are -y, @automatalabs/workflows, and mcp.
After each configuration change, restart the MCP host.
The host does not show author-workflow
Section titled “The host does not show author-workflow”The host can support MCP tools without MCP prompts. As an alternative, install the published skill.
Published authoring skill · installer command
npx skills add agentprism/agentprism-workflowsThe missing prompt does not remove the workflow tool.
Validation reports a backend probe warning
Section titled “Validation reports a backend probe warning”Read the backend name and its error message. Authenticate or install that backend.
Run the config probe for only that backend:
Codex backend · catalog probe
npx -y @automatalabs/workflows config codexAfter the probe succeeds, run the validator again.
A model or option is invalid
Section titled “A model or option is invalid”Do not change the value by guesswork. Run the live catalog probe.
Copy the model ID, mode, option name, and allowed value from the live catalog without changes. Then validate the workflow again.
A run pauses for authentication
Section titled “A run pauses for authentication”Read reason and authContext from the outcome. Authenticate the named backend.
Do not put credentials in the MCP request.
Start a new run with resumeFromRunId. Re-send the workflow script and the args for the new run.
A background run becomes interrupted
Section titled “A background run becomes interrupted”The MCP server process ended before the run became terminal. Inspect the run to make sure that its persisted status is interrupted.
Start a new run with resumeFromRunId. An unjournaled in-flight call can run again.
A resume runs all calls live
Section titled “A resume runs all calls live”Read replayEligibility.firstNonReplay and the terminal resumeReport. Compare the prompt, model, schema, input, working directory, and label.
A resume does not always replay a prefix. Each call must pass its reuse checks.
Inspect does not contain the full result
Section titled “Inspect does not contain the full result”Inspect returns a bounded status projection. Use a terminal foreground response or terminal await outcome for the full authored result.