Le connecteur MCP (Model Context Protocol) permet d'utiliser TopAO depuis votre assistant IA : chercher des appels d'offres, consulter l'intelligence de marché, faire avancer votre pipeline, analyser un DCE ou rédiger une section du mémoire technique. Il est inclus dans l'offre Business, y compris pendant l'essai.
L'adresse du serveur est la même pour tous les assistants :
https://topao.fr/api/mcp
La connexion se fait par OAuth : aucune clé à copier. À la première utilisation, l'assistant ouvre une page TopAO où vous vous connectez, choisissez l'entreprise concernée et confirmez ce que l'assistant pourra faire. Chaque connexion est propre à votre compte et liée à une seule entreprise : pour en utiliser une autre, ajoutez une seconde connexion. L'adresse et les guides pas à pas sont aussi dans l'application, dans Paramètres, rubrique Assistants IA.
Claude
Sur claude.ai ou dans l'application de bureau :
- Ouvrez Paramètres, puis Connecteurs.
- Choisissez Ajouter un connecteur personnalisé.
- Donnez-lui un nom (par exemple « TopAO ») et collez l'adresse
https://topao.fr/api/mcp. - Choisissez Se connecter, puis autorisez l'accès sur la page TopAO qui s'ouvre.
Selon votre offre Claude, l'ajout d'un connecteur personnalisé peut être réservé à l'administrateur de votre organisation.
ChatGPT
Selon votre offre ChatGPT, l'ajout se fait dans les connecteurs (offres professionnelles, souvent par un administrateur) ou en activant le mode développeur dans les paramètres avancés. Dans les deux cas, créez un connecteur, indiquez l'adresse https://topao.fr/api/mcp, choisissez l'authentification OAuth, puis autorisez l'accès sur la page TopAO.
Claude Code
Dans un terminal, ajoutez le serveur :
claude mcp add --transport http topao https://topao.fr/api/mcp
Lancez ensuite Claude Code, tapez /mcp, choisissez topao puis l'authentification : votre navigateur ouvre la page d'autorisation de TopAO.
Cursor et Visual Studio Code
Les deux éditeurs acceptent un serveur MCP distant par son adresse. Ajoutez un serveur MCP dans les réglages (dans VS Code, commande MCP : Ajouter un serveur, type HTTP), avec le nom topao et l'adresse https://topao.fr/api/mcp. Au premier appel, l'éditeur vous propose de vous authentifier : autorisez l'accès sur la page TopAO.
Autres assistants
Tout client compatible avec les serveurs MCP distants (transport HTTP et authentification OAuth) peut se connecter avec la même adresse. Consultez la documentation de votre client pour savoir où ajouter un serveur distant.
Ce que chaque rôle peut faire
- Propriétaire et utilisateur : consultation, actions (enregistrer ou écarter un avis, pipeline, profils de veille, suivis, contenu d'une section) et fonctions IA (recherche IA, analyse de DCE, go/no-go, questions à l'acheteur, plan et sections du mémoire, lettres de présentation).
- Lecteur : consultation seulement. Les actions et les fonctions IA ne lui sont pas proposées.
Le rôle est vérifié à chaque appel : si votre rôle change, l'assistant suit aussitôt. La facturation, l'équipe, les réglages de l'entreprise, les suppressions, le dépôt de fichiers, les exports et les envois d'emails restent dans l'application.
Quotas
Les fonctions IA utilisées depuis l'assistant consomment les mêmes quotas que dans l'application (analyses de DCE, mémoires, lettres de présentation, recherches IA). L'assistant indique ce qu'il reste après chaque appel concerné ; vous pouvez aussi lui demander votre contexte (entreprise, offre, rôle et quotas restants).
Révoquer une connexion
Dans Paramètres, rubrique Assistants IA, la liste de vos connexions indique l'assistant, l'entreprise, la date de connexion et la dernière utilisation. Choisissez Révoquer : l'assistant perd l'accès aussitôt. Le propriétaire voit et peut révoquer toutes les connexions de l'entreprise, et peut couper le connecteur pour toute l'entreprise depuis la page Entreprise, onglet Intégrations.
Dépannage
- « Connecteur non inclus dans l'offre de cette entreprise » ou « Le connecteur MCP est réservé à l'offre Business » : le connecteur est réservé à l'offre Business et à l'essai Business. Le propriétaire peut passer à Business depuis Paramètres, rubrique Facturation ; vous pouvez aussi choisir sur la page d'autorisation une entreprise qui a l'offre Business.
- « Connecteur coupé par le propriétaire » : le propriétaire de l'entreprise a désactivé le connecteur. Demandez-lui de le réactiver dans la page Entreprise, onglet Intégrations, puis reconnectez l'assistant.
- L'assistant ne répond plus ou demande de se reconnecter : la connexion a pu être révoquée, ou votre accès a changé (rôle, offre, membre retiré). Supprimez le connecteur dans l'assistant, ajoutez-le de nouveau avec la même adresse et autorisez l'accès.
- « Le compte est en lecture seule » : un paiement est en attente. La consultation reste possible ; le propriétaire régularise le paiement dans Paramètres, rubrique Facturation, et vous retrouvez les actions et les fonctions IA.
- Mauvaise entreprise : une connexion est liée à l'entreprise choisie à l'autorisation. Ajoutez une nouvelle connexion et choisissez l'autre entreprise.