Xperience by Kentico ManagementApiMcp

Model Context Protocol (MCP) server for managing data in Xperience by Kentico.

Development

To develop the ManagementApiMcp

1. Run the npm install to install packages
2. Run the npm run dev to start watcher that will rebuild the mcp on any change.

To run the development Management API MCP in cursor/vscode/etc:

1. Run npm run dev or npm run build at least once
2. Add Kentico.Xperience.ManagementApi integration package to the DancingGoat and call AddKenticoManagementApi() / UseKenticoManagementApi(). Specify 32char length secret.
3. Run the DancingGoat
4. Update the ./mcp-config.json to include correct secret and run npm run debug.
5. Otherwise, you can add the following config to vscode/cursor/etc.:

{
    "mcpServers": {
        "xperience": {
            "type": "stdio",
            "command": "node",
            "args": ["C:\\CMS\\XbK\\CMSSolution\\Integrations\\Kentico.Xperience.ManagementApiMcp\\dist\\index.js"],
            "env": {
                "NODE_OPTIONS": "--use-system-ca",
                "CACHE_OPENAPI": "false",
                "MANAGEMENT_API_URL": "https://localhost:5001/kentico-api/management",
                "MANAGEMENT_API_SECRET": "<your-32+char-secret>"
            }
        }
    }
}

Or prettier one if you execute npm link:

{
    "mcpServers": {
        "xperience": {
            "type": "stdio",
            "command": "xperience-mcp",
            "env": {
                "NODE_OPTIONS": "--use-system-ca",
                "CACHE_OPENAPI": "false",
                "MANAGEMENT_API_URL": "https://localhost:5001/kentico-api/management",
                "MANAGEMENT_API_SECRET": "<your-32+char-secret>"
            }
        }
    }
}

Custom environment variables

The following environment variables are used:

• MANAGEMENT_API_URL - path to the Management API endpoint
• MANAGEMENT_API_SECRET - required, secret used for Authorization header when calling the Management API (must be at least 32 characters)
• CACHE_OPENAPI - optional, can disable caching of OpenAPI spec for development purposes.