Connecter SmartNotes à Cradle

Envoyez les notes capturées dans la boîte de réception partagée de Cradle via MCP, où les agents de triage classifient les issues et les acheminent vers le bon projet.

SmartNotes est conçu pour travailler avec Cradle comme couche de capture. Il ne remplace pas le système de risque et de triage de Cradle — il lui fournit des issues propres et structurées.

Comment fonctionne l'intégration

SmartNotes agit comme client MCP de Cradle. Une fois connecté, il peut appeler deux outils :

cradle_summarize_notes — nettoie et résume un lot de notes, renvoie des cartes d'issues.
cradle_submit_issue — crée un ticket dans la boîte de réception partagée de Cradle pour révision opérateur.

Le flux inclut intentionnellement un humain dans la boucle :

Vous capturez des notes dans SmartNotes.
Vous sélectionnez des notes et cliquez sur Résumer. SmartNotes appelle cradle_summarize_notes et affiche des cartes d'issues.
Vous révisez les cartes d'issues et soumettez celles que vous voulez. SmartNotes appelle cradle_submit_issue.
Cradle crée un ticket, exécute le triage sur tous les projets et achemine l'issue vers le projet de l'agent gagnant.
Un opérateur humain approuve, modifie ou rejette le ticket avant qu'un quelconque auto-réponse ne soit envoyé.

Il n'y a pas d'envoi automatique depuis SmartNotes. Chaque issue soumise arrive en révision opérateur.

Configurer la connexion

Dans SmartNotes Paramètres → Cradle :

Activez le client MCP Cradle.
Saisissez l'URL du serveur Cradle, par exemple http://127.0.0.1:31416/mcp pour un serveur local.
Saisissez une clé API Cradle avec au moins les scopes agents:execute et messages:write. Une clé admin:* fonctionne aussi.
Cliquez sur Ping pour vérifier la connexion.

Si la connexion est active, l'interface principale de Cradle affiche un onglet SmartNotes Inbox et peut importer les notes automatiquement.

Configuration requise côté Cradle

Côté Cradle, le serveur MCP doit être activé :

Dans Cradle desktop : Intégrations → Serveur MCP.
Choisissez un hôte et un port. La valeur par défaut pour le serveur MCP de Cradle est 127.0.0.1:31417.
Sauvegardez et démarrez.

SmartNotes se connecte ensuite à ce endpoint. Les deux applications peuvent fonctionner sur la même machine ou sur le même LAN de confiance.

Sécurité

Les clés API Cradle sont stockées dans smartnotes-secrets.json, chiffrées via Electron safeStorage.
La communication se fait en HTTP ou HTTPS selon la façon dont Cradle est exposé.
SmartNotes n'envoie les captures d'écran ou les transcriptions nulle part ailleurs que vers le serveur Cradle configuré.
Les vérifications de scope normales de Cradle s'appliquent : la clé doit avoir agents:execute pour le résumé et messages:write pour soumettre des issues.

Dépannage

Symptôme	Cause	Solution
« Connection failed »	Mauvaise URL ou serveur MCP Cradle non démarré	Vérifiez l'hôte/le port et que le serveur MCP est activé dans Cradle.
« Unauthorized »	Clé invalide ou révoquée	Créez une nouvelle clé dans Cradle Intégrations → Clés API.
Le résumé ne renvoie pas d'issues	Notes vides ou échec du modèle	Capturez au moins une note avec une parole claire et vérifiez que le modèle Whisper est téléchargé.
Les issues soumises n'apparaissent pas	Mismatch de projet ou mauvais scopes	Utilisez une clé `admin:*` pour les tests, puis passez à une clé scoped liée au bon projet.