Zum Inhalt springen
Reality Graph

MCP-Server

Verifikations-Tools als MCP-Server

Zuletzt aktualisiert: 2026-07-22Lesezeit ca. 4 Min.

Der Reality-Graph-MCP-Server bringt Wissen zur KI-Code-Prüfung in deinen KI-Assistenten: ein Verification-Debt-Rechner mit transparentem Rechenweg plus Suche über 50+ belegte Artikel, 40+ Glossar-Definitionen und die Kernstatistiken des Sektors - auf Deutsch und Englisch. Kostenlos, read-only, ohne Konto, ohne Datenspeicherung. Einfach https://realitygraph.dev/api/mcp als Custom Connector hinzufügen und losfragen.

Inhalt

10 Tools, ehrlich zugeschnitten

ToolWas es tutBeispiel-Prompt
check_verification_debtSchätzt die Verification Debt eines Teams aus Team-Parametern: die vier publizierten Kennzahlen, eine Jahreskosten-Spanne, der volle Rechenweg, gekennzeichnete Annahmen, Quellen„Wir sind 12 Entwickler, ca. 60 % der Merges sind KI-gestützt, 25 Review-Stunden pro Woche. Prüfe unsere Verification Debt (lang: de).“
lint_task_specPrüft, ob ein Arbeitsauftrag für einen KI-Agenten verifizierbar ist, bevor du ihn übergibst: die vier Bausteine (Ziel, Grenzen, Kriterien, Validierung), Checks auf vage Adjektive und Unhappy Paths, Lücken-Fragen, Ausfüll-Gerüst„Linte diesen Auftrag, bevor ich ihn dem Agenten gebe: ‚Mach das Dashboard schneller und den Code sauberer.‘ (lang: de)“
get_task_contract_templateLiefert das kostenlose Ausfüll-Template (v0) für einen prüfbaren Auftrags-Contract - Ziel, Non-Goals, Grenzen, Akzeptanzkriterien, Validierungsplan, erwartete Evidenz - als Markdown oder maschinell befüllbares JSON, mit ausgefülltem Beispiel„Hol das Auftrags-Contract-Template als JSON und fülle es für dieses Feature aus: … (lang: de)“
validate_task_contractValidiert einen ausgefüllten Auftrags-Contract: Verdikt (PASS / PASS MIT WARNUNGEN / FAIL), vier Dimensions-Scores und ein konkreter Fix pro Befund - deterministische Formprüfung„Validiere diesen ausgefüllten Contract, bevor ich ihn dem Agenten gebe: {…} (lang: de)“
get_verification_report_templateDas Ausfüll-Template für das Artefakt direkt nach dem Run: geänderte und unangetastete Dateien, Validierung pro Kriterium, übersprungene Checks, Grenzen, explizite Entscheidung„Hol das Prüfbericht-Template und fülle es aus diesem Diff und Test-Output vor. (lang: de)“
searchVolltextsuche über die Reality-Graph-Wissensbasis: Artikel, Glossar, FAQ-Antworten und Statistiken zur KI-Code-Prüfung (DE + EN)„Durchsuche die Reality-Graph-Wissensbasis nach den Verification-Gap-Statistiken.“
fetchHolt ein Dokument aus einem Suchtreffer: Zusammenfassung, Definitionen, Kernfakten, FAQ und Quellen, mit kanonischer URL„Hole /de/verification-debt und fasse die Gegenmaßnahmen zusammen.“
plan_change_verificationErstellt einen risikobasierten Prüfplan mit Checks, manuellen Szenarien, Evidenz, Blockern, Rollenübergabe und passendem Wissen.„Plane die Prüfung einer Auth- und Datenbankänderung mit Kundendaten; Rollback ist dokumentiert. (lang: de)“
check_release_readinessLiefert GO, CONDITIONAL oder NO_GO ausschließlich aus den angegebenen Akzeptanz- und Prüfnachweisen.„Prüfe die Release-Bereitschaft aus diesen Kriterien, Checks, Rollback- und Monitoring-Fakten: … (lang: de)“
calculate_verification_capacityBerechnet Review-Bedarf, Auslastung, Kapazitätslücke, tragbaren Durchsatz und Evidenzabdeckung aus gemessenen Teamwerten.„Wir liefern 45 KI-Änderungen pro Woche, je 35 Review-Minuten, bei 18 verfügbaren Stunden. Berechne die Kapazität. (lang: de)“
Zehn fokussierte Tools für echte Arbeitsabläufe. Alle sind read-only und kostenlos; Workflow-Prüfungen sind deterministisch, search und fetch liefern veröffentlichte Reality-Graph-Inhalte. Auf unserer Seite läuft kein LLM.

