Troubleshooting

Symptom	Likely cause	Resolution
isError: true with "User validation"	Token not assigned to the target workspace	Verify that the API key or the User are assigned and active in the Shared space and workspace.
Auth returns 401	Invalid or expired token	Regenerate the API Access Key token.
Client does not show the MCP tools	Client config not saved / not restarted	Save config file and fully restart the client.
OAuth: token refresh fails after 30 days	Refresh token expired	User must re-authenticate via browser (re-run OAuth flow).