Claude-MCP-Connector

Vaia stellt einen Remote-MCP-Endpunkt bereit, damit Mitglieder Claude mit einem persönlichen API-Schlüssel verbinden und dieselben Zeiterfassungs- und Abwesenheitsfunktionen wie der In-App-Assistent nutzen können — mit ihren aktuellen Rollenrechten.

Einrichtung

1. Öffnen Sie in Vaia Claude MCP und erstellen Sie einen API-Schlüssel für die gewünschte Organisation. Kopieren Sie das Secret vaia_mcp_… — es wird nur einmal angezeigt.
2. Fügen Sie in Claude einen benutzerdefinierten Connector (Remote-MCP / Web) hinzu.
3. Geben Sie die Verbindungsdaten unten ein. Wählen Sie keine Anmeldung und setzen Sie den Request-Header.

• Connector-URL:https://api.vaia.space/mcp
• Request-Header-Name:X-API-KEY
• Request-Header-Wert: das rohe Secret vaia_mcp_… (ohne Bearer-Präfix).

Der Organisationskontext steckt im Schlüssel. Legen Sie pro Organisation einen eigenen Schlüssel an, wenn Sie mehreren angehören.

Was Sie tun können

Claude erkennt Tools nach der Verbindung. Verfügbarkeit hängt von aktivierten Modulen und Ihren Berechtigungen ab. Aktionen gelten immer für Sie selbst — nie im Namen anderer.

Zeiterfassung

Timer starten und stoppen, Status prüfen, von heutigem Eintrag fortsetzen, Zeit zusammenfassen, abgeschlossene Einträge anlegen und Timesheets einreichen, wenn ein Projekt das verlangt.

• timer_start
• timer_stop
• timer_status
• timer_resume
• timelog_summary
• timelog_create
• timesheet_weeks_status
• timesheet_submit

Abwesenheit

Kontingente prüfen, Abwesenheit auflisten und beantragen, anstehende genehmigte Abwesenheit sehen, ausstehende Anträge stornieren und genehmigte Abwesenheit verkürzen.

• leave_balance
• leave_request
• leave_requests_list
• leave_upcoming
• leave_request_cancel
• leave_request_shorten

Nicht in diesem Connector: Buchhaltung, Rechnungen, HR, Inventar, Dokumente, Workflows, Organisationsadmin und weitere Module außer Zeiterfassung und Abwesenheit.

Sicherheit

• Behandeln Sie den API-Schlüssel wie ein Passwort. Er wird nur bei der Erstellung angezeigt; bei Verlust neu erstellen und den alten widerrufen.
• Schlüssel gelten nur für den MCP-Endpunkt (/mcp), nicht für gewöhnliche REST-Routen.
• Widerrufen Sie ungenutzte oder kompromittierte Schlüssel. Höchstens fünf aktive Schlüssel pro Mitgliedschaft.
• Prüfen Sie Claudes Tool-Freigaben vor Schreibaktionen (Timer, Abwesenheit, Timesheet).
• Der MCP-Endpunkt ist rate-begrenzt (60 Anfragen pro Minute).

Beispiel-Prompts

• Starte meinen Timer für Projekt X.
• Wie viel Urlaub habe ich dieses Jahr noch?
• Beantrage Urlaub von Montag bis Mittwoch nächster Woche.
• Läuft mein Timer?