Der Rechner implementiert exakt die Modelle aus Verification Debt messen und Was Verification Debt kostet - gleiche Formeln, gleiche Schwellenwerte, gleiche Quellen. Jede Antwort endet mit ihrem Rechenweg, denn genau darum geht es: Behauptungen sollen ihre Belege mitbringen.

Öffentliche Discovery-JSON

Diese Seite ist die menschliche Dokumentation. Der Protokoll-Endpoint liegt unter /api/mcp. Maschinell lesbare Discovery steht unter /.well-known/mcp, /.well-known/mcp.json und /.well-known/mcp/server-card.json. Diese JSON-Dateien beschreiben nur die öffentliche read-only-Fläche: Dokumentation, Legal-/Privacy-Links, den stateless MCP-Endpoint und die Tool-Namen. Sie enthalten keine Admin-, Lead-, Kunden-, Private-Briefing-, Analytics-, GEO-Admin-, repo-privaten oder roadmap-privaten Daten.

initialize

Smoke-Test
curl -sS https://realitygraph.dev/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": { "name": "smoke-test", "version": "0.0.0" }
    }
  }'

Ein Browser-GET auf /api/mcp liefert absichtlich 405; dieser stateless MCP-Endpoint nimmt JSON-RPC-Anfragen per POST entgegen.

Verbinden aus Claude (Web, Desktop, Mobile)

Custom Connectors gibt es ab dem Free-Plan (ein Custom Connector; unbegrenzt ab Pro). In Claude: Settings → Connectors → Add custom connector, Endpoint-URL einfügen, hinzufügen - OAuth-Felder bleiben leer. Auf dem Web hinzugefügte Connectors synchronisieren auch in die Mobile-Apps.

claude-connector

URL kopieren
Settings → Connectors → Add custom connector

Name:  Reality Graph Verification Tools
URL:   https://realitygraph.dev/api/mcp

Für Claude Code genügt ein Befehl:

claude-code

Terminal
claude mcp add --transport http reality-graph https://realitygraph.dev/api/mcp

Verbinden aus ChatGPT

Custom-MCP-Connectors erfordern den Developer Mode (Plus, Pro, Business, Enterprise oder Edu - im Web). Aktivieren unter Settings → Apps & Connectors → Advanced settings → Developer mode, dann den Connector anlegen:

chatgpt-connector

Developer Mode
Settings → Connectors → Create

Name:            Reality Graph Verification Tools
MCP server URL:  https://realitygraph.dev/api/mcp
Authentication:  No authentication

Weil der Server Tools mit den Namen search und fetch bereitstellt, funktioniert er auch als Quelle im Research-Modus von ChatGPT - nicht nur im Developer Mode.

Verbinden aus Perplexity, Cursor und VS Code

Perplexity (Pro, Max, Enterprise): Settings → Connectors → Add custom connector → Remote wählen, URL einfügen, Authentication auf None, Transport auf Streamable HTTP.

Cursor - in .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global) eintragen:

mcp.json

Cursor
{
  "mcpServers": {
    "reality-graph": {
      "url": "https://realitygraph.dev/api/mcp"
    }
  }
}

VS Code (GitHub Copilot) - MCP: Add Server aus der Command Palette, oder in mcp.json:

mcp.json

VS Code
{
  "servers": {
    "reality-graph": {
      "type": "http",
      "url": "https://realitygraph.dev/api/mcp"
    }
  }
}

Sicherheit und Datenschutz, by design

Der Server tut

  • Read-only-Tool-Calls mit veröffentlichten, belegten Inhalten beantworten
  • Eingaben stateless im Arbeitsspeicher verarbeiten und verwerfen
  • Anfragen rate-limitieren und Eingabegrößen gegen Missbrauch begrenzen
  • In jeder Antwort Annahmen kennzeichnen und Quellen nennen

Er tut nicht

  • Irgendetwas speichern, loggen oder weiterverwenden, was du sendest
  • Konto, API-Key oder OAuth verlangen
  • Cookies setzen oder Nutzer tracken
  • Irgendwo schreiben, committen oder etwas verändern

Wenn diese Grenzen zu eurem Team passen:

Der Endpoint wird aus Deutschland unter der DSGVO betrieben, vom im Impressum genannten Betreiber; Details in der Datenschutzerklärung. Der Server folgt dem stateless Streamable-HTTP-Transport der MCP-Spezifikation; Tool-Beschreibungen sind offen versioniert und ändern sich nie zur Laufzeit. Sicherheitsprobleme bitte über die Kontaktseite melden.

Der kostenlose Verifikations-Loop

Die Tools sind als ein Loop um einen KI-Coding-Run herum gebaut - derselbe Loop, den die Methoden-Artikel beschreiben, von Hand ausführbar und kostenlos:

  1. Vorher: get_task_contract_template → ausfüllen → lint_task_spec / validate_task_contract bis PASS.
  2. Run: dein KI-Coding-Tool der Wahl macht die Arbeit - der Contract reist mit dem Auftrag.
  3. Danach: get_verification_report_template → festhalten, was geprüft, was übersprungen, wer entschieden hat.

