Activity

Tech-writer review called this out as the second launch-blocker after security: "Without this page, every issue in your tracker for the next six months will be a duplicate."

Covers the most likely problems a new user will hit, with symptoms, likely causes, and fixes:

• Server connects but no tools appear (cache, package name typo)
• Tools appear but every call returns 401 (token missing / expired / scope)
• Connection error / ECONNREFUSED / timeout (URL wrong, network unreachable)
• Validation failed / 422 on create or update (Coolify's silent allowlist, links to gotchas)
• env_vars list returns *** (not a bug — explainer, links to security model)
• Hetzner returns 401 even with valid token (auth-scope-gated routes)
• Deploy never finishes (v2.x sync behaviour, links to v3 Tasks)
• Custom HTTP header not reaching Coolify
• Fallback: search the tracker first, with the info to include in a new issue

Sidebar updated. Every error case includes a copy-pasteable curl command for verifying the network path independent of the MCP.