Octri : générateur de documentation API, SDK et MCP

Octri est un générateur de documentation API qui relie la référence, les bibliothèques clientes, l'accès MCP et la supervision à une même spécification. Il s'adresse aux équipes qui publient une API et doivent maintenir tout ce qui permet de l'intégrer.

À quoi sert Octri, concrètement ?

Une spécification décrit les appels possibles, leurs paramètres et leurs réponses. Octri la transforme en site documentaire pour les lecteurs, en SDK installables pour les développeurs et en outils pour les assistants IA. La supervision permet ensuite de repérer des problèmes sur les clients ou le backend.

C'est pertinent pour un éditeur SaaS ou un fournisseur d'API avec plusieurs langages à prendre en charge. Il faut toujours une API réelle et une vérification humaine des explications : la plateforme ne remplace pas l'implémentation du service.

Préparer une documentation que l'on peut réellement utiliser

API Studio produit des pages d'endpoints avec paramètres, schémas imbriqués et exemples. Les textes sont modifiables sur la page. Les guides MDX écrits par l'équipe expliquent ce que la référence seule ne dit pas, comme l'ordre des appels ou le parcours d'authentification.

Pour commencer, importez la spécification ou connectez son dépôt GitHub. Vérifiez les schémas et l'authentification, générez les pages, puis corrigez les explications en les confrontant à l'API. Exécutez un appel de test et un cas d'erreur avant de configurer la publication.

La console appelle l'API depuis le navigateur du lecteur et dépend donc de vos règles CORS. Lors d'une évolution de la spécification, examinez le brouillon reconstruit et les différences. La sortie d'une nouvelle version SDK vers les registres comporte une validation.

Les corrections manuelles des champs documentaires sont conservées lors de la régénération.

Donner la bonne documentation aux agents avec MCP

Octri fournit sept outils de lecture de documentation, plus des outils exécutables pour les endpoints retenus. Un client MCP tel que Claude ou Cursor peut ainsi consulter les pages publiées avant de préparer un appel.

L'identifiant du projet suffit pour les outils documentaires. L'exécution nécessite les identifiants de l'API, conservés sur la machine qui fait tourner le serveur. L'environnement cible, les droits du jeton et la liste des endpoints exclus déterminent ce que l'agent peut réellement faire.

Produire des bibliothèques clientes cohérentes

SDK Studio prend en charge TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift et Dart. Les noms de méthodes, exclusions et réglages propres au langage peuvent être configurés avant génération et publication.

Cette couverture concerne la plateforme entière ; le forfait limite le nombre de langages activés. Le code SDK personnalisé est proposé à partir de Growth. Une bibliothèque générée reste à tester sur les mécanismes d'authentification et les réponses particulières de votre API.

Superviser les erreurs sans confondre les flux de données

La supervision, désactivée par défaut, reçoit des événements des SDK générés ou de paquets backend. Journaux, incidents regroupés, traces, contrôles de disponibilité et alertes aident à relier un problème à son contexte. Octri décrit un masquage des données sensibles côté client puis à l'ingestion.

La politique de confidentialité distingue ce flux des traitements IA : portions de spécification pour la rédaction, questions et passages correspondants pour les réponses, texte documentaire pour les embeddings de recherche. L'entreprise indique que ni elle ni ses fournisseurs n'entraînent leurs modèles sur ces contenus. Le traitement n'est donc pas entièrement local.

Tarifs et limites à connaître

Vérification du 6 octobre 2026 : prix mensuels officiels en dollars américains, hors taxes pour les offres payantes.

• Free : un projet, un langage SDK, 50 endpoints, 100 Mo de supervision par mois et 100 crédits IA accordés une seule fois.
• Starter : 49 USD par mois, deux langages.
• Growth : 99 USD par mois, quatre langages, versions et code ou composants personnalisés.
• Business : 249 USD par mois, dix langages et marque blanche.
• Enterprise : sur devis ; générateur et moteur de rendu documentaire déployables dans votre infrastructure.

La génération d'un endpoint ou une réponse Ask-the-docs consomme un crédit. L'édition manuelle, les builds SDK et l'hébergement n'en consomment pas. Consultez la grille tarifaire officielle pour les autres quotas et options.

Le domaine personnalisé et la synchronisation GitHub sont inclus dans Free.

Questions fréquentes

Faut-il activer tous les modules ?

Non. Documentation, SDK, MCP et supervision font partie du même plan, mais peuvent être utilisés séparément.

Quels formats peut-on importer ?

La liste officielle comprend OpenAPI 3.0/3.1, Swagger 2.0, Postman et AsyncAPI en JSON ou YAML.

Que se passe-t-il sans crédits IA ?

La génération et Ask-the-docs s'arrêtent. La documentation publiée, les builds SDK et la supervision continuent. Les crédits du forfait gratuit ne se renouvellent pas chaque mois.

Ressources officielles

• Documentation Octri : mise en place et guides SDK.
• Octri sur GitHub : paquets publics et signalement de problèmes SDK.
• Assistance produit et facturation : canaux officiels et dépannage.