Per MCP verbinden

Die Knowledge Base ist ein MCP-Server (Model Context Protocol). KI-Assistenten und eigene Programme können alle Inhalte direkt abfragen, dieselben Daten, aus denen diese Seiten entstehen.

POSThttps://api.kb.phx-erp.de/mcp

Streamable HTTP, JSON-RPC 2.0, ohne Anmeldung, nur Lesen. Bis zu 120 Anfragen pro Minute.

Mit einem MCP-Client verbinden

Die Knowledge Base lässt sich mit jedem MCP-Client verbinden, der Remote-Server über Streamable HTTP unterstützt: KI-Assistenten, Entwicklungswerkzeuge, Agenten-Plattformen oder eigene Programme. Tragen Sie in der MCP-Konfiguration Ihres Clients einen neuen Server ein:

Einstellung	Wert
Name	phx-kb (frei wählbar)
Transport	Streamable HTTP
Adresse (URL)	`https://api.kb.phx-erp.de/mcp`
Authentifizierung	keine

Viele Clients verwenden dafür eine JSON-Konfigurationsdatei. Ein typischer Eintrag sieht so aus:

{
  "mcpServers": {
    "phx-kb": {
      "type": "http",
      "url": "https://api.kb.phx-erp.de/mcp"
    }
  }
}

Die genaue Schreibweise (Dateiname, Schlüsselnamen wie „type“ oder „transport“) entnehmen Sie der Dokumentation Ihres Clients. Nach dem Eintragen zeigt der Client die unten aufgeführten Werkzeuge an; zur Prüfung rufen Sie ping oder get_stats auf.

Direkt per HTTP

curl -s https://api.kb.phx-erp.de/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search","arguments":{"q":"X-Rechnung"}}}'

Die Antwort kommt als Server-Sent-Event; das Ergebnis steht unter result.structuredContent.

Werkzeuge

Name	Beschreibung
`ping`	Health-check tool. Returns timestamp and caller role.
`whoami`	Returns the current caller role and identifier. Useful for verifying that a Bearer-API-Key is recognized on the current endpoint.
`get_stats`	Kennzahlen der Knowledge Base: Zahl der sichtbaren Artikel und Bereiche, Artikel mit Text, zuletzt geänderter Artikel und contentVersion (steigt mit jeder inhaltlichen Änderung; daran erkennt der Seitenbau, ob neu gebaut werden muss).
`list_categories`	Die Bereiche (oberste Ebene) der PHX-ERP-Knowledge-Base in ihrer Reihenfolge, z. B. XRM, Artikel, Verkauf, Einkauf, Finanzen, Lager, Einstellungen. Je Bereich: id, Titel, Kurzbeschreibung, Zahl der Artikel darunter und letzte Änderung. Einstieg für jede Recherche.
`get_tree`	Die komplette Gliederung der Knowledge Base ohne Texte: alle Artikel in Baumreihenfolge mit id, parentId, Tiefe, Titel, ob Text vorhanden ist und Zahl der Unterartikel. Für Navigation und Übersicht.
`list_articles`	Listet Artikel: mit parentId die direkten Unterartikel eines Artikels (parentId null = Bereiche), ohne parentId alle Artikel in Baumreihenfolge. query filtert nach Titel und Kurzbeschreibung. Seitenweise mit limit/offset.
`get_article`	Ein Artikel vollständig: Titel, Kurzbeschreibung, Text (Markdown, ohne Bilder), Brotkrumenpfad, Unterartikel, verwandte Artikel sowie vorheriger und nächster Artikel in Lesereihenfolge. Ist die id eine alte, umbenannte Adresse, kommt { redirectTo } zurück.
`get_recent_articles`	Zuletzt geänderte Artikel mit Text, neueste zuerst, jeweils mit Brotkrumenpfad.
`search`	Volltextsuche (deutsch) über Titel, Kurzbeschreibung und Text aller Artikel, ergänzt um Teilwortsuche im Titel. mode "full" versteht Anführungszeichen für Phrasen, OR und -Ausschluss; mode "prefix" wertet jedes Wort als Wortanfang (fürs Suchfeld beim Tippen). Treffer mit Brotkrumenpfad und Textauszug; im Auszug sind Fundstellen als Segmente mit m:true markiert.
`list_redirects`	Weiterleitungen von alten auf neue Artikel-IDs (nur auf öffentlich sichtbare Ziele). Wird vom Seitenbau für Weiterleitungsseiten genutzt.

Gepflegt werden die Inhalte ebenfalls per MCP, über einen getrennten, nicht öffentlichen Zugang der Redaktion.