Troubleshooting
The client returns 401 or asks me to authenticate
Section titled “The client returns 401 or asks me to authenticate”Complete the browser authorization flow. If you previously disconnected the client, this is expected: the old tokens are no longer valid.
A write tool reports insufficient scope
Section titled “A write tool reports insufficient scope”Reconnect and approve presentations:write. Keep presentations:read too when the workflow edits existing decks.
An update returns CONFLICT
Section titled “An update returns CONFLICT”The deck changed after your client read it. Fetch the presentation again, reapply the intended edit to the latest source, and update with the new checksum. Do not repeatedly retry the stale request.
The presentation source is invalid
Section titled “The presentation source is invalid”Ask the client to call get_slidelang_guide, correct the reported syntax, and submit again. Validation happens before SlideWeave publishes the new version.
A presentation is not found
Section titled “A presentation is not found”Confirm the presentation ID and the connected SlideWeave account. The deck may belong to another account or may have been moved to trash.
The browser does not return to my client
Section titled “The browser does not return to my client”Keep the client running while completing authorization and verify that it supports OAuth for remote HTTP MCP servers. If its callback expired, start the connection again instead of reusing the old browser tab.
Still blocked? Contact [email protected] with the client name, approximate time, and error text. Never include tokens.