Diese Dokumentation per MCP mit deinem KI-Assistenten verbinden

Diese Dokumentation steht automatisch als Model-Context-Protocol-Server (MCP) bereit. Sobald du deinen KI-Assistenten damit verbindest, kann er diese Doku bei Bedarf durchsuchen und lesen — seine Antworten zu Avaluma bleiben so an der aktuellen Dokumentation verankert, statt geraten zu werden.

Der MCP-Endpoint

Der gehostete MCP-Server läuft unter der Doku-Domain mit angehängtem /mcp:

https://docs.avaluma.ai/mcp

Es gibt nichts zu deployen oder zu warten — Mintlify hostet den Server und hält ihn mit der Live-Doku synchron. Er stellt schreibgeschützte Such- und Navigations-Tools über alle veröffentlichten Seiten bereit.

Der gehostete MCP-Server ist im kostenlosen Mintlify-Plan enthalten und wird für jede Doku-Site automatisch erzeugt — auf unserer Seite ist keine zusätzliche Konfiguration nötig.

Assistenten verbinden

Alle vier Clients verbinden sich über denselben Remote-HTTP-Endpoint. Wähle unten dein Tool.

Claude Code
OpenAI Codex
Gemini CLI
Google Antigravity

Server per Claude-Code-CLI hinzufügen:

claude mcp add --transport http avaluma-docs https://docs.avaluma.ai/mcp

Anschließend prüfen, ob er verbunden ist:

claude mcp list

Die avaluma-docs-Tools stehen in deiner nächsten Claude-Code-Sitzung zur Verfügung.

Server per Codex-CLI hinzufügen:

codex mcp add avaluma-docs --url https://docs.avaluma.ai/mcp

Das schreibt den Server in ~/.codex/config.toml. Der gleichwertige manuelle Eintrag lautet:

~/.codex/config.toml

[mcp_servers.avaluma-docs]
url = "https://docs.avaluma.ai/mcp"

Die genauen codex mcp add-Flags können sich zwischen Codex-Versionen ändern. Weicht der Befehl in deiner Version ab, trage den Block [mcp_servers.avaluma-docs] direkt in ~/.codex/config.toml ein.

Server unter mcpServers in ~/.gemini/settings.json eintragen. Für einen Remote-HTTP-Server nutzt du das Feld httpUrl:

~/.gemini/settings.json

{
  "mcpServers": {
    "avaluma-docs": {
      "httpUrl": "https://docs.avaluma.ai/mcp"
    }
  }
}

Starte die Gemini CLI neu, damit der neue Server geladen wird.

Server unter mcpServers in ~/.gemini/config/mcp_config.json eintragen. Antigravity nutzt für Remote-Server das Feld serverUrl; die Datei wird zwischen Antigravity-CLI und -IDE geteilt:

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "avaluma-docs": {
      "serverUrl": "https://docs.avaluma.ai/mcp"
    }
  }
}

Verwende serverUrl (nicht das ältere httpUrl), halte das JSON kommentarfrei und lade Antigravity anschließend neu.

Funktion prüfen

Stelle nach dem Verbinden eine Frage, die sich nur aus dieser Doku beantworten lässt, zum Beispiel:

Wie schalte ich über den Avaluma-Docs-MCP-Server das Mikrofon eines eingebetteten Avatars stumm?

Funktioniert die Verbindung, ruft der Assistent das Doku-Such-Tool auf und antwortet mit Inhalten von der Messaging-Seite.

Fehlerbehebung

Der Assistent sieht die neuen Tools nicht

Starte den Client nach dem Hinzufügen neu — die meisten Assistenten laden MCP-Server nur beim Start. Bei Claude Code prüfst du mit claude mcp list, ob der Server-Status connected ist.

Verbindungs- oder Transport-Fehler

Stelle sicher, dass du den HTTP-Transport verwendet hast (--transport http / httpUrl / serverUrl) und exakt die URL https://docs.avaluma.ai/mcp. SSE- oder stdio-artige Einträge funktionieren mit dem gehosteten Endpoint nicht.

JSON-Konfiguration lädt nicht

Validiere das JSON — ein nachgestelltes Komma oder ein Inline-Kommentar verhindert, dass Gemini CLI und Antigravity die Datei lesen. Antigravity erlaubt insbesondere keine Kommentare in mcp_config.json.

​Der MCP-Endpoint

​Assistenten verbinden

​Funktion prüfen

​Fehlerbehebung

Der MCP-Endpoint

Assistenten verbinden

Funktion prüfen

Fehlerbehebung