All das ist die Hand-Ausgabe des Loops, den Reality Graph als Produkt lokal ausführt (Private Beta): Prüfberichte pro Run - gleiche Disziplin, ohne das Abtippen. Wenn sich der manuelle Loop in deinem Team bezahlt macht, ist das das Signal: Early Access ist offen.

WebMCP: die Tools stecken auch in der Website

Neben dem Remote-Server registriert diese Website ihre Tools auch im Browser über den entstehenden WebMCP-Standard (Chrome 149+ Origin Trial, document.modelContext): Ein Browser-Agent, der realitygraph.dev besucht, bekommt dieselben 10 aufrufbaren, read-only Tools, statt die Oberfläche erraten zu müssen, darunter lint_task_spec, check_verification_debt sowie search + fetch zum Finden und Lesen von Artikeln. Gleiche Implementierung, gleiche Datenschutz-Haltung - die Seiten-Tools rufen denselben stateless Endpoint auf.

Warum es das gibt

Die Reality-Graph-Wissensbasis - Verification Debt, die Verification-Gap-Statistiken, das Glossar - ist zum Zitieren geschrieben: in sich geschlossene Definitionen, benannte Quellen. Ein MCP-Server ist der kürzeste Weg von diesem Wissen dorthin, wo Entwickler tatsächlich fragen: in ihren KI-Assistenten. Das Produkt selbst, eine Local-First-Verifikationsschicht fürs KI-Coding, bleibt konzeptbedingt lokal - dieser Server liefert nur, was ohnehin öffentlich ist. Ein Coding-Agent, der in eurem Repository arbeitet, spricht mit einem anderen: einem lokalen Read-only-Server, der seine Absagen schriftlich gibt. Gleiches Protokoll, andere Maschine, andere Daten.

FAQ

Was ist der Reality-Graph-MCP-Server?
Ein kostenloser, öffentlicher Remote-MCP-Server (Model Context Protocol) unter https://realitygraph.dev/api/mcp. Als Connector hinzugefügt, kann dein KI-Assistent die Verification Debt eines Teams mit transparentem Rechenweg schätzen und die Reality-Graph-Wissensbasis zur KI-Code-Prüfung durchsuchen - belegte Statistiken, Glossar-Definitionen und Methoden, direkt im Chat.
Kostet das etwas oder braucht es ein Konto?
Nein. Der Server ist kostenlos, ohne Konto, ohne API-Key, ohne OAuth. Er ist read-only und gegen Missbrauch rate-limitiert. Er existiert, damit die veröffentlichte Wissensbasis dort nutzbar ist, wo Entwickler tatsächlich arbeiten: im KI-Assistenten.
Was passiert mit den Daten, die ich an die Tools sende?
Nichts wird gespeichert. Der Server ist stateless: Tool-Eingaben werden im Arbeitsspeicher verarbeitet, um die Antwort zu berechnen, und danach verworfen. Keine Sessions, keine Cookies, keine Konten; Anfrageinhalte werden nie geloggt. Nur anonyme Betriebs-Metadaten (Tool-Name, Antwortzeit, grober Client-Typ) werden transient für die Kapazitätsplanung erfasst.
Welche KI-Clients können ihn nutzen?
Jeder MCP-Client, der Remote-Server über Streamable HTTP unterstützt: Claude (Web, Desktop, Mobile - Custom Connectors gibt es ab dem Free-Plan), Claude Code, ChatGPT (Developer Mode, ab Plus), Perplexity (ab Pro), Cursor, VS Code mit GitHub Copilot, Windsurf und weitere. Die Verbindungsschritte pro Client stehen auf dieser Seite.
Wie funktioniert der Verification-Debt-Rechner?
Deterministische Arithmetik, kein LLM: Er implementiert die vier publizierten Kennzahlen (Generation-to-Verification-Ratio, Review-Tiefe, Unverified-Merge-Rate, Two-Week-Churn) und das publizierte Kostenmodell und liefert den vollständigen Rechenweg - jede Annahme gekennzeichnet, jede Quelle genannt. Nur die Teamgröße ist Pflicht; jede weitere Angabe verfeinert die Schätzung.
Können die Tools etwas in meinem Repository oder Konto ändern?
Nein. Alle 10 Tools sind read-only und über MCP-Tool-Annotations (readOnlyHint) auch so deklariert. Der Server rechnet und liefert Inhalte - er schreibt nichts, speichert nichts und ruft nichts in deinem Namen auf.

Weiterlesen

Quellen

Wollt ihr sehen, wie euer letzter Agenten-Run ausgesehen hätte?

Zugang anfragen