Skip to main content

​
Connection issues

Claude Desktop / Claude Code / Cursor:
  1. Confirm the server URL is exactly https://mcp.decky-ai.com/mcp (no trailing slash).
  2. Check the Authorization header is Bearer dk_live_YOUR_KEY (not Token, not API-Key).
  3. Restart Claude Desktop (quit fully, reopen).
  4. In Claude Desktop, click the tools icon to inspect connected tools. If Decky isn’t listed, the config file has a syntax error — validate it at jsonlint.com.
Claude.ai web:
  1. Go to claude.ai/customize/connectors and check the connector is listed as connected.
  2. If it shows an error, remove it and re-add https://mcp.decky-ai.com/mcp.
  3. Make sure you signed in to Decky with the same account as your platform account.
Your API key is invalid, expired, or revoked.
  1. Go to app.decky-ai.com → API Keys.
  2. Check whether the key is listed and not revoked.
  3. If it’s expired or revoked, create a new key and update your config.
  4. Keys are shown only once at creation — if you lost it, create a new one.
Your key was created without the scope needed for the operation.
  1. Go to API Keys on the platform.
  2. The existing key cannot have scopes added — revoke it and create a new one with all needed scopes.
  3. The default “all scopes” option includes everything.

​
Generation issues

Generation time scales with slide count:This is expected. Claude polls automatically — you don’t need to keep the conversation open.
The error field on the job object explains why. Common causes:All credits from a failed job are refunded automatically.
Deck files are stored for 30 days, then deleted. Regenerate:
“Regenerate the deck about [topic] — the old one expired.”

​
Credit issues

You don’t have enough credits in the current period. Options:
  • Ask for fewer slides: “Create a 5-slide deck instead of 10.”
  • Wait until your period resets — check_usage shows the period_end date.
  • Upgrade at app.decky-ai.com → Billing.
You have too many queued/running jobs. Wait for one to finish, or cancel one:
“Cancel my currently running deck job.”

​
Still stuck?

Contact support

Email support@decky-ai.com or visit app.decky-ai.com.
When you reach out, include:
  • The job ID (e.g. job_abc123) if the issue is with a specific deck.
  • The error message you saw.
  • Which client you’re using (Claude.ai web, Claude Desktop, Cursor, etc.).