Connecteur Claude

Le connecteur Sway pour Claude permet à Claude Desktop de lire vos espaces de travail Sway via l’API Sway. Demandez quelles factures sont en retard ou quelles transactions bancaires ne sont pas encore rapprochées, et Claude les cherche. Quand vous l’autorisez, Claude peut aussi faire des modifications, comme confirmer le rapprochement entre une facture et une transaction bancaire, dans les portées de votre clé.

Avant de commencer

• Claude Desktop sur macOS ou Windows. Claude sur le web et les applications mobiles ne peuvent pas utiliser le connecteur.
• Une licence qui comprend l’API Sway. La licence de base couvre toute la plateforme ; un niveau supérieur ajoute l’API publique. Contactez Sway pour l’ajouter.
• Rien d’autre à installer : Claude Desktop exécute lui-même le connecteur.

L’installer

1. Créez une clé API. Dans Sway, choisissez votre nom en bas de la barre latérale, puis Profil, Développeur et Créer une clé API. Nommez la clé d’après Claude, cochez Lecture pour chaque ressource que Claude peut voir, comme invoices, bank-accounts et counterparties, et choisissez quand elle expire. Copiez la clé secrète, que Sway n’affiche qu’une fois : Développeur et clés API explique chaque champ.
2. Téléchargez le connecteur. Choisissez Télécharger pour Claude Desktop ci-dessus. Le fichier se termine par .mcpb.
3. Installez-le. Ouvrez le fichier : Claude Desktop affiche la boîte d’installation de Sway Workspace (Beta). Elle prévient que l’éditeur n’est pas vérifié, car la bêta n’est pas encore signée ; choisissez Install.
4. Collez la clé. Collez la clé secrète dans Sway API key. Laissez Allow writes désactivé, et Sway API base URL tel quel. Claude Desktop garde la clé dans le trousseau de votre ordinateur, pas dans un fichier.
5. Testez la connexion. Ouvrez une nouvelle conversation et écrivez « Teste ma connexion à Sway. » Claude liste les espaces de travail que votre clé atteint.

Demandez ensuite, par exemple :

• « Quelles factures de nom de l’espace de travail sont encore impayées et en retard ? »
• « Montre-moi les transactions bancaires non rapprochées du mois dernier dans nom de l’espace de travail. »

Ce que Claude peut faire

Le connecteur donne à Claude quatre outils, que Claude Desktop nomme quand il demande votre accord :

• sway_test_connection affiche votre utilisateur, la clé et les espaces de travail qu’elle atteint.
• sway_api_spec lit la documentation de l’API Sway, si bien que le connecteur suit chaque nouvelle version de l’API sans mise à jour.
• sway_read appelle un endpoint qui lit des données.
• sway_write appelle un endpoint qui crée, modifie ou supprime des données. Claude ne l’obtient que si Allow writes est activé.

Laisser Claude faire des modifications

Claude ne modifie des données que si ces deux conditions sont remplies :

• Allow writes est activé, dans les réglages de Sway Workspace (Beta) dans Claude Desktop.
• La clé a la case Écriture de la ressource, comme invoices pour confirmer un rapprochement.

Claude Desktop vous demande votre accord avant chaque modification. Répondez Allow once pour sway_write : Always allow cesse de demander avant chaque modification suivante. Vérifiez dans Sway ce que Claude a modifié.

Votre clé et vos données

• Claude Desktop garde la clé dans le trousseau de votre ordinateur. Le connecteur ne l’envoie qu’à l’API Sway, en HTTPS, et n’accepte aucune autre adresse.
• Le connecteur n’envoie aucune donnée d’utilisation, et ne contacte aucun serveur hormis l’API Sway.
• Ce que l’API Sway répond entre dans votre conversation avec Claude, comme un fichier que vous partagez avec Claude.
• Le connecteur ne répète jamais une modification : après un délai dépassé, Claude relit les données avant de réessayer.

Retirer l’accès

• Révoquez la clé dans Sway, sous Profil › Développeur : le connecteur s’arrête aussitôt.
• Ou désinstallez Sway Workspace (Beta) dans les réglages de Claude Desktop, sous Extensions.

En cas de problème

Claude affiche	Que faire
No API key configured	Ouvrez les réglages de Claude Desktop, puis Extensions et Sway Workspace (Beta), et collez de nouveau la clé.
HTTP 401	La clé est erronée, expirée ou révoquée : créez-en une nouvelle.
HTTP 403	La clé n’a pas la portée de ce que vous avez demandé : créez une clé avec cette portée, ou demandez dans le cadre de la portée actuelle.
HTTP 409	L’espace de travail est suspendu, car son abonnement a pris fin.
HTTP 429	Trop de requêtes en une minute : attendez une minute, puis demandez de nouveau.

Pour tout autre problème, contactez Sway avec la phrase que Claude vous a affichée.