EuConquisto Composer

You can run the EuConquisto Composer MCP as a local direct API server that integrates with your Claude Desktop workflow. It lets you manage the entire 7‑step content creation pipeline through a fast, fail‑fast, API‑driven approach, without browser automation, while keeping your educational content in sync with the EuConquisto Composer platform.

How to use

You will connect your MCP client to the local direct API server that runs as a stdio process. Start the server, then use the seven workflow steps in sequence to build a lesson: get_smart_guidance, analyze_content_for_widgets, get_widget_requirements, validate_lesson_data, format_for_composer, save_composition_direct_api, and open_composition_editor. The server validates inputs as you progress and provides actionable error messages to help you fix issues quickly.

How to install

Prerequisites you need on your machine are Node.js 18 or newer, Claude Desktop installed, and EuConquisto Composer account credentials.

Step by step commands to set up and run the MCP locally.

# Clone repository
git clone https://github.com/yourusername/euconquisto-composer-mcp-poc.git
cd euconquisto-composer-mcp-poc

# Install dependencies
npm install

Configuration

Configure Claude Desktop to run the local direct API server. Use the following configuration snippet. This starts a Node process that hosts the direct API server from the built dist file and passes the necessary environment variables for authentication and project context.

{
  "mcpServers": {
    "euconquisto-composer-direct": {
      "command": "node",
      "args": [
        "--max-old-space-size=4096",
        "/absolute/path/to/euconquisto-composer-mcp-poc/dist/direct-api-server-v1.0.0.js"
      ],
      "env": {
        "EUCONQUISTO_ACCESS_TOKEN": "your_access_token_here",
        "EUCONQUISTO_PROJECT_UID": "your_project_uid_here",
        "EUCONQUISTO_CONNECTORS": "[{\"uid\":\"your_connector_uid\",\"name\":null,\"type\":\"Composer_1\",\"permissions\":[]}]",
        "NODE_ENV": "development",
        "MCP_DEBUG": "true"
      }
    }
  }
}

Security and best practices

Keep your access tokens and project identifiers secure. Do not hard‑code credentials in source control. Use environment variables or secret management to inject tokens at runtime. Start the server in a trusted development environment, and monitor logs for any validation errors that indicate misconfiguration.

Troubleshooting and development notes

If you encounter validation errors, you will receive detailed fail‑fast messages that include troubleshooting steps. Enable development mode to get actionable error descriptions and debug guidance. Restart Claude Desktop after any configuration changes to ensure the MCP server is picked up correctly.

Available tools

get_smart_guidance

Fetch educational guidance and widget predictions to inform lesson design.

analyze_content_for_widgets

Analyze content structure against six supported formats to identify widget needs.

get_widget_requirements

Retrieve widget specifications and applicable validation rules for content elements.

validate_lesson_data

Perform fail-fast validation on the lesson structure and provide actionable errors.

format_for_composer

Transform lesson data into the Composer API format with verified structure.

save_composition_direct_api

Persist the composed lesson to the EuConquisto Composer platform via direct API.

open_composition_editor

Open the composition in a browser with navigation checks to ensure readiness.