This page is a setup draft. It mirrors the shape of the HeyGen MCP setup pages, while using the confirmed DeckFlow endpoint, API key-only auth model, first-batch clients, and temporary download-link output model.
Prerequisites
- A DeckFlow account.
- Access to the DeckFlow MCP beta or production integration.
- An MCP-compatible client that supports remote HTTP MCP servers.
- A DeckFlow API key.
- Permission to upload or reference source files used in Create, Revamp, Translate, and Tools workflows.
Endpoint
https://dev.deckflow.com/mcp/v1/
The docs currently use this endpoint exactly as provided. Confirm later whether this is the final production URL or a development endpoint.
Dedicated Client Guides
Use the dedicated pages for client-specific setup details:
| Client | Page |
|---|---|
| Claude Code | claude-code.md |
| Claude Web / Desktop | claude-web.md |
| Manus | manus.md |
| OpenAI / ChatGPT | open-ai.md |
This page remains the shared setup overview and fallback for generic MCP-compatible clients.
Authentication
DeckFlow MCP uses API key authentication only.
The final setup guide still needs the API key details:
| API Key Detail | What The Docs Must Explain |
|---|---|
| Key creation URL | Where users create or copy a DeckFlow API key. |
| Secret name | Whether clients should use the Authorization request header (in the form of Bearer <YOUR_API_KEY>). |
| Transport | Whether the key is passed through MCP client secret config, HTTP header config, or an auth prompt. |
| Scope | Whether keys are personal, workspace-scoped, organization-scoped, or project-scoped. |
| Rotation | How users revoke or rotate keys. |
Claude Code
Run the command from a terminal, outside the Claude Code interactive session:
claude mcp add --transport http deckflow https://dev.deckflow.com/mcp/v1/
To install it globally for all Claude Code projects:
claude mcp add --transport http -s user deckflow https://dev.deckflow.com/mcp/v1/
After adding the server, restart Claude Code or run the client-specific MCP refresh command if available.
Alternative Config
If direct config editing is supported in the target Claude Code version, the MCP server should look like this:
{
"mcpServers": {
"deckflow": {
"type": "http",
"url": "https://dev.deckflow.com/mcp/v1/"
}
}
}
Claude Web / Desktop
- Open the connector or integration settings.
- Add a custom connector named
DeckFlow. - Set the remote MCP server URL to:
https://dev.deckflow.com/mcp/v1/
- Save the connector.
- Configure the DeckFlow API key using Claude's supported secret or connector flow.
- Allow the DeckFlow tools when the client asks for tool permissions.
Other MCP Clients
The confirmed first-batch DeckFlow client list is Claude Code, Claude Web/Desktop, Manus, and OpenAI/ChatGPT. Other MCP-compatible clients can be documented later using the generic pattern below after product support is confirmed.
For clients that accept a JSON MCP server definition, use the same remote HTTP structure:
{
"mcpServers": {
"deckflow": {
"type": "http",
"url": "https://dev.deckflow.com/mcp/v1/"
}
}
}
If a client uses a different field name, map the final endpoint to its remote MCP URL field.
Verify The Connection
Use the MCP client's server list or tool discovery command to confirm:
- The
deckflowserver appears in the connected servers list. - DeckFlow tools are visible.
- The client has access to a valid DeckFlow API key.
- A simple account or capability check succeeds, if DeckFlow provides one.
Suggested verification tool, if implemented:
get_current_user
or:
get_deckflow_capabilities
Both names are placeholders until the final tool schema is defined.
First Prompt
After setup, test with a low-risk task:
Use DeckFlow to list the available MCP capabilities and tell me which file formats are supported for Create, Revamp, Translate, and file conversion.
Then test a file workflow:
Use DeckFlow to convert this PowerPoint deck to PDF and return the temporary download link.
Client Permission Notes
MCP clients may ask for permission before each tool call. For smoother workflows, users can usually allow DeckFlow tools for the current chat, project, or workspace.
The final docs should explain permission scope carefully because DeckFlow tools can upload files, create derived files, and return downloadable outputs.
Setup Parameters To Define
| Parameter | Required Before Publishing |
|---|---|
| Endpoint semantics | Whether https://dev.deckflow.com/mcp/v1/ is the public production endpoint or a development/beta endpoint. |
| Server name | Confirm deckflow as the canonical config key. |
| API key transport | Header name, env var name, secret field name, and client-specific setup mechanism. |
| Account scope | Personal workspace, team workspace, organization selection, or project selection. |
| Tool permission policy | Recommended allow/deny settings for clients that prompt before tool calls. |
| File upload path | Whether files are uploaded through MCP, imported by URL, or passed through client attachments. |
| Connection test | Final health/account/capability tool name. |
| Supported clients | Which clients are officially supported vs. generic MCP-compatible. |
For the direct product/API questions, see confirmation-questions.md.