MCP-Schnittstelle: Was Claude und andere KI-Clients in deinem Workspace tun können

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Clients Werkzeuge einer Anwendung aufrufen. Der Server von Project Manager heißt project-manager (Version 1.0.0), ist unter dem Pfad /api/mcp deiner Instanz erreichbar und spricht JSON-RPC 2.0 über HTTP (Protokollversion 2024-11-05). Er stellt ausschließlich Tools bereit, keine Ressourcen und keine Prompts. Die KI entscheidet anhand deiner Frage, welches Tool sie mit welchen Argumenten aufruft; das Ergebnis kommt als formatiertes JSON zurück.

Insgesamt gibt es 114 Tools: 55 lesende (scope read), 42 schreibende (scope write) und 17 löschende (scope delete). Jeder Bereich hat einen eigenen Artikel, in dem jedes Tool mit Parametern, Rollen und Besonderheiten beschrieben ist. Die Gesamtliste mit allen Voraussetzungen steht im Tool-Katalog.

Organisation, Mitglieder und Analytics

4 Tools – Organisationen und Zugehörigkeit, aktivierte Module, Teammitglieder, Web-Analytics (PostHog/GA4).

Aufgaben, Projekte und Meilensteine

17 Tools – Aufgaben (inklusive KI-Aufwandsschätzung und Ähnlichkeitssuche), Projekte und Meilensteine.

Sprints und Wochenplanung

10 Tools – Sprints mit Soll/Ist, KI-Sprintvorschlag, Wochenplanung und Auslastung.

Zeiterfassung und Kalender

9 Tools – Zeiteinträge und Timer, Google-Calendar-Termine, gemeinsame freie Zeitfenster im Team.

CRM, Lead-Engine und Netzwerk

17 Tools – Leads und Aktivitäten, Lead-Engine-Dashboard und Wochenbriefing, E-Mail-Entwürfe, Netzwerk-Kontakte.

Rechnungen und Buchhaltung

10 Tools – Rechnungen inklusive Finalisierung und Korrektur, Belege, Einnahmenübersicht.

Budgeting

13 Tools – Projektbudgets, Retainer, Burn-Rate-Prognose, Ausgaben und Stundensätze.

Wissen, Notizen, Meetings und Dateien

19 Tools – Knowledgebase mit semantischer Suche, Notizen, Meeting-Notizen, Datei-Metadaten.

Ziele, Kennzahlen und Wochenreviews

15 Tools – Ziele, KPI-Kennzahlen und Wochenreviews.

Die folgenden Beispiele zeigen, wie Aufträge an die KI in Tool-Aufrufe übersetzt werden. Du formulierst in normaler Sprache; die genannten Tools ruft der Client selbst auf.

Aufgaben

„Lege im Projekt Relaunch die Aufgabe ‚Angebot prüfen‘ mit hoher Priorität an und weise sie Anna zu.“ – list_projects, list_members, create_task.

Zeit erfassen

„Starte einen Timer für die Aufgabe X“ bzw. „Beende meinen Timer.“ – create_time_entry, stop_timer.

Planung

„Stelle mir einen Sprint aus dem Backlog zusammen und übernimm den Vorschlag.“ – create_sprint, suggest_sprint_plan, add_task_to_sprint.

Vertrieb

„Welche Leads sind überfällig? Bereite zu den drei wichtigsten einen E-Mail-Entwurf vor.“ – list_crm_leads, get_crm_lead, create_crm_email_draft. Versendet wird von einem Menschen im CRM.

Abrechnung

„Erstelle einen Rechnungsentwurf aus den freigegebenen Zeiten des Projekts.“ – list_time_entries, create_invoice.

Finanzen

„Wie ist der Budgetstand aller Projekte und wann ist das Budget des Projekts Y verbraucht?“ – list_budget_overview, get_budget_forecast.

Wissen

„Suche in der Knowledgebase nach unserem Onboarding-Prozess und fasse ihn zusammen.“ – search_kb, get_kb_item.

Auswertung

„Wie haben sich Seitenaufrufe und Registrierungen in den letzten 30 Tagen entwickelt?“ – get_analytics.

Der Client spricht den Server über einfache JSON-RPC-Anfragen an. Unterstützt werden diese Methoden:

initialize

Handshake; der Server meldet Name, Version, Protokollversion und dass er Tools anbietet.

ping

Erreichbarkeitsprüfung; leere Antwort.

tools/list

Liefert die für dich verfügbaren Tools mit Beschreibung und Parameter-Schema. Bei kontoweiten Schlüsseln ohne Organisations-Header werden alle Tools mit zusätzlichem Parameter organization gelistet.

tools/call

Ruft ein Tool mit Argumenten auf. Der Server prüft Organisation, Rolle, Scope und Modul und liefert das Ergebnis als JSON-Text – oder einen JSON-RPC-Fehler mit Meldung.

notifications/*

Benachrichtigungen des Clients werden angenommen und nicht beantwortet.

1. Der Client authentifiziert sich mit einem Bearer-Token (OAuth-Zugriffstoken oder Zugriffsschlüssel).
2. Der Client lädt mit tools/list die Tools; nicht erlaubte Tools fehlen.
3. Die KI wählt ein Tool und ruft es mit tools/call auf.
4. Der Server führt die Aktion in deiner Organisation aus und antwortet mit dem Ergebnis.

Einige Aktionen bietet der Server nicht an. Sie bleiben Nutzeraktionen in der Webapp.

E-Mails versenden

Über MCP entstehen nur Entwürfe (create_crm_email_draft). Absenden bleibt ein Klick eines Menschen im CRM.

Rechnung als bezahlt setzen

update_invoice lehnt den Status paid ab; eine Zahlung wird stattdessen erfasst.

Ausgestellte Rechnung ändern

Nach der Finalisierung ist nur der Status änderbar. Korrekturen laufen über create_invoice_correction; Positionen lassen sich per MCP nachträglich nicht bearbeiten.

Dateiinhalte

Dateien sind nur als Metadaten abrufbar (list_files, list_file_folders); Hoch- und Herunterladen läuft über die Webapp oder WebDAV.

Belege hochladen

Buchhaltungsbelege lassen sich per MCP auflisten, ändern und löschen, nicht hochladen.

Kalendertermine ändern

Google-Calendar-Termine lassen sich lesen und anlegen, nicht ändern oder löschen.

Weitere Module

Für Chat, Vault, CMS sowie Organisations-, Rollen-, Mitglieder- und Abo-Verwaltung gibt es keine MCP-Tools.

Fremde Zeiteinträge

Zeiteinträge und Timer beziehen sich immer auf den Inhaber des Zugangs.

Alle Aktionen laufen im Namen des Zugangsinhabers und mit dessen Rechten. Rechnungsaktionen (Anlegen, Finalisieren, Statuswechsel, Korrektur) und das Löschen von Buchhaltungsbelegen werden im Audit-Log mit dem Akteurtyp „mcp“ festgehalten. Von KI erzeugte Ergebnisse sind gekennzeichnet: E-Mail-Entwürfe tragen die Markierung „KI-generiert“, das Wochenbriefing liefert aiGenerated, und die Aufwandsschätzung sowie der Sprintvorschlag sind als KI-Ergebnis zu behandeln. Prüfe solche Ergebnisse, bevor du sie übernimmst.