Setup in Claude Desktop

Connect OptimoCMS to Claude Desktop so Claude can manage your websites, create pages, and generate content.

Prerequisites

• Claude Desktop installed (macOS or Windows)
• An OptimoCMS API key with at least read permission (create one here)

Step 1 — Open config file

Claude Desktop stores MCP configuration in a JSON file:

Open this file in a text editor. If it doesn't exist yet, create it.

Step 2 — Add OptimoCMS MCP

Add the optimocms block to mcpServers:

{
  "mcpServers": {
    "optimocms": {
      "type": "streamable-http",
      "url": "https://europe-west4-cms-sg.cloudfunctions.net/mcpServer",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your actual API key.

Step 3 — Restart Claude Desktop

Fully quit Claude Desktop and reopen it. You'll see a hammer icon (🔨) in the text field — this confirms MCP tools are available.

Step 4 — Test with list_sites

Type in Claude:

Show all my OptimoCMS sites.

Claude automatically calls list_sites and displays your sites:

{
  "sites": [
    {
      "id": "site_abc123",
      "name": "Golden Crust Bakery",
      "domain": "goldencrust.com",
      "status": "active",
      "language": "en"
    }
  ],
  "total": 1
}

Step 5 — Try more

Ask Claude to generate a page:

Generate a contact page for site site_abc123 with a form, opening hours, and a Google Maps embed.

Or translate an existing page:

Translate page page_xyz789 of site site_abc123 to German.

Common issues

Next steps

• All available MCP tools — complete overview
• AI Workflows — example prompts for common tasks