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 monthly credits reset. On a monthly plan, check_usage shows the reset date as period_end.
  • Upgrade to a higher plan — see decky-ai.com/pricing.
Each account can have up to 5 queued or running jobs at once. 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. 3f6c2a1e-8b4d-4c7a-9e21-5d0f7b9a1c34) 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.).