Conector Claude SwaggerLo que Claude sabe hacer en tu cuenta de Swagger.
El conector Claude Swagger expone 22 herramientas: 10 de lectura y 12 de escritura. Claude busca en tu registro de APIs, revisa definiciones con las reglas de tu organización, genera o corrige APIs, y crea, retoca, publica o borra productos y páginas de portal.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
Qué cambia cuando Claude trabaja en Swagger
La ficha del directorio resume Swagger así: diseñar, gobernar y documentar API. Con el conector, le describes la tarea a Claude: encuentra la API, lanza el análisis de estandarización, propone o aplica correcciones y actualiza las páginas de documentación de tu portal, siempre con tu acceso a SmartBear y tus roles.
Revisar una API frente a las reglas de la casa. Claude la encuentra con search_apis_and_domains, trae la definición resuelta con get_api_definition y scan_api_standardization enumera las infracciones por gravedad.
Corregir o bosquejar APIs. standardize_api arregla una definición que no cumple con ayuda de la IA de SmartBear, idealmente en una versión nueva, y create_api_from_prompt genera una API a partir de una descripción aplicando las reglas de gobernanza.
Mantener un portal para desarrolladores. Claude puede añadir un producto con create_portal_product, reescribir una página con update_document y luego publicarla en vista previa o en vivo con publish_portal_product.
Lo que no hará: solo ve los portales en los que tienes al menos rol de diseñador, y ninguna fuente describe una confirmación propia antes de las doce herramientas de escritura. Tampoco se ejecuta nada según un calendario: Claude actúa solo mientras te responde. El hub de conectores de Claude reúne otros conectores para desarrolladores, y la página Integraciones presenta las plataformas de automatización.
Cinco palabras antes de conectarlo
El vocabulario de Claude alrededor de este conector, en un minuto.
- Conector
- El vínculo que configuras una vez entre Claude y una cuenta que ya tienes, para que trabaje en ella mientras te responde.
- Herramienta
- Una capacidad con nombre que el conector abre a Claude en esa cuenta. Él elige las que necesita, y la ficha del directorio las lista por su nombre.
- Autorización
- La pantalla de acceso de SmartBear, donde das a Claude el permiso que usará a partir de entonces. Se concede una vez por persona y se puede revocar.
- Aprobación
- La confirmación que Claude espera antes de tocar algo en una cuenta, mostrada en la conversación cuando importa.
- MCP
- El estándar común de los conectores: es lo que permite a un asistente como Claude comunicarse con un servicio externo como Swagger.
Conectar Swagger a Claude en tres pasos
- 01
Busca Swagger en Claude
Abre los ajustes de Claude, entra en Customize y luego en Connectors, y busca Swagger. En un espacio Team o Enterprise, un Owner o un Primary Owner activa primero el conector para que cada miembro pueda entrar después.
- 02
Inicia la conexión
Pulsa Connect en su fila. SmartBear indica que se abre una ventana del navegador para un acceso OAuth de SmartBear, sin token de API ni variables de entorno que configurar. Si la conexión falla más adelante, usa Disconnect y vuelve a conectar.
- 03
Revisa la pantalla de autorización
Lee la pantalla de autorización antes de aceptar. Es de SmartBear, no de Claude, y es la que fija lo que cubre el acceso. También podrás retirarlo más tarde desde tu cuenta de SmartBear.
Las 22 herramientas de Swagger, según lo que hacen
Swagger le da a Claude 22 herramientas: 10 que leen tu cuenta, 12 que cambian algo en ella.
El código del servidor publicado por SmartBear describe cada una, con una marca de solo lectura o de modificación. Los nombres se quedan tal como Claude los muestra.
- 10 lectura
- 12 escritura
Lo que Claude lee (10)
10 herramientasDiez herramientas que buscan, abren y revisan APIs y contenido de portal sin alterarlos.
list_portals
Busca los portales para desarrolladores a los que tienes acceso en Swagger y devuelve solo aquellos en los que tienes al menos rol de diseñador, a nivel de producto o de organización.
get_portal
Trae el detalle de un portal, identificado por su UUID o su subdominio, para que Claude conozca su configuración antes de intervenir en él.
list_portal_products
Devuelve los productos de un portal que cumplen tus criterios, cada uno con su propia documentación de API para los visitantes, y los enumera para que Claude los recorra de uno en uno.
get_portal_product
Abre un producto, localizado por su UUID o por el par subdominio del portal y slug del producto, y devuelve sus ajustes y metadatos.
list_portal_product_sections
Enumera las secciones de un producto de portal, página a página, con sus índices incrustados si se piden, para que Claude trace cómo está organizada la documentación.
list_table_of_contents
Devuelve el índice de una sección, página a página, y puede incluir la API de SwaggerHub vinculada para que Claude vea qué referencia está en cada sitio.
get_document
Recupera el contenido y los metadatos de un documento a partir de su identificador, normalmente el HTML o el Markdown que hay detrás de una entrada del índice.
search_apis_and_domains
Rastrea el registro de SwaggerHub en busca de APIs y dominios por texto, propietario, etiqueta, estado de publicación o tipo, y devuelve nombre, propietario, versión y resumen.
get_api_definition
Recupera la definición resuelta de una versión de API en el registro, en JSON por defecto o en su YAML original si se pide.
scan_api_standardization
Pasa una definición en bruto, en YAML o JSON, por las reglas de gobernanza y estandarización de tu organización, y devuelve los problemas encontrados, agrupados por gravedad, con su total.
Lo que Claude puede crear, modificar o borrar (12)
12 herramientasDoce herramientas que montan portales, productos y páginas, los publican, o generan y corrigen APIs. Ninguna fuente describe una confirmación propia: rige la regla general de abajo.
create_portal
Aprobación: ver la reglaMonta un portal de Swagger nuevo vinculado a tu organización, con subdominio, nombre visible, motor de renderizado y la opción de arrancar desconectado o con credenciales.
update_portal
Aprobación: ver la reglaRetoca la configuración de un portal: nombre visible, subdominio y por tanto dirección, dominio propio, clave de analítica, visibilidad, enrutado, credenciales y motor de renderizado.
create_portal_product
Aprobación: ver la reglaAñade un producto a un portal, desde cero o como copia de uno existente, con nombre, slug, descripción y ajustes de visibilidad.
update_portal_product
Aprobación: ver la reglaCambia el nombre, el slug, la descripción, la visibilidad pública o la presencia de un producto en los menús de navegación del portal.
delete_portal_product
Aprobación: ver la reglaElimina un producto de un portal, operación que el propio código de SmartBear marca como destructiva.
publish_portal_product
Aprobación: ver la reglaPublica el contenido actual de un producto, en vista previa para probar o en vivo para los visitantes del portal, y devuelve la dirección resultante y el estado de publicación.
create_table_of_contents
Aprobación: ver la reglaAñade una entrada al índice de una sección de producto, que apunta a una referencia de API, a una página HTML o a una página Markdown.
delete_table_of_contents
Aprobación: ver la reglaElimina de forma reversible una entrada del índice, y puede hacerlo de manera recursiva con los elementos anidados que cuelgan de ella.
update_document
Aprobación: ver la reglaReescribe el contenido o el ajuste de origen de un documento de portal existente, en HTML o en Markdown.
create_or_update_api
Aprobación: ver la reglaCrea una API en el registro de SwaggerHub o sobrescribe una existente a partir de una definición que aportas, detectando por sí sola OpenAPI o AsyncAPI.
create_api_from_prompt
Aprobación: ver la reglaGenera y guarda una API nueva, o una versión nueva de una existente, a partir de una descripción en lenguaje natural con la IA de SmartBear, aplicando de paso las reglas de gobernanza de tu organización.
standardize_api
Aprobación: ver la reglaAnaliza una API del registro en busca de errores de estandarización y los corrige automáticamente con la IA de SmartBear, devolviendo el número de errores y la definición corregida.
Lo que Claude te pregunta antes de actuar
Por defecto, Claude se detiene y pide tu visto bueno antes de cada acción que realiza en una cuenta en tu nombre. Con doce herramientas de escritura, varias marcadas como destructivas por SmartBear, conviene mantener ese ajuste.
En los espacios Team y Enterprise, los propietarios deciden si un miembro puede dejar pasar ciertas acciones sin que se le vuelva a preguntar, y pueden acotar lo que un conector tiene permitido para toda la organización, por ejemplo mantener la lectura y cerrar la escritura. Nadie se lo salta desde su cuenta. Claude trabaja además solo con tus permisos en Swagger: la lista de portales devuelve solo aquellos en los que eres al menos diseñador, y lo que tu acceso no alcanza queda fuera de la conversación.
En qué planes está disponible
Ninguna de las 819 fichas del directorio oficial muestra la disponibilidad por plan. Conector por conector, esa respuesta no se publica en ninguna parte: es un hueco real del catálogo.
Lo que sí se publica es la regla general: los conectores remotos están abiertos a todos los usuarios en Claude, Cowork, Claude Desktop y móvil. En Team y Enterprise, un Owner o un Primary Owner habilita el conector para la organización antes de que cada miembro entre. Para el estado actual de este, consulta su ficha en el directorio oficial. Un detalle: solo SmartBear lo documenta, ningún artículo de ayuda de Claude lo trata.
Dónde se detiene el conector Claude Swagger
Un conector no es una automatización. Claude llama a estas herramientas mientras te responde: ninguna revisión arranca cuando alguien sube una versión nueva de una API.
La lista de herramientas es un mínimo observado, no una promesa: un administrador puede abrir acciones que ninguna ficha pública muestra. La insignia de socio del directorio no es una auditoría de seguridad, y Anthropic recuerda en cada ficha que no elige las herramientas que expone un editor ni garantiza que se comporten como se anuncia. Conecta solo lo que viene de un editor de confianza, aquí SmartBear, cuyo código del servidor es la fuente que describe estas herramientas.
¿Necesitas ayuda para conectar Swagger con Claude?
Una persona lee cada mensaje.
