Quickstart

There are two ways to connect: OAuth (sign in through a browser, no API key) and API key (a token you paste into a config file). Choose the tab that matches your client.

Claude.ai web (OAuth)
Claude Desktop
Claude Code
Cursor

The fastest way to get started. Authentication happens through Decky’s secure sign-in — no API key to copy or store.

Open Claude connectors

Go to claude.ai/customize/connectors and click Add custom connector.

Enter the server URL

https://mcp.decky-ai.com/mcp

Click Save.

Claude redirects you to Decky’s sign-in page. Use the same account as app.decky-ai.com. If you don’t have one, a free account is created automatically.

Generate a deck

Start a conversation and ask:

“Create a 10-slide deck about the future of electric vehicles, written for a general audience.”

Claude calls create_deck, polls until the deck is ready (typically 3–10 minutes), then gives you a download link.

Edit the config file

Open the Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the mcpServers block — no API key needed:

claude_desktop_config.json

{
  "mcpServers": {
    "decky-ai": {
      "url": "https://mcp.decky-ai.com/mcp"
    }
  }
}

Restart Claude Desktop

Quit and reopen Claude Desktop.

Authorize in the browser

On first connection Claude Desktop opens a browser window. Sign in with your Decky account (Google or Microsoft) and click Authorize.

Generate a deck

A tools icon appears in the chat input — Decky is connected. Ask:

“Create a 10-slide investor pitch for a B2B SaaS startup that reduces food waste.”

Get your API key

Create one at app.decky-ai.com → API Keys. Copy it immediately.

Add the server

claude mcp add decky-ai --transport http https://mcp.decky-ai.com/mcp \
  -H "Authorization: Bearer dk_live_YOUR_KEY_HERE"

Verify the connection

claude mcp list

Get your API key

Create one at app.decky-ai.com → API Keys. Copy it immediately.

Configure MCP

Open Settings → MCP, or edit .cursor/mcp.json in your project:

.cursor/mcp.json

{
  "mcpServers": {
    "decky-ai": {
      "url": "https://mcp.decky-ai.com/mcp",
      "headers": {
        "Authorization": "Bearer dk_live_YOUR_KEY_HERE"
      }
    }
  }
}

What to expect

Phase	What happens
Immediately	`create_deck` queues the job and reserves credits
0–30 seconds	Job moves from `queued` to `running`
1–10 minutes	Slides generate one by one (progress shown)
Done	Status becomes `succeeded`, download link available
Download link	Expires after a few minutes — ask for a fresh one
File storage	`.pptx` files are kept for 30 days

Next steps

Brand templates

Apply your company’s colors, fonts, and layouts.

Credits & plans

Understand the credit model and plan tiers.

Tool reference

Everything the assistant can call.

Get Started

Authentication

Guides

Tool Reference

Help

What to expect

Next steps

Brand templates

Credits & plans

Tool reference

​What to expect

​Next steps

Brand templates

Credits & plans

Tool reference

What to expect

Next steps