fluesta KB — Docs

Was ist das?

Zentrale Wissensbasis von fluesta. Connectoren spiegeln Quellen (knowledge/-Doku, GitHub, Linear, Discord) in eine normalisierte Tabelle; Hybrid-Suche (Volltext + semantisch, RRF, Recency-Decay) macht alles über ein Interface auffindbar. Closed Loop: wer etwas lernt, schreibt es per capture zurück — sofort suchbar für alle.

Für Menschen: Web-UI

Ask	Frage stellen → Planner holt Evidence, Antwort mit Citations
Capture	Learning/Entscheidung in die Inbox schreiben
Admin-Konsole	Nur für Admins: Ingest steuern, API-Keys + Connector-Configs setzen, Knowledge browsen, Inbox reviewen, MCP-Tokens, Users, Aktivität

Login mit Passwort oder Magic-Link. Kein Account? Admin legt ihn in der Admin-Konsole an (Users-Tab).

Für Agents: MCP

Einziger Endpoint (HTTP Streamable Transport):

https://kb.srv.fluesta.eu/mcp

Auth: Authorization: Bearer fluesta_kb_… — jeder Client bekommt einen eigenen Token (Audit + Widerruf pro Client, ADR 0009). Tokens verwaltet ein Admin in der Admin-Konsole → Tokens.

Cursor

{
  "mcpServers": {
    "fluesta-kb": {
      "url": "https://kb.srv.fluesta.eu/mcp",
      "headers": { "Authorization": "Bearer fluesta_kb_..." }
    }
  }
}

Claude Code

claude mcp add --transport http fluesta-kb \
  https://kb.srv.fluesta.eu/mcp \
  --header "Authorization: Bearer fluesta_kb_..."

Andere Harnesses / Chatbots (z.B. hermes)

Jeder MCP-Client mit HTTP-Streamable-Support: URL + Bearer-Header wie oben. Kein Sonderweg — MCP ist das einzige Agent-Interface.

MCP-Tools

Tool	Zweck
`list_sources`	Was ist indexiert, wie aktuell, Embeddings aktiv? Guter Einstieg.
`search`	Hybrid-Suche. Liefert id, source, kind, title, score, snippet, url.
`get_item`	Volltext eines Treffers per id (Snippets sind gekürzt).
`recent`	Neueste Items pro Quelle/Zeitraum — "was hat sich getan?"
`who_knows`	Expert:innen zu einem Thema aus Autorenschaft.
`capture`	Learning/Decision zurückschreiben → Inbox, sofort indexiert.

Regeln für Agents

Erst search, Volltext dann via get_item — keine großen limits ziehen.
capture ist der Closed Loop: Erkenntnisse festhalten. Ein Mensch kuratiert später aus der Inbox.
MCP ist LLM-frei: planen und synthetisieren macht der Client.
Token = Identität. Nicht teilen, nicht committen. Verlust → Dashboard → revoken + neu minten.