MCP-Server: Dokumentation für KI-Assistenten

Jede Seite dieses Dokumentationsbereichs steht auch Ihrem KI-Coding-Assistenten direkt zur Verfügung: Claude Code, Cursor, VS Code mit GitHub Copilot Chat, Claude Desktop, Windsurf oder jedem anderen Tool, das das Model Context Protocol (MCP) unterstützt. Geben Sie ihm eine URL, und er kann Details zu Einrichtung, Konfiguration, Gestaltung und Lizenzierung selbst nachschlagen, statt dass Sie Dokumentation in den Chat kopieren oder er raten muss (und manchmal danebenliegt).

Was ist MCP, einfach erklärt?

MCP (Model Context Protocol) ist ein offener Standard, mit dem ein KI-Assistent „Tools“ eines externen Servers aufrufen kann, so wie er bereits Tools wie einen Dateieditor oder ein Terminal aufruft. Ein Tool ist einfach eine Funktion mit einem Namen, einer Beschreibung und typisierten Ein- und Ausgaben. Der Assistent entscheidet anhand Ihrer Frage, wann er es aufruft. Dieser Server stellt drei Tools bereit, die auf dem echten, aktuellen Inhalt dieses Dokumentationsbereichs basieren (siehe Bereitgestellte Tools unten): eines, um alle Dokumentationsseiten aufzulisten, eines, um eine bestimmte Seite als Markdown abzurufen, und eines, um alle Seiten zu durchsuchen. Auf Ihrem Rechner wird nichts installiert. Es ist ein entfernter Server, mit dem Ihr Assistent über HTTP kommuniziert, so wie ein Browser mit einer Website.

Schnellstart

Der Server ist unter einer einzigen URL erreichbar. Jede der folgenden Einrichtungen bedeutet eigentlich nur: „Teilen Sie Ihrem Assistenten diese URL mit“:

Server-URL: https://guidemyhair.com/mcp

Assistenten verbinden

Claude Code

Legen Sie im Stammverzeichnis Ihres Projekts eine .mcp.json-Datei an (sie wird in Git eingecheckt, sodass das ganze Team sie automatisch erhält, wenn es das Repository öffnet):

{
  "mcpServers": {
    "guidemyhair-docs": {
      "url": "https://guidemyhair.com/mcp"
    }
  }
}

Oder fügen Sie ihn hinzu, ohne JSON von Hand zu bearbeiten:

claude mcp add --transport http guidemyhair-docs https://guidemyhair.com/mcp

Cursor

Settings → Cursor Settings → MCP → „Add new MCP server“, oder legen Sie .cursor/mcp.json direkt an (gleiche Struktur wie die Konfiguration von Claude Code):

{
  "mcpServers": {
    "guidemyhair-docs": {
      "url": "https://guidemyhair.com/mcp"
    }
  }
}

VS Code (GitHub Copilot Chat)

Befehlspalette → „MCP: Add Server“ → HTTP, oder legen Sie .vscode/mcp.json direkt an. Beachten Sie, dass die Struktur etwas anders ist als bei den anderen: servers statt mcpServers und ein explizites type-Feld:

{
  "servers": {
    "guidemyhair-docs": {
      "url": "https://guidemyhair.com/mcp",
      "type": "http"
    }
  }
}

Claude Desktop

Settings → Connectors → „Add custom connector“ → Server-URL einfügen. Das ist in der Desktop-App der unterstützte Weg für einen entfernten HTTP-Server wie diesen, ohne eine JSON-Datei zu bearbeiten.

Windsurf

Windsurf Settings → Cascade → MCP Servers → „Add custom server“, oder bearbeiten Sie ~/.codeium/windsurf/mcp_config.json direkt (gleiche mcpServers-Struktur wie bei Claude Code/Cursor).

{
  "mcpServers": {
    "guidemyhair-docs": {
      "url": "https://guidemyhair.com/mcp"
    }
  }
}

Jeder andere MCP-Client

Jeder Client, der den Streamable-HTTP-Transport unterstützt, braucht nur die obige URL. An der Verbindung selbst ist nichts GuideMyHair-spezifisch, und eine Authentifizierung ist nicht erforderlich (es handelt sich um öffentliche Dokumentation mit reinem Lesezugriff).

Bereitgestellte Tools

Beispiel-Prompts

Nach der Verbindung müssen Sie die Tools nicht namentlich erwähnen. Fragen Sie Ihren Assistenten einfach ganz normal, und er greift bei Bedarf darauf zurück:

• „Wie richte ich den detaillierten Farbtonkatalog für TreatmentConsultant ein?“
• „Welche CSS Custom Properties kann ich überschreiben, um das Widget zu gestalten?“
• „Warum zeigt mein Widget ein Wasserzeichen an, und welche Lizenzgründe lösen das aus?“
• „Durchsuche die GuideMyHair-Dokumentation nach allem zum Header-Slot“

Fehlerbehebung

Mein Assistent scheint ihn nicht zu verwenden

Die meisten Tools listen verbundene MCP-Server irgendwo in ihren Einstellungen bzw. ihrer Oberfläche auf. Prüfen Sie, ob guidemyhair-docs (oder wie auch immer Sie ihn benannt haben) als verbunden angezeigt wird und ob seine Tools (list_docs, get_doc, search_docs) aufgelistet sind. Manche Assistenten aktivieren neu hinzugefügte Server erst nach einem Neustart.

Ich erhalte „Method not allowed“ oder einen Verbindungsfehler

Prüfen Sie, ob die URL keinen Tippfehler enthält und keinen abschließenden Schrägstrich oder zusätzlichen Pfadabschnitt hat. Sie sollte genau https://guidemyhair.com/mcp lauten.