MCP-Tools: Wissen, Notizen, Meetings und Dateien

list_kb_items

Listet Knowledgebase-Artikel (ID, Slug, Titel, Kategorie, letzte Änderung – ohne Inhalt), zuletzt geänderte zuerst. Mit folder filterst du nach einem Ordner: „engineering“ liefert alle Artikel, deren Slug mit „engineering/“ beginnt. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Knowledgebase“ aktiv.

category: Optional · string — Nur Artikel dieser Kategorie.
folder: Optional · string — Ordnerpfad, z. B. „engineering“ oder „engineering/backend“.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

get_kb_item

Liefert einen Knowledgebase-Artikel mit vollem Inhalt – über id oder slug. Ohne beides kommt der Fehler „Provide id or slug“. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Knowledgebase“ aktiv.

id: Optional · string — Artikel-ID.
slug: Optional · string — Artikel-Slug (Alternative zur ID).

search_kb

Semantische Suche über alle Artikel der Knowledgebase – nutze sie, um passende Artikel zu finden, bevor du Fragen beantwortest. Fällt die Vektorsuche aus oder findet nichts, greift eine Textsuche in Titel und Inhalt. Die Felder der Vektortreffer können von der Textsuche abweichen; die Textsuche liefert ID, Slug, Titel, Kategorie und letzte Änderung. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Knowledgebase“ aktiv.

query: Pflicht · string — Suchanfrage.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 5, höchstens 20).

create_kb_item

Legt einen Knowledgebase-Artikel an. Der Slug wird ohne Angabe aus dem Titel plus Zeitstempel erzeugt; mit folder landet der Artikel in einem Ordner (folder="engineering" ergibt „engineering/artikel-titel“). Der Suchindex (Embedding) wird im Hintergrund erzeugt. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Knowledgebase“ aktiv.

title: Pflicht · string — Titel.
slug: Optional · string — URL-sicherer Slug. Ohne Angabe: aus Titel und Zeitstempel erzeugt.
folder: Optional · string — Ordnerpfad, in dem der Artikel angelegt wird; er wird dem Slug vorangestellt.
bodyMd: Pflicht · string — Inhalt des Artikels als Markdown.
category: Optional · string — Kategorie als Freitext.

update_kb_item

Ändert einen Artikel. Mit folder verschiebst du ihn in einen anderen Ordner, mit slug benennst du den Slug-Basisnamen um. Bei geänderten Titel oder Inhalt wird der Suchindex im Hintergrund neu erzeugt. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Knowledgebase“ aktiv.

id: Pflicht · string — ID des Artikels.
title: Optional · string — Titel.
slug: Optional · string — Neuer Slug-Basisname (ohne Ordner) – nur das letzte Segment, nicht der ganze Pfad.
folder: Optional · string — Zielordner, z. B. „engineering“. Ein leerer String verschiebt den Artikel auf die oberste Ebene.
bodyMd: Optional · string — Inhalt des Artikels als Markdown.
category: Optional · string — Kategorie als Freitext.

delete_kb_item

Löscht einen Knowledgebase-Artikel. Erfordert mindestens die Rolle Admin und einen Schlüssel mit delete-Scope. Voraussetzungen: Rolle Admin oder höher, Schlüssel-Scope „delete“ oder höher, Modul „Knowledgebase“ aktiv.

id: Pflicht · string — ID des Artikels.

list_notes

Listet Notizen (ID, Titel, Farbe, angeheftet, letzte Änderung – ohne Inhalt), zuletzt geänderte zuerst; filterbar nach angeheftet. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Notizen“ aktiv.

pinned: Optional · boolean — Nur angeheftete (true) bzw. nicht angeheftete (false) Notizen.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

get_note

Liefert eine Notiz mit vollem Inhalt. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Notizen“ aktiv.

id: Pflicht · string — ID der Notiz.

create_note

Legt eine Notiz an; alle Felder sind optional (Titel ohne Angabe: „Untitled“). Du wirst als Ersteller gespeichert. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Notizen“ aktiv.

title: Optional · string — Titel.
content: Optional · string — Inhalt der Notiz (Text oder Markdown).
color: Optional · string — Farblabel: default, yellow, green, blue, red oder purple.
pinned: Optional · boolean — Heftet die Notiz an.

update_note

Ändert Titel, Inhalt, Farbe oder Anheftung einer Notiz; nur die übergebenen Felder werden angepasst. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Notizen“ aktiv.

id: Pflicht · string — ID der Notiz.
title: Optional · string — Titel.
content: Optional · string — Neuer Inhalt der Notiz.
color: Optional · string — Neues Farblabel.
pinned: Optional · boolean — Heftet die Notiz an.

delete_note

Löscht eine Notiz. Erfordert mindestens die Rolle Admin und einen Schlüssel mit delete-Scope. Voraussetzungen: Rolle Admin oder höher, Schlüssel-Scope „delete“ oder höher, Modul „Notizen“ aktiv.

