Troubleshooting

A guide to common issues and how to resolve them.

Tool Execution Errors

"Tool not found" (404)

• Cause: The tool slug is incorrect, or the tool has been deleted.
• Fix: Check the URL in the dashboard. Ensure you are using the correct Organization ID if invoking via API.

"Unauthorized" (401)

• Cause: The tool is Private and no valid token was provided.
• Fix:
  • Header: Ensure Authorization: Bearer <token> is set.
  • Query Param: Ensure ?token=<token> is appended to the URL.
  • Token Validity: Check if the token has been revoked in the dashboard.

"Input must be an object" (400)

• Cause: The request body was not a valid JSON object or did not match the defined Input Schema.
• Fix:
  • Ensure Content-Type: application/json header is sent.
  • Validate your JSON body against the schema defined in the Tool Editor.

"Output exceeds limit"

• Cause: The tool returned too much data or logged too many lines.
• Fix: Reduce the amount of data returned or logged. The default limit is 256KB for output and 16KB for logs.

MCP Connection Issues

Client says "Connection failed"

• Cause: The MCP Client (Claude, Cursor) cannot reach the Dwizi server.
• Fix:
  • Check internet connectivity.
  • Verify the MCP Server URL is correct.
  • Ensure the env variable DWIZI_TOKEN (or equivalent) is set correctly in the client config.

"Stream unavailable"

• Cause: The connection was closed prematurely or the tool crashed immediately.
• Fix: Check the "Runs" tab in the dashboard for the specific run to see if it failed with a startup error (e.g., syntax error in code).

Runtime Issues

"Module not found" (Node.js)

• Cause: You tried to import or require a package that isn't built-in.
• Fix: Dwizi Node.js runner does not support npm install. You must bundle dependencies or use Deno which supports URL imports.

"Permission denied" (Deno)

• Cause: The script tried to access a system resource (like file system) that is blocked.
• Fix: Dwizi containers are ephemeral. You can write to /tmp, but you cannot persist data between runs. Use an external database or API for storage.

Support

If you are still stuck, please reach out to our support team or check the System Status.