MCP-Tools: Ziele, Kennzahlen und Wochenreviews

list_goals

Listet Ziele der Organisation, neueste zuerst; filterbar nach Status und Zeithorizont. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Ziele“ aktiv.

status: Optional · string · active | completed | paused | draft — Nur Ziele mit diesem Status.
horizon: Optional · string · long-term | mid-term | short-term — Nur Ziele mit diesem Zeithorizont.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

get_goal

Liefert ein Ziel anhand seiner ID. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Ziele“ aktiv.

id: Pflicht · string — ID des Ziels.

create_goal

Legt ein Ziel an; du wirst als Ersteller gespeichert. Ohne Angaben startet es mit Horizont mid-term und Status active. Mit parentGoalId hängst du es unter ein übergeordnetes Ziel. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Ziele“ aktiv.

title: Pflicht · string — Titel.
description: Optional · string — Beschreibung als Freitext.
horizon: Optional · string · long-term | mid-term | short-term — Zeithorizont. Standard: mid-term.
status: Optional · string · active | completed | paused | draft — Anfangsstatus. Standard: active.
targetDate: Optional · string — Zieldatum (ISO 8601).
parentGoalId: Optional · string — ID des übergeordneten Ziels.

update_goal

Ändert ein Ziel: Titel, Beschreibung, Status, manuellen Fortschritt (0–100) oder Zieldatum. Nur die übergebenen Felder werden angepasst. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Ziele“ aktiv.

id: Pflicht · string — ID des Ziels.
title: Optional · string — Titel.
description: Optional · string — Beschreibung als Freitext.
status: Optional · string · active | completed | paused | draft — Neuer Status.
manualProgress: Optional · number — Manueller Fortschritt in Prozent (0–100; Werte außerhalb werden auf diesen Bereich begrenzt).
targetDate: Optional · string — Neues Zieldatum (ISO 8601); ein leerer Wert entfernt es.

delete_goal

Löscht ein Ziel. 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 „Ziele“ aktiv.

id: Pflicht · string — ID des Ziels.

list_metrics

Listet die KPI-Kennzahlen der Organisation, neueste zuerst; filterbar nach Status. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Kennzahlen“ aktiv.

status: Optional · string · on-track | at-risk | off-track — Nur Kennzahlen mit diesem Status.
limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).

get_metric

Liefert eine Kennzahl anhand ihrer ID. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, Modul „Kennzahlen“ aktiv.

id: Pflicht · string — ID der Kennzahl.

create_metric

Legt eine KPI-Kennzahl an. Name und Zielwert sind Pflicht; ohne Angaben startet sie mit Istwert 0 und Status on-track. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Kennzahlen“ aktiv.

name: Pflicht · string — Name der Kennzahl.
description: Optional · string — Beschreibung als Freitext.
unit: Optional · string — Einheit, z. B. %, Nutzer, €.
targetValue: Pflicht · number — Zielwert der Kennzahl.
currentValue: Optional · number — Aktueller Wert der Kennzahl.
status: Optional · string · on-track | at-risk | off-track — Anfangsstatus. Standard: on-track.

update_metric

Aktualisiert eine Kennzahl – typischerweise den Istwert oder den Status. Auch Zielwert, Name und Beschreibung sind änderbar; die Einheit nicht. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, Modul „Kennzahlen“ aktiv.

id: Pflicht · string — ID der Kennzahl.
currentValue: Optional · number — Aktueller Wert der Kennzahl.
targetValue: Optional · number — Zielwert der Kennzahl.
status: Optional · string · on-track | at-risk | off-track — Neuer Status.
name: Optional · string — Neuer Name der Kennzahl.
description: Optional · string — Beschreibung als Freitext.

delete_metric

Löscht eine Kennzahl 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 „Kennzahlen“ aktiv.

id: Pflicht · string — ID der Kennzahl.

list_reviews

Listet Wochenreviews der Organisation, nach Wochenbeginn absteigend. Dieses Tool hat keinen Modul-Schalter und steht immer zur Verfügung. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, kein Modul-Schalter (immer verfügbar).

limit: Optional · number — Maximale Anzahl Ergebnisse (Standard 20, höchstens 100).

get_review

Liefert ein einzelnes Wochenreview anhand seiner ID. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, kein Modul-Schalter (immer verfügbar).

id: Pflicht · string — ID des Reviews.

create_review

Legt ein Wochenreview an; nur der Wochenbeginn (Montag) ist Pflicht. Du wirst als Ersteller gespeichert. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, kein Modul-Schalter (immer verfügbar).

weekStart: Pflicht · string — Montag der Woche (ISO 8601).
wentWell: Optional · string — Was gut lief.
didntGoWell: Optional · string — Was nicht gut lief.
focusNextWeek: Optional · string — Fokus für die kommende Woche.
highlights: Optional · string — Highlights der Woche.
mood: Optional · number — Stimmung von 1 bis 5.

update_review

Ändert Felder eines Wochenreviews (was gut lief, was nicht, Fokus, Highlights, Stimmung); nur die übergebenen Felder werden angepasst. Der Wochenbeginn lässt sich nicht ändern. Voraussetzungen: Rolle Member oder höher, Schlüssel-Scope „write“ oder höher, kein Modul-Schalter (immer verfügbar).

id: Pflicht · string — ID des Reviews.
wentWell: Optional · string — Was gut lief.
didntGoWell: Optional · string — Was nicht gut lief.
focusNextWeek: Optional · string — Fokus für die kommende Woche.
highlights: Optional · string — Highlights der Woche.
mood: Optional · number — Stimmung von 1 bis 5.

delete_review

Löscht ein Wochenreview 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, kein Modul-Schalter (immer verfügbar).

id: Pflicht · string — ID des Reviews.

Häufige Stolperfallen

Fortschritt wird begrenzt
update_goal begrenzt manualProgress auf 0 bis 100.
Einheit lässt sich nicht ändern
Die Einheit einer Kennzahl legst du mit create_metric fest; update_metric kann sie nicht ändern.
Wochenbeginn ist fix
Der Wochenbeginn eines Wochenreviews lässt sich nach dem Anlegen nicht mehr ändern; lege im Zweifel ein neues an.