Choisir entre interface, import, API et MCP
Choisissez la connexion selon l’action à réaliser. Modifier dans Boldo, importer un fichier, exécuter une synchronisation et connecter un client IA impliquent des contrôles différents.
Associer le besoin au bon outil
| Votre objectif | Utiliser | Ce qui contrôle le résultat |
|---|---|---|
| Corriger quelques actifs ou examiner une suggestion | L’interface Boldo | Vos droits, le contexte sélectionné et l’étape d’enregistrement ou de confirmation de l’action. |
| Charger un tableau ou rapprocher un fichier des actifs existants | L’import de fichier | Les clés de correspondance, les colonnes associées et l’aperçu que vous validez. |
| Lire régulièrement Boldo depuis un autre système | Les lectures API | Une clé API, la pagination, les filtres et la synchronisation que vous développez. |
| Créer ou modifier des données depuis un autre système | Les écritures API | Les droits effectifs de la clé et la requête exacte envoyée. |
| Autoriser une IA externe à lire des données, envoyer des suggestions ou modifier directement des données | MCP | Votre niveau MCP, vos droits métier, les réglages de l’organisation et le consentement OAuth. |
| Utiliser votre propre service de modèle dans l’assistant Boldo | Un endpoint IA auto-hébergé | Les paramètres IA, la compatibilité du service et les capacités du modèle. |
L’API échange des données structurées avec votre programme. Celui-ci planifie la synchronisation et gère les échecs. Boldo ne propose pas de planification universelle des synchronisations sur l’écran des clés API.
MCP fournit des outils de lecture et, selon les autorisations, de suggestion ou d’écriture directe à un client externe compatible. Les suggestions attendent une validation dans Boldo. Les écritures directes ne créent pas de carte de proposition IA dans le chat Boldo. Configurer un endpoint de modèle change le fournisseur utilisé dans Boldo ; cela ne connecte pas les outils d’un client externe.
Préparer la connexion
- Identifiez l’organisation cible et le contexte souhaité : données réelles ou scénario.
- Déterminez si vous devez uniquement lire ou également écrire.
- Vérifiez l’offre et les droits nécessaires à la connexion choisie.
- Commencez par une lecture limitée, sur un actif ou un type connu.
- Contrôlez l’organisation, les identifiants et les champs visibles avant d’étendre l’intégration.
- Pour les écritures, testez un petit ensemble identifiable et relisez le résultat enregistré.
Une clé API appartient à une organisation. MCP utilise l’organisation sélectionnée lors du consentement OAuth. Être connecté à Boldo dans un navigateur ne donne pas automatiquement accès à ces connexions.
Prévoir les mises à jour et les accès
Utilisez des identifiants d’actifs stables ou des propriétés de clé unique pour rapprocher les enregistrements entre systèmes. Les noms seuls ne sont pas des identifiants fiables. Décidez quel système fait référence pour chaque champ afin d’éviter des écrasements répétés entre deux intégrations.
Les écritures API prennent effet lorsque la requête réussit, sans confirmation supplémentaire dans Boldo. L’import possède sa propre procédure d’aperçu et de validation. Une réponse réseau perdue ne prouve pas l’échec de l’écriture : relisez l’état avant de répéter la requête.
Pour une intégration régulière, documentez son titulaire et la procédure de remplacement ou de révocation des accès. Clés API et consentement MCP utilisent des mécanismes différents ; une clé API v1 ne remplace pas OAuth pour MCP.
Si une donnée manque, vérifiez les droits et le contexte avant de la considérer comme supprimée. Pour une copie externe fiable, tenez compte des archives, des relations et de la qualité selon la procédure de lecture et synchronisation.