MCP-Server
Verifikations-Tools als MCP-Server
Zuletzt aktualisiert: 2026-07-03Lesezeit 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
Sieben Tools, ehrlich zugeschnitten
| Tool | Was es tut | Beispiel-Prompt |
|---|---|---|
| check_verification_debt | Schä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_spec | Prü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_template | Liefert 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_contract | Validiert 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_template | Das 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)“ |
| search | Volltextsuche ü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.“ |
| fetch | Holt ein Dokument aus einem Suchtreffer: Zusammenfassung, Definitionen, Kernfakten, FAQ und Quellen, mit kanonischer URL | „Hole /de/verification-debt und fasse die Gegenmaßnahmen zusammen.“ |
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.
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 kopierenSettings → 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
Terminalclaude 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 ModeSettings → 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:
- Vorher:
get_task_contract_template→ ausfüllen →lint_task_spec/validate_task_contractbis PASS. - Run: dein KI-Coding-Tool der Wahl macht die Arbeit — der Contract reist mit dem Auftrag.
- 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 lint_task_spec, check_verification_debt und search_knowledge als aufrufbare Seiten-Tools, statt die Oberfläche erraten zu müssen. 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.
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 sieben 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.