MCP — Tesserae an Claude Code, Codex und Cursor anbinden

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français

<!-- translations:end -->

Tesserae bringt einen Model Context Protocol-stdio-Server mit, der den kompilierten typisierten Graphen jedem MCP-fähigen Client zur Verfügung stellt: Claude Code, Codex CLI, Cursor, Claude Desktop und weiteren. Der Server bedient alle drei vollständigen MCP-Oberflächen — tools, resources und prompts — sodass Clients den Graphen sowohl on demand abfragen als auch günstig Kontext aus kanonischen URIs vorbefüllen können.

Voraussetzungen

Der Server liest aus .tesserae/graph.json, daher ist ein einmaliger Compile erforderlich:

cd /path/to/your-project
tesserae project setup    # interactive; or --yes for non-interactive
tesserae project compile  # deterministic, no LLM calls, no API keys

Recompiliere jederzeit, wenn sich deine Quellen ändern. Der Server greift beim nächsten Tool-Call automatisch auf den neuen Graphen zu — ein Neustart ist nicht nötig.

1) Client-Konfiguration generieren

tesserae project mcp-config

Gibt ein JSON-Snippet etwa in dieser Form aus:

{
  "mcpServers": {
    "tesserae": {
      "command": "python3",
      "args": [
        "-m", "tesserae.mcp_server",
        "--graph", "/path/to/your-project/.tesserae/graph.json"
      ]
    }
  }
}

Der exakte Pfad wird aus dem aktuellen Projekt eingesetzt. Übergib --name <alias>, wenn du einen anderen Servernamen als tesserae möchtest.

2) In deinen MCP-Client einfügen

Starte den Client nach der Bearbeitung neu. Die nächste Sitzung verbindet sich und entdeckt die Tesserae-Oberfläche.

3) Was der Client sieht

Tools — vom Modell aufgerufen

Resources — automatisch in den Modellkontext geladen

URIs, die der Client über seinen Resource-Picker einbinden kann, ohne einen Tool-Turn zu verbrauchen:

• tesserae://graph/schema — derselbe Payload wie das Tool schema, fertig als statischer Kontext
• tesserae://graph/summary — Zusammenfassung des aktiven Projekts
• tesserae://lint-report — der aktuelle Lint-Report als Markdown

Dazu URI-Templates, die der Client on demand zusammensetzen kann:

• tesserae://wiki/{kind}/{slug} — beliebiger kompilierter Wiki-Seiteninhalt
• tesserae://raw/{source_path} — beliebiges Quell-Markdown

Prompts — Ein-Klick-Recherche-Templates

Diese erscheinen im Slash-Menü des Clients (z. B. in Claude Codes /-Palette):

Jeder Prompt rendert zu einer einzigen User-Message, die dem Modell genau sagt, welche Tesserae-Tools zu verketten sind — so muss das Modell die Oberfläche nicht jedes Mal neu entdecken.

Multi-Projekt: mehrere Vaults unter einem Server registrieren

Eine persistente Registry unter ~/.tesserae/registry.json erlaubt es demselben MCP-Server, jedes registrierte Projekt namentlich aufzulösen:

tesserae register-project /path/to/research --name research
tesserae register-project /path/to/notes    --name notes

Danach löst jedes Tool, das project oder graph_path akzeptiert, project: "research" über die Registry auf, statt einen vollen Pfad zu benötigen. Der Server validiert sogar, dass der registrierte graph_path weiterhin existiert, und liefert eine klare Fehlermeldung, falls ein Recompile nötig ist.

Fan-out über alle registrierten Vaults

Das Tool ask akzeptiert scope: "all-registered", um jedes registrierte Projekt parallel abzufragen und die Ergebnisse aggregiert zurückzugeben:

{
  "name": "ask",
  "arguments": {
    "question": "Where is splatting used?",
    "scope": "all-registered"
  }
}

Auf eine Teilmenge einschränken lässt sich das Ganze über scope_aliases: ["research", "notes"].

Multi-Account Claude CLI

Wenn dein ask-Tool über die Claude CLI läuft und du mehrere Accounts hast (z. B. ~/.claude und ~/.claude-personal2), übergib claude_config_dir pro Aufruf:

{
  "name": "ask",
  "arguments": {
    "question": "...",
    "claude_config_dir": "/Users/you/.claude-personal2"
  }
}

Der Server exportiert CLAUDE_CONFIG_DIR nur für die Dauer dieses Aufrufs und stellt anschließend den vorherigen Wert wieder her. Kein Übertrag zwischen Aufrufen.

Verifikation

Prüfe nach einem Neustart deines MCP-Clients die Verbindung:

• Claude Code: /mcp sollte tesserae mitsamt Tool-Anzahl auflisten.
• Cursor: Das MCP-Icon in der Chat-Leiste sollte tesserae: connected mit Tool-/Resource-/Prompt-Zählern zeigen.
• Codex / Hermes: Ein beliebiges Tool namentlich aufrufen (z. B. schema) und die Antwort prüfen.

Falls nichts erscheint, prüfe noch einmal, dass --graph auf eine existierende .tesserae/graph.json zeigt — der Server validiert das jetzt beim Start und bei jedem Tool-Call, sodass du eine klare Fehlermeldung statt eines stillen 500 erhältst.

Wo das hineinpasst

Der MCP-Server ist das Lese-Interface zum typisierten Graphen. Für den Schreibpfad (Quellen ingestieren, recompilieren, Companion-Tools wie RAG-Anything oder Understand-Anything aktualisieren) nutze die CLI direkt. Beide sind entkoppelt: Die CLI aktualisiert .tesserae/, der MCP-Server liest beim nächsten Tool-Call genau das, was dort liegt.