H1 MCP Server¶

The transport half of H1's AI layer: an AI Chat inside AdminCentral (top-bar panel + [H1] AI app), a Model Context Protocol server for external clients, and a restricted public MCP surface. It exposes whatever tools the registries of h1-mcp-api discover, and drives the conversation against Claude or OpenAI behind a one-method interface.

Version 2.0.0-SNAPSHOT · Magnolia 6.4 · Java 21 · artifact com.habito1:h1-mcp

It also ships the five tools that belong to no domain module: website, asset, content_type, marketing_tag and h1mcp_keywords.

Needs OPENAI_API_KEY or ANTHROPIC_API_KEY in the environment for the chat; the MCP server works without one.

Documentation¶

The documentation lives in docs/ and is published at /modules/h1-mcp/ on the H1 docs site. This file is not the documentation.

• Overview — what the module is, its nine features, its requirements.
• Authors — where the chat is, what to ask it, what it remembers, and the [H1] AI keywords tab.
• Developers · Installation — coordinates, the provider and key variables, how the chat panel gets injected, permissions, verification.
• Developers · Configuration — every environment variable, the MCP protocol surface, the three endpoints, the five tools and their actions, the loop and conversation limits.
• Troubleshooting — symptom to cause, silent failures first.

Build¶

mvn clean install

Requires access to the H1 Nexus repositories; see Developers · Installation.