Valoon für Claude

Überblick

Der Connector gibt Claude über das Model Context Protocol Zugriff auf Ihre Valoon-Projekte. Claude sieht nur, was auch Ihr eigenes Valoon-Konto sehen darf, und jede Änderung erfolgt mit Ihrem Konto.

Typische Anwendungen sind eine Zusammenfassung der Baustellenwoche, das Anlegen von Aufgaben aus Baustellennotizen, der Entwurf des Bautagesberichts aus Baustellenfotos und Notizen sowie die Prüfung erfasster Stunden vor der Lohnabrechnung.

Voraussetzungen

• Ein Valoon-Konto mit Zugriff auf die Projekte, mit denen Sie arbeiten möchten.
• Ein Valoon-API-Schlüssel. Seine Client ID und sein Secret finden Sie unter Valoon → Einstellungen → API-Schlüssel.
• Ein Claude-Tarif, der benutzerdefinierte Connectors unterstützt.
• Bei Team- und Enterprise-Tarifen muss eine Inhaberin oder ein Inhaber benutzerdefinierte Connectors gegebenenfalls unter Organisationseinstellungen → Connectors freigeben.

Valoon mit Claude verbinden

Claude.ai und Claude Desktop

1. Öffnen Sie Einstellungen → Connectors und wählen Sie Benutzerdefinierten Connector hinzufügen.
2. Geben Sie Valoon als Namen ein und fügen Sie die Connector-URL ein: https://dev.mcp.valoon.crucerlabs.com/mcp
3. Wählen Sie Verbinden. Die Autorisierungsseite von Valoon öffnet sich.
4. Geben Sie Client ID und Secret Ihres Valoon-API-Schlüssels ein und wählen Sie Zugriff autorisieren.
5. Aktivieren Sie anschließend in Claude über das Werkzeugmenü die Valoon-Werkzeuge, die Sie in der Unterhaltung nutzen möchten.

Claude Code

Fügen Sie den Server im Terminal hinzu:

claude mcp add --transport http valoon https://dev.mcp.valoon.crucerlabs.com/mcp

Führen Sie dann in Claude Code /mcp aus, wählen Sie Valoon und authentifizieren Sie sich. Ihr Browser öffnet dieselbe Autorisierungsseite. Sobald Sie den Zugriff autorisiert haben, erscheint Valoon als connected.

Berechtigungen und Daten

Jedes Werkzeug trägt eine von drei Kennzeichnungen, und der Server teilt sie Claude mit jedem Werkzeug mit, sodass Claude lesende von ändernden Werkzeugen unterscheiden kann. Je nach Ihren Claude-Einstellungen fragt Claude vor dem Ausführen eines Werkzeugs nach einer Bestätigung.

Nachrichten erreichen echte Menschen

Werkzeuge mit der Kennzeichnung Sendet Nachrichten schreiben in Ihrem Namen an die Beteiligten der Aufgabe, und eine gesendete Nachricht lässt sich nicht zurückholen. Prüfen Sie, welche Aufgaben Claude senden möchte, bevor Sie bestätigen. Auch das Anlegen oder Ändern von Projekten und Aufgaben löst dieselben Benachrichtigungen aus wie die Valoon-App.

Sie melden sich mit Ihrem Valoon-API-Schlüssel an. Client ID und Secret werden gegen die Valoon-API geprüft und niemals auf dem Server gespeichert. Claude erhält ein Zugriffstoken, das eine Stunde gültig ist und mit einem Aktualisierungstoken erneuert wird, das 30 Tage gültig ist und bei jeder Verwendung ersetzt wird.

Claude erhält nur die Ergebnisse der aufgerufenen Werkzeuge. Für den Betrieb protokolliert der Server zu jedem Aufruf den Werkzeugnamen, Ihre Client ID, die Claude-Anwendung, die Dauer und den Ergebnisstatus, nicht aber die Argumente oder die Antwort.

Beispielanfragen

• „Fasse alle offenen Mängel in der Schillerstraße 12 zusammen und gruppiere sie nach Gewerk.“
• „Erstelle Aufgaben aus diesen Baustellennotizen und füge das Team von Hoffmann Elektro als Beteiligte hinzu.“
• „Entwirf den heutigen Bautagesbericht für JACTESP aus den Fotos von heute Morgen.“
• „Wer aus der Kolonne hat letzte Woche an einem Tag mehr als 10 Stunden erfasst?“

Eine bewährte Routine: Lassen Sie sich von Claude jeden Freitag eine Baustellenzusammenfassung pro Projekt erstellen. Claude liest die Aufgaben und Berichte der Woche und liefert der Projektleitung einen einseitigen Statusbericht.

Werkzeuge

Die Werkzeuge sind nach Bereichen gruppiert. Die Gruppen sind eingeklappt, damit die Liste übersichtlich bleibt; öffnen Sie eine Gruppe, um ihre Werkzeuge zu sehen. Werkzeugnamen und Beschreibungen sind auf Englisch, und unter diesen Namen ruft Claude die Werkzeuge auf.

Fehlerbehebung

Die Autorisierungsseite schließt sich, ohne zu verbinden

Ihr Browser blockiert möglicherweise das Pop-up. Erlauben Sie Pop-ups für claude.ai und wählen Sie erneut Verbinden.

„Ihre Zugangsdaten konnten nicht überprüft werden“

Client ID oder Secret sind falsch, oder der API-Schlüssel existiert nicht mehr. Kopieren Sie beide erneut unter Valoon → Einstellungen → API-Schlüssel und versuchen Sie es noch einmal.

Claude meldet, ein Projekt existiere nicht

Claude sieht nur die Projekte, auf die Ihr Valoon-Konto Zugriff hat. Bitten Sie Claude, list_projects aufzurufen, um sie anzuzeigen. Fehlt das Projekt, bitten Sie eine Projektinhaberin oder einen Projektinhaber, Sie hinzuzufügen.

Ein schreibendes Werkzeug meldet „forbidden“

Ihre Valoon-Rolle erlaubt diese Aktion im Projekt nicht. Bitten Sie eine Projektinhaberin oder einen Projektinhaber, Ihre Rolle anzupassen, oder stellen Sie die Anfrage als reine Leseanfrage.

Datenschutz und Support

Zum Trennen entfernen Sie den Connector in den Claude-Einstellungen. Um den Zugriff vollständig zu widerrufen, löschen Sie den API-Schlüssel in Valoon unter Valoon → Einstellungen → API-Schlüssel; jeder Aufruf damit schlägt ab dann fehl.

Lesen Sie die Datenschutzerklärung und die Nutzungsbedingungen. Für Hilfe schreiben Sie an support@valoon.chat und nennen Sie den Zeitpunkt der fehlgeschlagenen Anfrage.