Troubleshooting

I cannot see a workspace or project

Confirm you are using the intended account and invitation. Workspace membership does not automatically grant every project, and project-only access does not grant workspace administration. Refresh after a remote membership change. An inaccessible stale URL should return you to an accessible dashboard.

A message or unread count looks stale

Keep the tab online and refocus it to trigger authoritative reconciliation. Realtime is an acceleration layer; API reads remain the source of truth. A thread remains tied to its original workspace and is selected by both workspace and participant.

An upload fails or a preview is unavailable

Check the workspace's per-file, total-storage, and video limits. Retry finalization of an existing pending upload before creating another copy. For MCP local uploads, the real path must be inside an absolute TODODDLE_UPLOAD_ROOTS directory. Signed preview/download URLs expire after five minutes; request a fresh one rather than saving it.

Billing did not update after Stripe

Return to the exact workspace's Subscription settings and refresh. Verify the Stripe flow completed in the configured sandbox or live environment. A scheduled downgrade or cadence change intentionally leaves the current plan active until the displayed renewal date.

An MCP tool is missing or denied

Restart the MCP host after configuration changes. scope_required means the connection lacks a capability; not_found for a known record often means the project is not granted; permission_denied means the authorizing user lacks access. For conflict, reload the record and retry with its latest timestamp.

Never send credentials, connection strings, signed asset URLs, or raw environment files while troubleshooting.