Claude-Connector

Der Sway-Connector für Claude lässt Claude Desktop Ihre Sway-Arbeitsbereiche über die Sway-API lesen. Fragen Sie, welche Rechnungen überfällig oder welche Banktransaktionen noch nicht abgeglichen sind, und Claude schlägt sie nach. Wenn Sie es erlauben, kann Claude auch Änderungen vornehmen, etwa den Abgleich zwischen einer Rechnung und einer Banktransaktion bestätigen, im Rahmen der Bereiche Ihres Schlüssels.

Bevor Sie beginnen

• Claude Desktop auf macOS oder Windows. Claude im Web und die mobilen Apps können den Connector nicht nutzen.
• Eine Lizenz, die die Sway-API umfasst. Die Basislizenz deckt die ganze Plattform ab; eine höhere Stufe fügt die öffentliche API hinzu. Kontaktieren Sie Sway, um sie hinzuzufügen.
• Sonst nichts zu installieren: Claude Desktop führt den Connector selbst aus.

Einrichten

1. Erstellen Sie einen API-Schlüssel. Wählen Sie in Sway unten in der Seitenleiste Ihren Namen, dann Profil, Entwickler und API-Schlüssel erstellen. Benennen Sie den Schlüssel nach Claude, haken Sie Lesen für jede Ressource an, die Claude sehen darf, etwa invoices, bank-accounts und counterparties, und wählen Sie, wann er abläuft. Kopieren Sie den Geheimschlüssel, den Sway nur einmal zeigt: Entwickler und API-Schlüssel erklärt jedes Feld.
2. Laden Sie den Connector herunter. Wählen Sie oben Für Claude Desktop herunterladen. Die Datei endet auf .mcpb.
3. Installieren Sie ihn. Öffnen Sie die Datei: Claude Desktop zeigt den Installationsdialog von Sway Workspace (Beta). Er warnt, dass der Herausgeber nicht verifiziert ist, da die Beta noch nicht signiert ist; wählen Sie Install.
4. Fügen Sie den Schlüssel ein. Fügen Sie den Geheimschlüssel in Sway API key ein. Lassen Sie Allow writes ausgeschaltet und Sway API base URL, wie es ist. Claude Desktop bewahrt den Schlüssel im Schlüsselbund Ihres Computers auf, nicht in einer Datei.
5. Testen Sie die Verbindung. Beginnen Sie einen neuen Chat und schreiben Sie „Teste meine Verbindung zu Sway.“ Claude listet die Arbeitsbereiche, die Ihr Schlüssel erreicht.

Fragen Sie dann zum Beispiel:

• „Welche Rechnungen in Name des Arbeitsbereichs sind noch unbezahlt und überfällig?“
• „Zeig mir die nicht abgeglichenen Banktransaktionen des letzten Monats in Name des Arbeitsbereichs.“

Was Claude tun kann

Der Connector gibt Claude vier Werkzeuge, die Claude Desktop nennt, wenn es Ihre Zustimmung einholt:

• sway_test_connection zeigt Ihren Benutzer, den Schlüssel und die Arbeitsbereiche, die er erreicht.
• sway_api_spec liest die Dokumentation der Sway-API, sodass der Connector jeder neuen Version der API ohne Update folgt.
• sway_read ruft einen Endpunkt auf, der Daten liest.
• sway_write ruft einen Endpunkt auf, der Daten erstellt, ändert oder löscht. Claude erhält es nur, wenn Allow writes eingeschaltet ist.

Claude Änderungen erlauben

Claude ändert Daten nur, wenn beides zutrifft:

• Allow writes ist eingeschaltet, in den Einstellungen von Sway Workspace (Beta) in Claude Desktop.
• Der Schlüssel hat das Kästchen Schreiben der Ressource, etwa invoices, um einen Abgleich zu bestätigen.

Claude Desktop fragt Sie vor jeder Änderung. Antworten Sie für sway_write mit Allow once: Always allow hört auf, vor jeder späteren Änderung zu fragen. Prüfen Sie in Sway, was Claude geändert hat.

Ihr Schlüssel und Ihre Daten

• Claude Desktop bewahrt den Schlüssel im Schlüsselbund Ihres Computers auf. Der Connector sendet ihn nur an die Sway-API, über HTTPS, und nimmt keine andere Adresse an.
• Der Connector sendet keine Nutzungsdaten und kontaktiert keinen anderen Server als die Sway-API.
• Was die Sway-API antwortet, gelangt in Ihren Chat mit Claude, wie eine Datei, die Sie mit Claude teilen.
• Der Connector wiederholt nie eine Änderung: Nach einem Timeout liest Claude die Daten erneut, bevor es einen neuen Versuch startet.

Zugriff entziehen

• Widerrufen Sie den Schlüssel in Sway unter Profil › Entwickler: Der Connector stoppt sofort.
• Oder deinstallieren Sie Sway Workspace (Beta) in den Einstellungen von Claude Desktop unter Extensions.

Wenn etwas nicht klappt

Claude zeigt	Was tun
No API key configured	Öffnen Sie die Einstellungen von Claude Desktop, dann Extensions und Sway Workspace (Beta), und fügen Sie den Schlüssel erneut ein.
HTTP 401	Der Schlüssel ist falsch, abgelaufen oder widerrufen: Erstellen Sie einen neuen.
HTTP 403	Dem Schlüssel fehlt der Bereich für Ihre Frage: Erstellen Sie einen Schlüssel mit diesem Bereich, oder fragen Sie im Rahmen des aktuellen.
HTTP 409	Der Arbeitsbereich ist gesperrt, da sein Abonnement geendet hat.
HTTP 429	Zu viele Anfragen in einer Minute: Warten Sie eine Minute und fragen Sie dann erneut.

Für alles andere kontaktieren Sie Sway mit dem Satz, den Claude Ihnen gezeigt hat.