id: Pflicht · string — ID der Notiz.

list_meetings

Listet Meeting-Notizen (ID, Titel, Thema, Datum, Teilnehmende, Ordner, Zusammenfassung, Erstellungszeit – ohne Notizen und Transkript), neueste zuerst; filterbar nach Ordner. Gehört zum Modul Meetings. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Meetings“ aktiv.

folderId: Optional · string — Nur Meetings aus diesem Ordner.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

get_meeting

Liefert eine Meeting-Notiz mit vollem Inhalt, Notizen, Transkript und Aktionspunkten. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Meetings“ aktiv.

id: Pflicht · string — ID des Meetings.

create_meeting

Legt eine Meeting-Notiz an. Titel und Datum sind Pflicht. Das Datum sollte einen UTC-Offset oder Z enthalten. Notizen, Zusammenfassung und Aktionspunkte lassen sich direkt mitgeben. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Meetings“ aktiv.

title: Pflicht · string — Titel.
topic: Optional · string — Thema des Meetings.
date: Pflicht · string — Datum und Uhrzeit des Meetings (ISO 8601, mit UTC-Offset oder Z).
durationMin: Optional · number — Dauer in Minuten.
attendees: Optional · string — Teilnehmende als Freitext.
notes: Optional · string — Meeting-Notizen als Markdown.
transcript: Optional · string — Transkript des Meetings.
summary: Optional · string — Zusammenfassung des Meetings.
actionItems: Optional · object[] — Aktionspunkte als Liste von Objekten mit text (Text) und done (erledigt, true/false).
color: Optional · string — Farbmarkierung des Meetings.
isOnline: Optional · boolean — Markiert das Meeting als Online-Meeting.
folderId: Optional · string — ID des Ordners, in den das Meeting kommt (siehe list_meeting_folders).

update_meeting

Ändert Titel, Notizen, Zusammenfassung oder Aktionspunkte einer Meeting-Notiz. Über dieses Tool lassen sich Datum, Thema, Teilnehmende, Ordner oder Transkript nicht ändern. Übergibst du actionItems, ersetzt die neue Liste die bisherige vollständig. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Meetings“ aktiv.

id: Pflicht · string — ID des Meetings.
title: Optional · string — Titel.
notes: Optional · string — Neue Meeting-Notizen als Markdown.
summary: Optional · string — Zusammenfassung des Meetings.
actionItems: Optional · object[] — Aktionspunkte als Liste von Objekten mit text (Text) und done (erledigt, true/false).

delete_meeting

Löscht eine Meeting-Notiz dauerhaft. Erfordert mindestens die Rolle Admin und einen Schlüssel mit delete-Scope. Voraussetzungen: Rolle Admin oder höher, Schlüssel-Scope „delete“ oder höher, Modul „Meetings“ aktiv.

id: Pflicht · string — ID des Meetings.

list_meeting_folders

Listet die Meeting-Ordner der Organisation – die IDs brauchst du für folderId bei list_meetings und create_meeting. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Meetings“ aktiv. Dieses Tool hat keine Parameter.

list_files

Listet Dateien der Organisation (ID, Name, MIME-Typ, Größe in Bytes, Ordner, Stern, Erstellungszeit), neueste zuerst; gelöschte Dateien erscheinen nicht. Ohne folderId wird nicht nach Ordnern gefiltert; nur ein ausdrücklich gesendetes null liefert ausschließlich Dateien der obersten Ebene. Das Tool liefert Metadaten, keine Dateiinhalte. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Dateien“ aktiv.

folderId: Optional · string — Nur Dateien dieses Ordners. Ein ausdrücklich gesendetes null liefert nur Dateien der obersten Ebene.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

list_file_folders

Listet Dateiordner der Organisation (ohne versteckte Ordner): ohne parentFolderId die Ordner der obersten Ebene, sonst die Unterordner des angegebenen Ordners. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Dateien“ aktiv.

parentFolderId: Optional · string — Nur Unterordner dieses Ordners. Ohne Angabe: Ordner der obersten Ebene.

Häufige Stolperfallen

Dateien nur als Metadaten
list_files und list_file_folders liefern keine Inhalte. Ohne folderId filtert list_files nicht nach Ordnern; nur ein ausdrücklich gesendetes null liefert Dateien der obersten Ebene.
Ordner sind Slug-Präfixe
In der Knowledgebase entspricht ein Ordner dem Slug-Präfix (engineering/…). update_kb_item mit folder verschiebt den Artikel; ein leerer String verschiebt ihn auf die oberste Ebene.
Meeting-Modul heißt intern Reviews
Die Meeting-Tools gehören zum Modul „Meetings“ und sind unabhängig von den Wochenreviews (Ziele-und-Kennzahlen-Artikel).
Aktionspunkte werden ersetzt
update_meeting mit actionItems ersetzt die gesamte Liste. Lies den Stand zuerst mit get_meeting und sende die vollständige Liste zurück.