CapaPlanner für Claude
Einrichtung und Nutzung – Stand: 11. Oktober 2026
Was der Connector kann
Der CapaPlanner-Connector ermöglicht es Claude, Ihre CapaPlanner-Planungsdaten zu lesen, damit Sie in natürlicher Sprache Fragen dazu stellen können.
Claude kann Ressourcen (Mitarbeiter), Projekte, Buchungen, Schichten, Aufgaben, Rollen, Vorlagen, Prognosen und Auslastung abrufen. Der Connector ist nur-lesend: Er kann in CapaPlanner nichts erstellen, ändern oder löschen.
Claude sieht nur das, was Ihr eigener CapaPlanner-API-Schlüssel sehen darf. Jede Person meldet sich mit ihrem eigenen Schlüssel an.
Sie benötigen:
- Ein CapaPlanner-Konto mit API-Schlüssel
- Ein Claude-Konto (claude.ai, die Claude-Desktop- oder Mobil-App oder Claude Code)
CapaPlanner mit Claude verbinden
Die Einrichtung dauert etwa zwei Minuten und erfolgt einmalig; Sie bleiben bis zu 30 Tage angemeldet.
In Claude (Web, Desktop oder Mobil):
- Öffnen Sie Claude und gehen Sie zu Anpassen → Connectors.
- Suchen Sie CapaPlanner im Verzeichnis und klicken Sie auf Verbinden. (Solange der Verzeichniseintrag noch nicht live ist: Klicken Sie auf Benutzerdefinierten Connector hinzufügen, geben Sie die URL
https://mcp.capaplanner.com/mcpein und dann Hinzufügen.) - Eine CapaPlanner-Anmeldeseite öffnet sich. Fügen Sie Ihren CapaPlanner-API-Schlüssel ein und klicken Sie auf Verbinden.
- Sie kehren zu Claude zurück, und der Connector wird als verbunden angezeigt.
- Öffnen Sie in einem Chat das Tools-Menü neben dem Eingabefeld und stellen Sie sicher, dass CapaPlanner eingeschaltet ist.
In Claude Code:
- Führen Sie
claude mcp add --transport http capaplanner https://mcp.capaplanner.com/mcpaus - Führen Sie
/mcpaus, wählen Sie capaplanner und melden Sie sich im sich öffnenden Browserfenster mit Ihrem API-Schlüssel an.
Nach 30 Tagen bittet Claude Sie, sich erneut mit Ihrem Schlüssel anzumelden.
Was Sie fragen können
Fragen Sie in Ihren eigenen Worten; Claude wählt die passenden CapaPlanner-Tools aus und kann mehrere kombinieren.
| Thema | Beispielfrage |
|---|---|
| Team | "Liste alle im Software-Team mit ihren Rollen und Wochenstunden auf." |
| Verfügbarkeit | "Wer hat nächste Woche frei?" |
| Schichten | "Zeige die Schichtzuweisungen von Anna Becker in diesem Monat." |
| Auslastung | "Wie ausgelastet ist das Software-Team gerade? Wer ist überbucht?" |
| Projekte | "Gib mir eine Übersicht über alle Projekte und ihren Status." |
| Prognose | "Vergleiche Ist- und Prognosekurven und fasse die Abweichung zusammen." |
| Buchungen | "Welche offenen Buchungsanfragen gibt es, und was benötigen sie?" |
| Vorlagen | "Welche Aufgaben enthält die Vorlage 'Bürogebäude'?" |
Claude bittet Sie um Erlaubnis, bevor es ein Tool verwendet, es sei denn, Sie haben das Tool dauerhaft erlaubt.
Verfügbare Tools
Alle 24 Tools sind nur-lesend.
| Bereich | Tool | Was es liefert |
|---|---|---|
| Ressourcen | get_resources | Alle Ressourcen (Mitarbeiter), die Ihr Schlüssel sehen darf: Kontakt, Typ, Gruppe, Rollen, Verfügbarkeit, vorgeplante Stunden, Stundensatz, Urlaubsanspruch, Abwesenheiten, Ein-/Austrittsdaten |
| Ressourcen | get_resource | Eine Ressource nach ID, gleiche Details |
| Ressourcen | get_shift_assignments | Gespeicherte Schicht- und Präferenzzuweisungen einer Ressource |
| Ressourcen | get_task_based_shift_assignments | Aus Aufgaben (Kalendereinträgen) abgeleitete Schichtzeiträume einer Ressource |
| Ressourcen | get_task_based_assignments | Aus Aufgaben abgeleitete Zeiträume mit Beginn und Ende jeder Schicht |
| Projekte | get_projects | Alle HOAI-Projekte im Arbeitsbereich |
| Projekte | get_project | Ein HOAI-Projekt nach ID |
| Projekte | get_forecast | Prognosevorschläge für eine ID, ein Anfragedatum und ein Planungsdatum |
| Projekte | get_project_types | Für die Planung verfügbare Projekttypen |
| Buchungen | get_bookings | Buchungen (Kundenanfragen für Ressourcen und Zeitfenster), seitenweise, optional nach Status |
| Buchungen | get_booking_file | Die an eine Buchung angehängte Datei: Textdateien als Text, andere als Name, Typ und Größe |
| Analysen | get_dashboard_utilization | Wie ausgelastet Ressourcen sind, optional für eine Gruppe |
| Analysen | get_actual_curve | Ist-Werte (realisierte Werte) im Zeitverlauf |
| Analysen | get_forecast_curve | Erwartete Werte im Zeitverlauf |
| Arbeitsbereich | get_roles / get_role | Rollen (Fähigkeiten wie Design oder Testen), alle oder eine |
| Arbeitsbereich | get_shifts / get_shift | Schichtdefinitionen (z. B. Früh, Spät, Nacht) und ihre Zeiten |
| Arbeitsbereich | get_tasks / get_task | Aufgaben im Arbeitsbereich, alle oder eine |
| Arbeitsbereich | get_templates / get_template | Vorlagen (wiederverwendbare Aufgabenstrukturen für neue Projekte) |
| Arbeitsbereich | get_template_tasks / get_template_task | Die Aufgaben einer Vorlage, alle oder eine |
Berechtigungen, Datenschutz und Trennen der Verbindung
Ihr API-Schlüssel wird mit CapaPlanner geprüft, nur verschlüsselt innerhalb Ihrer Anmeldung gespeichert und niemals an Claude weitergegeben.
- Was Claude sehen kann: genau das, was Ihr API-Schlüssel in CapaPlanner sehen darf, nicht mehr.
- Trennen: Anpassen → Connectors → CapaPlanner → Trennen.
- Zugriff sofort beenden: Deaktivieren oder ersetzen Sie den API-Schlüssel in CapaPlanner. Jede Anfrage nutzt den Schlüssel live, der Zugriff endet also sofort.
Fehlerbehebung
| Problem | Lösung |
|---|---|
| "Diese Zugangsdaten wurden nicht akzeptiert" auf der Anmeldeseite | Prüfen Sie den API-Schlüssel in CapaPlanner und fügen Sie ihn erneut ein, ohne Leerzeichen |
| "Zu viele Anfragen" (429) auf der Anmeldeseite | Warten Sie eine Minute und versuchen Sie es erneut |
| Claude meldet, CapaPlanner habe den Schlüssel abgelehnt oder keinen Zugriff auf die Daten | Der Schlüssel wurde deaktiviert oder hat keine Rechte. Fragen Sie Ihren CapaPlanner-Administrator und verbinden Sie sich dann erneut |
| Claude verwendet CapaPlanner nicht | Schalten Sie den Connector im Tools-Menü des Chats ein oder nennen Sie ihn beim Namen: "Nutze CapaPlanner, …" |
| Erneute Anmeldung erforderlich | Normal nach 30 Tagen oder nach einem Schlüsselwechsel. Melden Sie sich mit Ihrem Schlüssel an |
| "Fehler 404: nicht gefunden" | Die ID existiert nicht oder ist für Ihren Schlüssel nicht sichtbar. Bitten Sie Claude, die Elemente zuerst aufzulisten |
Support
Schreiben Sie an stephan@schottai.com mit Ihrer Frage an Claude, dem Zeitpunkt und einer etwaigen Fehlermeldung. Senden Sie niemals Ihren API-Schlüssel.