Connect an MCP client

The built-in Model Context Protocol server lets a compatible AI client invoke Presenton presentation workflows. MCP is available in the self-hosted web deployment at /mcp; it is disabled in the Electron desktop app.

Before you start

Run Presenton with Docker, Compose, or another web deployment.
Confirm browser generation works.
Configure the primary administrator for any shared or remote instance.
Confirm your client supports a remote HTTP MCP server and custom headers.

1. Start an authenticated instance

docker run -it --name presenton \
  --publish 5001:80 \
  --env AUTH_USERNAME=admin \
  --env AUTH_PASSWORD=replace-with-a-long-password \
  --volume "./app_data:/app_data" \
  ghcr.io/presenton/presenton:v0.9.3-beta

Open http://localhost:5001, sign in, and create a small test presentation before continuing.

2. Generate an API key

Sign in as the primary administrator, open Admin → API keys, select Generate key, and copy the new sk-presenton-... value. The key is shown only when it is created.

A Presenton API key grants API and MCP access. Do not commit it to a repository, paste it into support tickets, or expose it in screenshots.

3. Configure the MCP client

Configuration formats vary by client. The following examples use the structure from the Presenton README; adapt the outer file location and environment-variable syntax to your client.

Example A: local authenticated server

{
  "mcpServers": {
    "presenton": {
      "url": "http://localhost:5001/mcp",
      "headers": {
        "Authorization": "Bearer sk-presenton-REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Example B: remote HTTPS server

{
  "mcpServers": {
    "presenton-production": {
      "url": "https://presentations.example.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-presenton-REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Use HTTPS for any connection that leaves the local machine. The reverse proxy must forward the Authorization header and support the connection behavior required by your MCP client.

Example C: local server without configured auth

For an isolated development instance where authentication has not been configured, omit the header:

{
  "mcpServers": {
    "presenton-local": {
      "url": "http://localhost:5001/mcp"
    }
  }
}

Do not use an unauthenticated configuration on a publicly reachable instance.

Example D: development and production instances

{
  "mcpServers": {
    "presenton-local": {
      "url": "http://localhost:5001/mcp",
      "headers": {
        "Authorization": "Bearer sk-presenton-LOCAL_KEY"
      }
    },
    "presenton-production": {
      "url": "https://presentations.example.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-presenton-PRODUCTION_KEY"
      }
    }
  }
}

Give each instance a clear name so users know where uploaded documents and generated presentations will be stored.

4. Restart and verify the client

Reload MCP configuration

Restart the client or use its MCP reload action so it reads the new server entry.

Check discovery

Confirm the client reports the Presenton server as connected and displays its available presentation tools.

Run a small request

Ask the client to create a short two-slide presentation about a harmless test topic.

Review in Presenton

Open the returned edit URL, inspect the slides, and confirm the presentation appears in the correct instance.

Key rotation and recovery

Revoke a key from Admin → API keys and generate a replacement whenever a client no longer needs access or a key may have been exposed. Credential override or administrator recovery invalidates existing browser sessions and API keys. If a client starts returning unauthorized errors:

Confirm the Presenton URL and /mcp path.
Sign in as the primary administrator.
Confirm the key is still active under Admin → API keys, or generate a replacement.
Replace the old key in the client configuration.
Restart or reload the client.

Secure a remote MCP deployment

Use HTTPS and a trusted certificate.
Keep Presenton authentication enabled.
Restrict network access to expected users and clients.
Store API keys in the client’s secret store when supported.
Revoke and replace keys after suspected exposure.
Protect /app_data, because MCP-created presentations and uploads are stored there.
Review generated presentations before publishing or exporting them.

The client cannot find Presenton tools

Confirm that it supports remote HTTP MCP, that the URL ends in /mcp, and that configuration was reloaded. The desktop app does not expose MCP.

The server returns 401 or unauthorized

Confirm the API key is active and the header is exactly Authorization: Bearer sk-presenton-REPLACE_WITH_YOUR_KEY.

It works locally but not through a reverse proxy

Verify HTTPS routing to container port 80, forwarding of the Authorization header, and the proxy’s timeout or buffering behavior for remote MCP connections.

Keys stopped working after a deployment change

Administrator credential override or recovery invalidates API keys. Sign in again, generate a new key, and update the MCP client.

The MCP client discovers Presenton’s tools, creates a test presentation, and returns a result that opens in the intended self-hosted instance.

Getting started

Deploy

Configure

Enterprise

Before you start

1. Start an authenticated instance

2. Generate an API key

3. Configure the MCP client

Example A: local authenticated server

Example B: remote HTTPS server

Example C: local server without configured auth

Example D: development and production instances

4. Restart and verify the client

Key rotation and recovery

Secure a remote MCP deployment

​Before you start

​1. Start an authenticated instance

​2. Generate an API key

​3. Configure the MCP client

​Example A: local authenticated server

​Example B: remote HTTPS server

​Example C: local server without configured auth

​Example D: development and production instances

​4. Restart and verify the client

​Key rotation and recovery

​Secure a remote MCP deployment

Before you start

1. Start an authenticated instance

2. Generate an API key

3. Configure the MCP client

Example A: local authenticated server

Example B: remote HTTPS server

Example C: local server without configured auth

Example D: development and production instances

4. Restart and verify the client

Key rotation and recovery

Secure a remote MCP deployment