API publique

Connecter un assistant IA (MCP)

Créez une clé API avec seulement les portées dont l’assistant a besoin, puis donnez au client l’adresse https://api.mosaqo.app/v1/mcp avec cette clé comme jeton bearer. L’assistant peut exactement ce que la clé autorise et rien d’autre, et vous pouvez le déconnecter à tout moment dans Bulk & API.

Vérifié le 20 août 2026

Étapes

1. Ouvrez Bulk & API → API keys et créez une clé. Accordez d’abord des portées en lecture seule ; vous en émettrez une seconde avec écriture quand vous saurez ce que fait l’assistant.
2. Copiez l’adresse depuis le bloc AI assistants (MCP) du même écran.
3. Dans l’assistant, ajoutez un serveur avec cette adresse et envoyez la clé dans l’en-tête Authorization: Bearer. La plupart des clients acceptent un bloc JSON avec url et headers.
4. Certains connecteurs vous demandent de vous connecter à Mosaqo au lieu de coller une clé. Ce parcours montre qui demande, quel espace serait concerné et ce qu’il pourrait faire, avant que quoi que ce soit ne soit accordé — seul un propriétaire ou un administrateur peut approuver.
5. Demandez à l’assistant ce qu’il sait faire. Il listera les outils que votre clé autorise : la confirmation la plus rapide que la connexion est bien cadrée.

Comment vérifier le résultat

Demandez quelque chose que seul cet espace connaît : combien de codes vous avez, ou comment se porte une enquête. Une réponse avec vos vrais noms et chiffres signifie que la connexion fonctionne ; un refus nommant une portée signifie que la clé est plus étroite que la question.

Ce qui coince le plus souvent

• Donner l’écriture dès la première clé. Commencez en lecture seule et élargissez ensuite.
• Attendre qu’il lise ce que les gens ont écrit dans une enquête. Ces réponses ne sont remises ni à une clé ni à un assistant — les notes et les décomptes oui, les phrases restent dans la boîte de réception.
• Attendre qu’il supprime un code. Il ne peut pas : détruire la redirection derrière un code imprimé est irréversible, on lui propose donc l’archivage, qui se défait.
• Oublier une connexion. Un assistant connecté par identification garde l’accès jusqu’à sa déconnexion dans Bulk & API, comme une clé vaut jusqu’à sa révocation.