Octri: generador de documentación API, SDK y MCP

Octri es un generador de documentación API para equipos que quieren mantener la referencia, los SDK y las herramientas para agentes a partir de una misma especificación. Incluye monitorización para seguir lo que ocurre cuando los clientes llegan a producción.

¿Para qué sirve Octri? Una explicación sencilla

Una especificación API es una descripción de las operaciones disponibles: qué petición enviar, qué datos necesita y qué respuesta devuelve. Octri convierte esa descripción en un sitio legible, bibliotecas que otros desarrolladores pueden instalar y herramientas que un asistente de IA puede utilizar.

Encaja con proveedores de API, productos SaaS y equipos que mantienen integraciones en varios lenguajes. La API real y la comprobación de los textos siguen siendo responsabilidad del equipo. Puedes utilizar los módulos por separado.

Preparar y publicar una referencia útil

API Studio organiza endpoints, parámetros, esquemas anidados y ejemplos. Permite corregir el contenido generado directamente y añadir guías MDX propias para explicar autenticación o un proceso de integración completo.

1. Sube la especificación o conecta su repositorio de GitHub.
2. Revisa operaciones, autenticación y esquemas de entrada y salida.
3. Genera las páginas y contrasta las explicaciones con el servicio.
4. Prueba una petición válida y una respuesta de error en un entorno de pruebas.
5. Configura publicación y SDK, si los necesitas, y aprueba el borrador después de revisar las diferencias.

La consola realiza las peticiones desde el navegador del lector: la política CORS de tu API influye en su funcionamiento. La sincronización con GitHub puede iniciar una reconstrucción, pero la publicación de nuevas versiones de SDK mantiene un paso de aprobación.

Dar contexto y capacidad de acción a los agentes

El servidor MCP ofrece siete herramientas para consultar documentación publicada y puede convertir los endpoints incluidos en herramientas ejecutables. Así, Claude, Cursor y otros clientes MCP trabajan con la definición real de la API.

La consulta documental utiliza el identificador del proyecto. Las operaciones ejecutables necesitan credenciales de API, que permanecen en la máquina donde se ejecuta el servidor. Configura el entorno, los permisos y las exclusiones antes de permitir llamadas que puedan modificar datos.

Generar SDK sin mantener diez proyectos a mano

SDK Studio admite TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift y Dart. Puedes ajustar nombres de métodos, excluir endpoints internos y configurar cada lenguaje antes de generar y distribuir los paquetes.

El número de lenguajes disponibles depende del plan. El código SDK personalizado aparece a partir de Growth. La generación reduce trabajo repetitivo, pero conviene probar autenticación y respuestas particulares antes de entregar la biblioteca a clientes.

Qué incluye el plan gratuito

Precios mensuales oficiales en dólares estadounidenses, comprobados el 6 de octubre de 2026; los importes de pago no incluyen impuestos y no son precios en euros:

• Free: un proyecto, un lenguaje SDK, 50 endpoints, 100 MB mensuales de monitorización y 100 créditos de IA concedidos una sola vez.
• Starter: 49 USD al mes, con dos lenguajes.
• Growth: 99 USD al mes, con cuatro lenguajes, versiones y código o componentes personalizados.
• Business: 249 USD al mes, con los diez lenguajes y marca blanca.
• Enterprise: presupuesto personalizado; permite alojar el generador y el renderizador de documentación en infraestructura propia.

Generar la explicación de un endpoint o una respuesta de Ask-the-docs consume un crédito. La edición manual, las compilaciones SDK y el alojamiento no utilizan ese saldo. Consulta los límites completos en la comparación oficial de planes.

Monitorización y privacidad de la especificación

La monitorización está desactivada inicialmente. Puede recopilar eventos de SDK generados y paquetes de backend, con registros, errores agrupados, trazas, comprobaciones de disponibilidad y alertas. Octri describe un filtrado de información sensible tanto antes del envío como durante la recepción.

La política de privacidad aclara que las funciones de IA envían partes de la especificación, preguntas y fragmentos pertinentes a proveedores externos; la búsqueda también implica generar embeddings. Octri afirma que esos contenidos no se usan para entrenar modelos. Esto no significa que el procesamiento sea íntegramente local.

Preguntas frecuentes

¿Se puede empezar gratis?

Sí, con las cuotas de Free. Incluye dominio propio y sincronización con GitHub. Al agotarse los créditos se detienen la generación IA y las respuestas del chat, pero continúan el sitio publicado, las compilaciones SDK y la monitorización.

¿Admite Swagger y Postman?

Sí. La lista oficial incluye OpenAPI 3.0/3.1, Swagger 2.0, Postman y AsyncAPI en JSON o YAML. Revisa los esquemas después de la importación.

¿Se pueden corregir las páginas generadas?

Sí. Las modificaciones manuales se conservan por campo cuando se regenera el contenido; las partes no editadas pueden actualizarse. Conviene revisar siempre el nuevo borrador.

Recursos oficiales

• Documentación de Octri: configuración y guías de SDK.
• Octri en GitHub: paquetes públicos e incidencias de SDK.
• Soporte de producto y facturación: ayuda y resolución de problemas.