Für Entwickler
Selbst hosten
Klone das Repository, starte kiwiki mit Docker und verbinde deinen ersten MCP-Client.
Auf GitHub installieren →Self-hosted, Markdown-nativ und mit Claude Code, Cursor, Codex, ChatGPT und anderen MCP-Clients nutzbar. Deine Agenten greifen auf denselben aktuellen Wissensstand zu, während deine Dateien unter deiner Kontrolle bleiben.
docker compose up -d, läuft in Sekunden
Dein Einstieg
kiwiki ist Open Source. Starte selbst oder hole dir Unterstützung beim Betrieb.
Für Entwickler
Klone das Repository, starte kiwiki mit Docker und verbinde deinen ersten MCP-Client.
Auf GitHub installieren →Für Teams
Halte Projektnotizen, Entscheidungen und Agentenwissen an einem Ort zusammen – mit Namespaces und Rollen.
Team-Funktionen ansehen →Für Betriebe
Lass Installation, HTTPS-Konfiguration, Backups und laufenden Betrieb von conbro.de übernehmen.
Installation & Hosting anfragen →Screenshot
Self-hosted, browser-basiert und responsive, vom 4K-Desktop bis zum Smartphone. Kein App-Store, kein Client-Install.
Startseite mit Dateibaum, Volltextsuche und MCP-Verbindungsdaten. Die Ansicht wechselt automatisch zwischen Desktop- und Mobile-Layout. Ein App-Install ist nicht nötig.
Eine Notiz im Lesemodus, Pfad, Änderungsdatum, Autor und Tags kommen direkt aus dem YAML-Frontmatter der Markdown-Datei. Tags sind klickbar und starten eine tag:-Suche.
Die Weboberfläche ist vollständig per Tastatur bedienbar, mit Vim-artigen Kürzeln für die häufigsten Aktionen.
Doppel-Kürzel werden innerhalb von 600 ms erkannt. Tab führt zuerst auf den Skip-Link, danach durch Header, Seitenleiste und Inhalt.
Features
kiwiki ist kein weiteres Cloud-Wiki. Es ist die Wissensbasis, die deine KI-Agenten direkt lesen und schreiben können.
Zentrale Wissensbasis für alle deine KI-Agenten. Claude Code, Codex, OpenCode, Cursor & Co. lesen und schreiben parallel, über das MCP-Protokoll.
SQLite FTS5 durchsucht tausende Markdown-Dateien in Millisekunden, auch via MCP aus der KI heraus.
Isolierte Namespaces pro Benutzer mit Rollen (Read / Write / Admin). Perfekt für Teams und Organisationen.
YAML-Frontmatter, verschachtelte Ordner, automatische Indizes, dein Dateisystem bleibt die Quelle der Wahrheit.
Ein Befehl, und kiwiki läuft. Inklusive Helm-Chart für Kubernetes-Deployments, keine Cloud-Abhängigkeit.
Self-Hosted auf deiner Infrastruktur. Kein Vendor Lock-In, keine Telemetrie, keine Cloud-Pflicht.
Ein deterministischer Index leitet Entitäten, Beziehungen und Link-Herkunft aus deinen Notizen ab, ohne eine einzige Markdown-Datei umzuschreiben. Optional zuschaltbar.
Health-Probes, Request-IDs, Rate-Limit-Stufen, Speicher-Quotas, gehashte Sessions und OAuth 2.1 mit PKCE, abgesichert durch CI-Gates und Browser-Regressionstests.
Die gesamte Weboberfläche spricht Deutsch und Englisch, Seiten, Dialoge, Toasts, Editor und Benutzerverwaltung aus einem gemeinsamen Katalog.
Neuronaler Atlas
kiwiki zeichnet deine Notizen, Tags und Verknüpfungen als begehbaren Wissensraum, vollständig selbst gehostet, ohne dass ein einziger Knoten an Dritte übertragen wird.
Jede Kante stammt aus einem echten Markdown-Link oder einer abgeleiteten Relation. Ein Klick auf einen Knoten zeigt die Quellnotiz.
Ziehen dreht den Raum, Mausrad und Pinch zoomen, W/A/S/D bewegt dich hindurch. Auf Wunsch komplett bewegungsreduziert.
Sieben MCP-Tools öffnen denselben Graph für Agenten, Suche, Entitäts-Details, Nachbarschaft, Zeitachse und Beziehungserklärung.
Optional zuschaltbar per KIWIKI_KNOWLEDGE_ENABLED=true, bestehende Installationen werden im Betrieb nachgezogen, Notizen bleiben unverändert.
Workflow
Von der ersten Notiz bis zur KI-Integration vergehen Minuten.
Erstelle Markdown-Notizen mit YAML-Frontmatter, im Browser, per MCP oder direkt im Dateisystem.
---
title: Meine Notiz
tags: [kiwiki, ai]
---
# Hallo kiwiki
Füge kiwiki als MCP-Server in Claude Code, Cursor oder jeden MCP-Client ein.
claude mcp add kiwiki \
http://localhost:8082/mcp \
--header "Authorization: Bearer $KEY"
Deine KI liest und schreibt direkt in dein Wiki, sucht Notizen, erstellt Zusammenfassungen, organisiert Wissen.
# KI: "Durchsuche meine Notizen nach …"
# kiwiki: "read_file", "search", "grep"
# KI: "Fasse die Ergebnisse zusammen."
Warum kiwiki?
Deine Daten bleiben auf deinem Server. Keine Cloud, kein Vendor-Lock-In, keine Kompromisse.
MCP-Protokoll mit 56 Tools, entwickelt als gemeinsame Wissensbasis für Claude Code, Codex, OpenCode, Cursor, ChatGPT, OpenClaw, Hermes und alle MCP-kompatiblen Agenten.
Reine Markdown-Dateien im Dateisystem. Keine proprietäre Datenbank, kein Vendor-Lock-In, einfach backupbar.
Docker Compose, Helm Chart, oder Dev-Server, wähle deine Deployment-Strategie.
SQLite FTS5 durchsucht dein gesamtes Wiki in Millisekunden, auch direkt aus der KI heraus.
Isolierte Wikis pro Benutzer mit feingranularen Rollen. Perfekt für Teams.
MCP-Integration
Das Model Context Protocol gibt KI-Agenten vollen Zugriff auf dein Wiki, mit fein abgestuften Berechtigungen.
read_file readread_many readread_lines readfetch readsearch readgrep readfind readlist_files readlist_all_files readbacklinks readrelated_files readlink_graph read… und 18 weitere Lese-Tools
write_file writewrite_many writechunked_write writeedit writeappend_file writecreate_note writeupsert_note writeupdate_frontmatter writereplace_many writebatch_tag writemove_file writerename write… und 6 weitere Schreib-Tools
knowledge_search readentity_details readentity_neighbors readfact_timeline readexplain_relation readknowledge_status readknowledge_reindex adminOptional, aktiv bei eingeschalteter Knowledge Engine
delete_file adminPOST /mcp
GET /mcp/sse
Alles, was Agenten über MCP tun, geht auch per HTTP, mit demselben API-Key als Bearer-Token und demselben Namespace pro Benutzer. Für Skripte, CI-Jobs und eigene Oberflächen.
GET /api/search Volltextsuche über FTS5GET /api/files Dateien auflisten, rekursivGET /api/file Notiz mit Frontmatter lesenPOST /api/note Notiz anlegen oder ersetzenPATCH /api/file/frontmatter Einzelne Felder mergen, ohne den Rest anzufassenGET /api/knowledge/graph Wissensgraph als JSON abholenDazu /livez und /readyz für Health-Checks in Docker, Compose und Kubernetes.
Deine gesamte KI-Agenten-Flotte teilt sich eine gemeinsame Wissensbasis. Jeder Agent liest und schreibt, isoliert pro Benutzer, konsistent im Zugriff.
kiwiki
Jeder Agent verbindet sich via MCP, claude mcp add kiwiki, codex mcp add kiwiki, und so weiter. Alle teilen sich denselben Markdown-Wissensspeicher, jeder in seinem eigenen Namespace.
Dienstleistung
IT-Beratung Sebastian Broers übernimmt Installation, Hosting und laufende Wartung für deine kiwiki-Instanz. Komplett betreut, sicher betrieben, ohne dass du dich um Server, Backups oder Updates kümmern musst.
Erstsetup auf deinem Wunsch-Server (Hetzner, IONOS, Netcup, NAS oder heimischer Hardware), inklusive HTTPS, API-Key und MCP-Endpunkt.
Laufender Betrieb mit automatischen Updates, nächtlichen Backups, Monitoring und proaktivem Troubleshooting.
Architektur-Beratung, Reverse-Proxy-Konfiguration, Auth-Modelle, Backup-Strategie. Auch ohne Full-Service-Paket.
Kostenpflichtige Dienstleistung, bereitgestellt über conbro.de.
FAQ
kiwiki ist ein persönliches Wiki, das als MCP-Server für KI-Tools fungiert. Deine Notizen werden als einfache Markdown-Dateien gespeichert, und sind gleichzeitig über das Model Context Protocol (MCP) für Claude Code, Cursor und andere KI-Clients les- und schreibbar.
Nein. kiwiki ist komplett self-hosted. Keine Cloud-Abhängigkeit, keine Telemetrie, kein Vendor-Lock-In. Du betreibst es auf deinem eigenen Server, deinem NAS oder lokal mit Docker.
Alle Clients, die das Model Context Protocol (MCP) unterstützen, darunter Claude Code, Codex, Cursor, OpenCode, ChatGPT und jede benutzerdefinierte MCP-Integration. kiwiki unterstützt sowohl Streamable HTTP als auch HTTP+SSE, dazu OAuth 2.1 mit PKCE für Connector-basierte Clients wie ChatGPT.
Per Docker Compose: Projekt klonen, docker compose up -d ausführen, fertig. Für Kubernetes gibt es ein Helm-Chart. Für die Entwicklung reicht pip install -r requirements.txt && uvicorn app.main:app.
Ja. kiwiki unterstützt mehrere Benutzer mit isolierten Namespaces und Rollen (Read / Write / Admin). Jeder Benutzer hat sein eigenes Wiki-Verzeichnis und sieht nur seine eigenen Dateien.
Ja. Seit Version 3 bringt kiwiki Health-Probes (/livez, /readyz), Request-Korrelations-IDs, getrennte Rate-Limit-Stufen für Login, OAuth, UI, Lese- und Schreibzugriffe sowie Datei- und Byte-Quotas pro Benutzer mit. Sessions werden gehasht gespeichert und bei Rollenänderungen widerrufen, Schreibzugriffe sind atomar und konfliktsicher. Jeder Release durchläuft CI-Gates für Linting, Testabdeckung, Dependency-Audits und Browser-Regressionstests.
Ein Agent Harness ist eine zentrale Infrastruktur, an die sich mehrere KI-Agenten gleichzeitig anschließen können. kiwiki fungiert als genau dieser Harness: Claude Code, Codex, OpenCode, Cursor, ChatGPT, OpenClaw, Hermes Agents und alle anderen MCP-kompatiblen Agenten können parallel auf dasselbe Wissensrepository zugreifen, lesend, schreibend, durchsuchend. Jeder Agent arbeitet im ihm zugewiesenen Benutzer-Namespace, aber die Wissensbasis ist zentral und konsistent.
Der Neuronale Atlas unter /knowledge zeigt deine Notizen, Tags und Verknüpfungen als räumlichen Wissensgraph. Die zugrundeliegende Knowledge Engine leitet Entitäten und Beziehungen deterministisch aus deinen Markdown-Dateien ab und legt sie in einem separaten SQLite-Index pro Benutzer ab. Deine Notizen selbst werden nie umgeschrieben. Der Graph wird lokal gerendert, es verlassen keine Daten deinen Server.
Nein, sie ist optional und standardmäßig aus. Mit KIWIKI_KNOWLEDGE_ENABLED=true und einem Neustart baut kiwiki den Index im laufenden Betrieb in begrenzten Stapeln auf; bestehende Installationen werden dabei nicht migriert. Du kannst die Engine jederzeit wieder abschalten. Notizen und Volltextsuche bleiben davon unberührt.
Kontakt
kiwiki ist Open Source. Wir freuen uns über Issues, Pull Requests und Feedback auf GitHub.
Klone das Repository und starte kiwiki in Sekunden.
git clone https://github.com/natorus87/kiwiki.git
cd kiwiki && docker compose up -d