# Claude-MCP-Connector

> Claude mit Vaia verbinden: Einrichtung, verfügbare Tools für Zeiterfassung und Abwesenheit sowie Sicherheitsgrundlagen.

Öffentliche Docs

Kuratierter öffentlicher Leitfaden — nicht die vollständige private API-Dokumentation.

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](https://app.vaia.space/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?

Machen Sie den nächsten Schritt

## Gutes beginnt gemeinsam.

Bringen Sie Ihr Team als eines der ersten zu Vaia.

---

Canonical: https://vaia.space/de/public/claude-mcp
Index: https://vaia.space/llms.txt