Aller à la documentation

API et MCP

D’une conversation à un dessin

Connectez Claude, ChatGPT ou un autre outil d’IA au serveur MCP d’Occlusia, approuvez-le, et menez un modèle de l’envoi à l’export en le demandant.

Connecter et approuver

  1. 01

    Ajouter l’adresse

    Dans votre outil d’IA, ajoutez un serveur MCP distant avec l’adresse https://api.occlusia.app/v1/mcp — dans Claude, sous Settings, Connectors, Add custom connector.

  2. 02

    Se connecter sur occlusia.app

    La première fois que l’outil appelle Occlusia, il ouvre occlusia.app : connectez-vous si besoin. C’est OAuth : l’outil ne voit jamais votre mot de passe, et il n’y a aucune clé à copier.

  3. 03

    Approuver l’application

    La page indique quelle application fait la demande — son identité vérifiée quand elle en a une —, où elle vous renverra, et ce qu’elle pourra faire. Autorisez-la seulement si vous venez de la connecter vous-même.

  4. 04

    De retour dans la conversation

    L’outil est connecté. Il apparaît sous Applications connectées dans votre compte, où vous pouvez le déconnecter à tout moment.

Un modèle, de l’envoi à l’export

Ce que vous demandez, et ce que l’IA fait avec les outils d’Occlusia. Demandez avec vos propres mots : l’IA lit d’elle-même le guide et la référence d’Occlusia.

  1. 01

    « Ouvre mon modèle »

    L’IA vous donne un lien vers une page où déposer votre modèle .skp, .ifc, .fbx ou .occs, ou un projet .occp — ou le récupère depuis un lien public que vous donnez. L’ouvrir coûte un crédit.

  2. 02

    « Que contient-il ? »

    Elle liste les vues du modèle, ses objets par groupe, ses notes et ses cotes de niveau. Lister est gratuit.

  3. 03

    « Hachure le béton avec AR-CONC, avec un trait de coupe BOLD »

    Elle modifie les réglages des objets que vous nommez — ou applique votre configuration en entier, si vous lui donnez votre fichier .occc.

  4. 04

    « Montre-moi la Section A-A »

    Elle dessine la vue et voit l’image, ce qui lui permet de vérifier son propre travail et de vous le montrer. Chaque nouveau dessin coûte un crédit ; le même dessin de nouveau est gratuit.

  5. 05

    « Exporte la Section A-A et le plan dans un seul PDF A3 au 1:50 »

    Elle exporte et vous remet un lien de téléchargement pour chaque fichier. Un PDF coûte un crédit par feuille.

L’espace de travail

  • Ce que l’IA ouvre, règle et exporte reste dans votre espace de travail d’une requête à l’autre, et d’une conversation à l’autre, tant qu’il est utilisé. Il se termine après 15 minutes d’inactivité, et ses fichiers avec lui.
  • workspace_status dit ce qu’il contient ; demandez à l’IA de réinitialiser l’espace de travail pour repartir de zéro.
  • Conservez l’essentiel : demandez le projet (.occp) ou la configuration (.occc) en téléchargement.

Ce que voit l’outil d’IA

Votre outil d’IA reçoit ce que répondent les outils d’Occlusia — les noms des objets et des vues de votre modèle, les aperçus qu’il dessine, les liens de téléchargement — et son fournisseur les conserve selon ses propres conditions. Occlusia ne conserve vos fichiers que dans votre espace de travail, et les supprime à sa fin.

Avec une clé d’API à la place

Un outil qui envoie un en-tête peut utiliser une clé d’API à la place d’OAuth. Le serveur parle MCP 2026-07-28, et 2025-11-25 jusqu’à 2025-03-26.

claude mcp add --transport http occlusia https://api.occlusia.app/v1/mcp \
  --header "Authorization: Bearer occ_sk_…"
Avec Claude Code, ou dans les réglages MCP d’un autre outil d’IA.