KnowHowToAI
Hierarchische Markdown-Wissensdatenbank mit MCP-Schnittstelle für KI-Agenten
Was bringt KnowHowToAI?
KI-Assistenten wie Claude, Cursor oder Antigravity sind extrem intelligent – kennen aber Ihre spezifischen Unternehmensprozesse, ERP-Sonderregeln oder Projektdokumentationen nicht. Bisher gab es nur zwei schlechte Wege: Entweder man stopft riesige Doku-Dateien manuell in den Prompt (teuer & unübersichtlich) oder setzt hochkomplexe Vektordatenbanken auf.
KnowHowToAI wählt den eleganten Mittelweg: Sie schreiben Ihre Dokumentation als einfache, übersichtliche Markdown-Dateien auf Ihrer Festplatte. Ein schlanker MCP-Server macht dieses Wissen für KI-Modelle gezielt durchsuchbar. Die KI liest nur genau den einen Absatz, den sie zur Beantwortung der aktuellen Frage benötigt!
Problem & Lösung im Entwickler-Alltag
❌ Der Schmerz ohne KnowHowToAI
- Ganze Handbücher müssen manuell in den KI-Prompt kopiert werden.
- Gefahr von Halluzinationen, weil die KI relevante Firmenregeln in großen Textmengen übersieht.
- Hoher Token-Verbrauch und unnötige Kosten bei jeder einzelnen KI-Anfrage.
- Schwere RAG-Systeme erfordern teure Zusatz-Infrastruktur.
✅ Der Gewinn mit KnowHowToAI
- Einfache Pflege in Markdown: Doku in VS Code oder Obsidian schreiben (inkl. YAML-Frontmatter für
title,tags&synonyms). - Synonym-Finder: Durch YAML-Synonyme findet die KI relevante Dokumente auch dann, wenn sie nach alternativen Begriffen (z. B. "Buchungssatz" statt "Sage100 Export") sucht.
- Semantische MCP-Tools: Die KI navigiert im Dokumenten-Baum (
list_children), sucht nach Begriffen (search_docs) und liest nur den exakten Abschnitt (get_doc). - Bis zu 90% Token-Ersparnis: Spart massiv Kontextbudget im Vergleich zu unstrukturierten Textwüsten.
- Multi-Bibliothek & Sicherheit: Getrennte Wissensbereiche lassen sich in eigenen Datenbank-Tabellen isolieren; Marker-Files schützen vor ungewolltem Überschreiben.
Der smarte Agenten-Workflow: Doku von KI schreiben lassen
Niemand schreibt gerne hunderte Seiten Dokumentation von Hand. Der eigentliche Clou im Zusammenspiel mit anderen MCP-Tools wie SourceToAI und SqlToAi:
- Explorative Recherche: Ein KI-Agent analysiert mit
SqlToAibestehende Datenbankschemata und mitSourceToAIdie .NET-Codebase. - Iterativer Dialog: Der Agent stellt dem Entwickler oder Fachbereich gezielte Fragen, um Geschäftsregeln und Sonderfälle zu klären.
- Automatische Generierung: Der Agent erstellt die fertig strukturierte Markdown-Dokumentation inklusive YAML-Frontmatter (Titel, Tags, Synonyme) vollautomatisch im Zielordner.
- Import & Bereitstellung: Ein Klick auf
KnowHowToAI import– und das neu gewonnene Firmenwissen steht sofort allen KI-Agenten im Team per MCP zur Verfügung!
In 3 Schritten starten
1. Schreiben Sie Ihre Dokumentation als Markdown-Dateien in einer einfachen Ordnerstruktur (oder lassen Sie diese vom KI-Agenten erstellen):
---
title: Schnittstelle Sage100 Export
tags: [Sage100, SQL, Export]
synonyms: [Finanz-Export, Buchungssatz]
---
# Dokumentation der Schnittstelle...
2. Synchronisieren Sie die Doku per CLI in den MS SQL Server Cache:
KnowHowToAI.Cli.exe import
3. Tragen Sie KnowHowToAI.Cli.exe server als MCP-Server in Claude Desktop oder Cursor ein. Ihre KI greift ab sofort direkt auf Firmenwissen zu!
Repository & Quellcode
KnowHowToAI ist Open Source (MIT-Lizenz) und steht auf GitHub zur Verfügung: