Connecteur Claude SwaggerCe que Claude sait faire dans ton compte Swagger.
Le connecteur Claude Swagger expose 22 outils : 10 en lecture et 12 en écriture. Claude fouille ton registre d'API, contrôle les définitions selon les règles de ton organisation, génère ou corrige des API, et crée, retouche, publie ou supprime produits et pages de portail.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Ce qui change quand Claude travaille dans Swagger
La fiche du répertoire résume Swagger ainsi : concevoir, gouverner et documenter des API. Avec le connecteur, tu décris la tâche à Claude : il retrouve l'API, lance le contrôle de standardisation, propose ou applique des corrections, et met à jour les pages de documentation de ton portail, toujours sous ta connexion SmartBear et tes rôles.
Contrôler une API face aux règles maison. Claude la repère avec search_apis_and_domains, récupère la définition résolue via get_api_definition, et scan_api_standardization liste les écarts par gravité.
Corriger ou esquisser des API. standardize_api corrige une définition non conforme grâce à l'IA de SmartBear, idéalement dans une nouvelle version, et create_api_from_prompt génère une API à partir d'une description, règles de gouvernance appliquées.
Faire vivre un portail développeurs. Claude peut ajouter un produit avec create_portal_product, réécrire une page via update_document, puis passer en aperçu ou en ligne avec publish_portal_product.
Ce qu'il ne fera pas : il ne voit que les portails où tu as au moins un rôle de designer, et aucune source ne décrit de confirmation propre avant les douze outils d'écriture. Rien ne tourne selon un planning non plus : Claude n'agit que pendant qu'il te répond. Le hub des connecteurs Claude recense d'autres connecteurs développeurs, et la page Intégrations présente les plateformes d'automatisation.
Cinq mots avant de brancher
Le vocabulaire de Claude autour de ce connecteur, en une minute.
- Connecteur
- Le lien que tu poses une fois entre Claude et un compte que tu as déjà, pour qu'il y travaille pendant qu'il te répond.
- Outil
- Une capacité nommée que le connecteur ouvre à Claude sur ce compte. Il choisit seul celles qu'il lui faut ; la fiche du répertoire les liste par leur nom.
- Autorisation
- L'écran de connexion SmartBear, où tu donnes à Claude l'accès qu'il utilisera ensuite. Accordée une fois par personne, et révocable.
- Approbation
- La confirmation que Claude attend avant de toucher à un compte, affichée dans la conversation au moment où elle compte.
- MCP
- Le standard commun des connecteurs : c'est lui qui permet à un assistant comme Claude de dialoguer avec un service extérieur tel que Swagger.
Brancher Swagger à Claude en trois étapes
- 01
Retrouver Swagger dans Claude
Ouvre les réglages de Claude, passe par Customize puis Connectors, et cherche Swagger. Sur un espace Team ou Enterprise, un Owner ou un Primary Owner active d'abord le connecteur pour que chaque membre puisse ensuite s'y connecter.
- 02
Lancer le branchement
Clique sur Connect sur sa ligne. SmartBear indique qu'une fenêtre de navigateur s'ouvre pour une connexion OAuth SmartBear, sans jeton d'API ni variable d'environnement à régler. Si le lien se casse, fais Disconnect puis rebranche.
- 03
Relire l'écran d'autorisation
Lis l'écran d'autorisation avant de valider. Il appartient à SmartBear, pas à Claude, et c'est lui qui fixe ce que couvre l'accès. Tu pourras aussi le retirer plus tard depuis ton compte SmartBear.
Les 22 outils Swagger, rangés selon ce qu'ils font
Swagger donne à Claude 22 outils : 10 qui lisent ton compte, 12 qui y changent quelque chose.
Le code du serveur publié par SmartBear décrit chacun d'eux, avec un marqueur lecture seule ou modification. Les noms restent tels que Claude les affiche.
- 10 lecture
- 12 écriture
Ce que Claude lit (10)
10 outilsDix outils qui cherchent, ouvrent et contrôlent API et contenus de portail sans les altérer.
list_portals
Cherche les portails développeurs auxquels tu as accès dans Swagger, en ne renvoyant que ceux où tu as au moins un rôle de designer, au niveau produit ou organisation.
get_portal
Rapporte le détail d'un portail, désigné par son UUID ou son sous-domaine, pour que Claude connaisse sa configuration avant d'y intervenir.
list_portal_products
Renvoie les produits d'un portail qui répondent à tes critères, chaque produit étant un ensemble de documentation d'API que parcourent les visiteurs.
get_portal_product
Ouvre un produit, retrouvé par son UUID ou par le couple sous-domaine du portail et slug du produit, et rapporte ses réglages et métadonnées.
list_portal_product_sections
Énumère les sections d'un produit de portail, page par page, avec au besoin leurs tables des matières intégrées, pour que Claude cartographie l'organisation de la documentation.
list_table_of_contents
Renvoie la table des matières d'une section, page par page, et peut y joindre l'API SwaggerHub associée pour que Claude voie quelle référence se trouve où.
get_document
Récupère le contenu et les métadonnées d'un document à partir de son identifiant, en général le HTML ou le Markdown derrière une entrée de sommaire.
search_apis_and_domains
Fouille le registre SwaggerHub à la recherche d'API et de domaines par texte, propriétaire, tag, état de publication ou type, et rapporte nom, propriétaire, version et résumé.
get_api_definition
Récupère la définition résolue d'une version d'API dans le registre, en JSON par défaut ou sous sa forme YAML d'origine sur demande.
scan_api_standardization
Passe une définition brute, en YAML ou en JSON, au crible des règles de gouvernance et de standardisation de ton organisation, et rend les problèmes trouvés, classés par gravité, avec leur total.
Ce que Claude peut créer, modifier ou supprimer (12)
12 outilsDouze outils qui montent portails, produits et pages, les publient, ou génèrent et corrigent des API. Aucune source ne décrit de confirmation propre : la règle générale plus bas s'applique.
create_portal
Approbation : voir la règleMonte un nouveau portail Swagger relié à ton organisation, avec un sous-domaine, un nom affiché, un moteur de rendu, et le choix de démarrer hors ligne ou avec identifiants.
update_portal
Approbation : voir la règleRetouche la configuration d'un portail : nom affiché, sous-domaine et donc adresse, domaine personnalisé, clé d'analytics, visibilité, routage, identifiants et moteur de rendu.
create_portal_product
Approbation : voir la règleAjoute un produit à un portail, à partir de zéro ou en copie d'un produit existant, avec nom, slug, description et réglages de visibilité.
update_portal_product
Approbation : voir la règleChange le nom, le slug, la description, la visibilité publique ou la présence d'un produit dans les menus de navigation du portail.
delete_portal_product
Approbation : voir la règleRetire un produit d'un portail, opération que le code de SmartBear marque lui-même comme destructive.
publish_portal_product
Approbation : voir la règlePublie le contenu actuel d'un produit, en aperçu pour tester ou en ligne pour les visiteurs du portail, et renvoie l'adresse obtenue et l'état de publication.
create_table_of_contents
Approbation : voir la règleAjoute une entrée à la table des matières d'une section de produit, qui pointe vers une référence d'API, une page HTML ou une page Markdown.
delete_table_of_contents
Approbation : voir la règleSupprime de façon réversible une entrée de table des matières, et peut le faire de manière récursive pour les éléments imbriqués en dessous.
update_document
Approbation : voir la règleRéécrit le contenu ou le réglage de source d'un document de portail existant, en HTML ou en Markdown.
create_or_update_api
Approbation : voir la règleCrée une API dans le registre SwaggerHub ou écrase une API existante à partir d'une définition fournie, en détectant seul OpenAPI ou AsyncAPI.
create_api_from_prompt
Approbation : voir la règleGénère et enregistre une nouvelle API, ou une nouvelle version, à partir d'une description en langage courant grâce à l'IA de SmartBear, en appliquant au passage les règles de gouvernance de ton organisation.
standardize_api
Approbation : voir la règleAnalyse une API du registre à la recherche d'erreurs de standardisation et les corrige automatiquement avec l'IA de SmartBear, puis renvoie le nombre d'erreurs et la définition corrigée.
Ce que Claude te demande avant d'agir
Par défaut, Claude s'arrête et demande ton accord avant chaque action qu'il mène sur un compte à ta place. Avec douze outils d'écriture, dont plusieurs que SmartBear classe comme destructifs, mieux vaut garder ce réglage.
Sur les espaces Team et Enterprise, les propriétaires décident si un membre peut laisser passer certaines actions sans qu'on les lui redemande, et ils peuvent borner ce qu'un connecteur a le droit de faire pour toute l'organisation, garder la lecture et fermer l'écriture par exemple. Personne ne contourne ce choix depuis son compte. Claude travaille aussi avec tes seuls droits Swagger : la liste des portails ne renvoie que ceux où tu es au moins designer, et ce que ta connexion n'atteint pas reste hors de la conversation.
Sur quels plans c'est disponible
Aucune des 819 fiches du répertoire officiel n'affiche la disponibilité par plan. Connecteur par connecteur, la réponse n'est publiée nulle part : c'est un vrai trou du catalogue.
Ce qui est publié, c'est la règle générale : les connecteurs distants sont ouverts à tous les utilisateurs sur Claude, Cowork, Claude Desktop et mobile. Sur Team et Enterprise, un Owner ou un Primary Owner ouvre le connecteur pour l'organisation avant que chaque membre s'y connecte. Pour l'état à jour de celui-ci, consulte sa fiche dans le répertoire officiel. À noter : seul SmartBear le documente, aucune page d'aide de Claude n'en parle.
Là où le connecteur Claude Swagger s'arrête
Un connecteur n'est pas une automatisation. Claude appelle ces outils pendant qu'il te répond : aucun contrôle ne part quand quelqu'un pousse une nouvelle version d'API.
La liste d'outils est un plancher observé, pas une promesse : un administrateur peut ouvrir des actions qu'aucune fiche publique ne montre. Le badge partenaire du répertoire n'est pas un audit de sécurité, et Anthropic précise sur chaque fiche qu'il ne choisit pas les outils exposés par un éditeur et ne garantit pas qu'ils se comportent comme annoncé. Ne branche que ce qui vient d'un éditeur de confiance, ici SmartBear, dont le code du serveur est la source qui décrit ces outils.
Besoin d'aide pour brancher Swagger sur Claude ?
Une personne lit chaque message.
