Connect Claude to Encelade via MCP

Encelade exposes an MCP (Model Context Protocol) server that lets Claude work with your presentation projects directly — list them, edit them, plan outlines, and generate full decks through natural conversation. Connecting takes one click: Claude handles authentication for you over OAuth, so there is no API token to create or paste.

Prerequisites

An Encelade account (free to create at encelade.ai)
Claude Desktop, Claude Code, or another MCP-capable client

Step 1: Add the connector in Claude

Option A: Claude Desktop

Open Claude Desktop and go to Settings.
Find Connectors (or Integrations) and click Add custom connector.
Enter the connector details:
- Name: Encelade
- Remote MCP server URL: https://www.encelade.ai/api/mcp
Leave the Advanced settings (OAuth Client ID and Secret) empty — Claude registers itself automatically.
Click Add.

Option B: Claude Code

Run this command in your terminal:

claude mcp add encelade \
  --transport http \
  https://www.encelade.ai/api/mcp

Tip:If a browser window doesn't open automatically, run /mcp in Claude Code, select encelade, then choose authenticate.

Option C: Codex

Run this command in your terminal:

codex mcp add encelade \
  --url https://www.encelade.ai/api/mcp

Step 2: Authorize on encelade.ai

Adding the connector opens a browser tab on the Encelade authorization page.

If you're already signed in to encelade.ai, you'll land directly on the consent screen.
If you're signed out, you'll be asked to sign in first (a magic link is emailed to you), then automatically returned to the consent screen.

On the consent screen you'll see:

The client name (e.g. Claude, Claude Code, Codex) and the redirect host, with a verified / unknown / local-dev badge so you can confirm it's the client you just connected.
A workspace selector if your account belongs to more than one workspace — the connection will be scoped to the one you pick.
A short summary of what the client can do: read and edit your Encelade decks, and generate new decks on your behalf.
A note that authorization expires in 90 days and can be revoked anytime from Settings.

Click Authorize. The tab redirects back to your MCP client and the connection is live.

Step 3: Verify the connection

Claude Desktop

Click the tools icon in the chat input area. You should see Encelade tools listed (e.g. list_projects, generate_project).

Claude Code

Run:

claude mcp list

encelade should appear with status connected.

Step 4: Try it out

Start a new conversation with Claude and try these example prompts:

“List all my presentation projects” — Claude will call list_projects and show your workspace projects.
“Create a presentation about our Q3 business results with slides on revenue, growth, and roadmap” — Claude will generate a full presentation and return a link when done.
“Plan an outline for a product launch deck” — Claude will create an outline without generating content, so you can review before committing.

Available tools

Once connected, Claude has access to these tools:

Tool	Description
`list_projects`	List presentation projects in your workspace
`get_project`	Get details of a specific project
`update_project`	Update a project's name or theme
`delete_project`	Permanently delete a project
`plan_project`	Generate an outline without producing slides
`generate_project`	Generate a full presentation from a topic
`get_generation_session`	Check the status of an in-progress generation

Revoking access

Open Settings on encelade.ai to see every MCP client connected to your workspace and revoke any of them. The authorization also expires automatically after 90 days — when that happens, reconnecting from Claude restarts the OAuth flow and mints a fresh token.

Troubleshooting

Problem	Solution
Browser tab doesn't open after adding the connector	In Claude Code, run `/mcp`, select encelade, then authenticate. In Claude Desktop, remove and re-add the connector.
“Unknown OAuth client” on the authorize page	Restart the connection from your MCP client — dynamic client registration didn't complete on the previous attempt.
Authorize button disabled and no workspace listed	Your account doesn't yet have an admin or editor role on any workspace. Finish signup at encelade.ai first, or ask a workspace admin to invite you as editor.
Tools don't appear after authorizing	Restart Claude Desktop, or in Claude Code run `claude mcp list` to confirm `encelade` is `connected`.
Generation seems stuck	Ask Claude to call `get_generation_session` with the session id — large decks can take a few minutes.
Need to disconnect a client	Visit Settings on encelade.ai and revoke the token for that client.

Next steps

Authentication — for server-side and B2B integrations that use API tokens directly instead of OAuth.
API Reference — explore the full REST API with interactive examples.