Guides
Connecter un client IA avec MCP
Autoriser un client IA à accéder à un espace via OAuth, avec les mêmes permissions sur les ressources que son membre.
Copier l’URL du connecteur
Dans Squario, ouvrez Compte → Applications connectées et copiez l’URL du serveur MCP. Ajoutez-la comme serveur MCP distant ou personnalisé dans un client compatible avec OAuth distant. Elle se termine par /functions/v1/mcp-server/mcp ; elle diffère de l’URL de base REST. Utilisez l’URL affichée dans l’application.
- Le client découvre le serveur, s’enregistre et ouvre l’écran de consentement.
- Connectez-vous, choisissez l’espace et approuvez l’accès.
- Le client reçoit les jetons OAuth et découvre les outils disponibles.
- Révoquez la connexion à tout moment depuis Compte → Applications connectées.
Une autorisation agit en votre nom
MCP utilise OAuth 2.1 avec PKCE, pas une clé API de membre. Ses jetons lient un membre à un espace. L’appartenance, squaria.mcp, la visibilité des fiches et les permissions par champ sont vérifiées à chaque appel. Les jetons d’accès durent une heure ; les jetons de rafraîchissement durent 30 jours et tournent à chaque utilisation. Le client doit gérer ce cycle.
Découvrir, valider, puis écrire
Commencez avec describe_resource ou describe_capabilities, puis lisez les fiches nécessaires. Utilisez validate_change avant une écriture. Les outils sont paramétrés par ressource et certifiés selon le schéma de l’espace.
| Objectif | Exemples |
|---|---|
| Fiches | list_records, get_record, resolve_reference, global_search |
| Découverte | describe_resource, describe_capabilities, list_data_models, list_custom_fields |
| Modifications | validate_change, create_record, update_record, archive_record, restore_record |
| Contexte de l’espace | list_forms, list_drive_items, list_audit_log, outils de connaissances |
| Vues et rapports | list_views, save_view, save_structural_view, run_report |
Approbation, crédits et limites
Utilisez les contrôles d’approbation des outils de votre client pour les écritures. Les appels MCP consomment des crédits IA, pas le quota REST ; un appel d’outil échoué est remboursé. Répéter une invocation crée un nouvel appel et une nouvelle consommation. Les limites par défaut sont 60/minute et 1 000/heure par membre et espace. Une limitation renvoie 429 avec Retry-After.
- Les outils Drive exposent les métadonnées, jamais le contenu des fichiers.
- MCP n’expose pas les actions de navigation ni de disposition de fiche propres à l’application.
- Les outils disponibles évoluent avec les versions du serveur. Utilisez la découverte du client comme contrat.