Über das Model Context Protocol können KI-Assistenten wie Claude das Handbuch durchsuchen, lesen und – mit Änderungsrecht – pflegen. Diese Dokumentation wurde selbst so angelegt.

Abb.: MCP von der Kommandozeile: Werkzeugliste abrufen
| Adresse | http://docs.bbasic.de/mcp |
| Transport | Streamable HTTP, zustandslos (jede Anfrage ein POST, Antwort JSON) |
| Anmeldung | Authorization: Bearer bbh_… – ohne Token nur lesen |
Einrichten
Claude Code
claude mcp add --transport http bbasic-handbuch http://docs.bbasic.de/mcp --header "Authorization: Bearer DEIN_TOKEN"
Andere Clients (JSON)
{
"mcpServers": {
"bbasic-handbuch": {
"type": "http",
"url": "http://docs.bbasic.de/mcp",
"headers": { "Authorization": "Bearer DEIN_TOKEN" }
}
}
}
Werkzeuge
| Werkzeug | Zweck | Recht |
|---|---|---|
handbuch_list_projects | Handbücher mit ID und Umfang | lesen |
handbuch_get_tree | Inhaltsverzeichnis | lesen |
handbuch_search | Volltextsuche | lesen |
handbuch_get_topic | Seite als Markdown oder HTML | lesen |
handbuch_list_media | Medien mit URL | lesen |
handbuch_create_topic / _update_topic / _delete_topic | Seiten pflegen | Bearbeiter |
handbuch_create_category | Kapitel anlegen | Bearbeiter |
handbuch_upload_media | Bild/PDF hochladen (Base64) | Bearbeiter |
handbuch_list_revisions / _restore_revision | Verlauf | Bearbeiter |
handbuch_create_project | Handbuch anlegen | Projekte anlegen |
handbuch_admin_* | Benutzer auflisten, anlegen, ändern, löschen | Administrator |
Schutzmechanismen
- Verlauf: jede KI-Änderung sichert den vorherigen Stand (Quelle „KI-Assistent (MCP)“).
- Platzhalter bleiben: fehlen DocumentX-Platzhalter im neuen Inhalt, wird die Änderung abgelehnt.
- Kein aktiver Inhalt: Script, iframe, Event-Handler und JavaScript-Links werden abgelehnt.
- Rechte:
tools/listzeigt nur, was das Token darf.
Beispiel-Aufträge an den Assistenten
- „Suche im Handbuch alle Seiten zum Thema Mahnung und fasse die Schritte zusammen.“
- „Lege im Kapitel Buchhaltung eine Seite ‚Gutschrift erstellen‘ an, Status Zu prüfen.“
- „Prüfe alle Seiten im Kapitel Installation auf veraltete Versionsnummern.“