Comment connecter Obsidian à YouMind avec MCP
Votre coffre Obsidian contient peut-être déjà tout ce dont vous avez besoin pour votre prochain projet : recherches, plans, notes de lecture et tâches inachevées. En le connectant à YouMind, vous pouvez transformer ces notes en quelque chose d'utilisable, avec une simple requête en langage naturel.
Dans ce guide, vous allez connecter un coffre Obsidian local à YouMind, demander à YouMind de lire et d'organiser un ensemble de notes, puis enregistrer le résultat dans Obsidian. L'exemple utilise cinq notes sur l'alimentation anti-inflammatoire pour créer un plan d'action avec des liens vers les sources originales.
Avant de commencer
Vous aurez besoin de :
- La version de bureau d'Obsidian et d'un coffre que vous pouvez modifier.
- Un compte YouMind avec accès aux connecteurs personnalisés.
- Un compte ngrok. Nous utiliserons ngrok pour donner à votre serveur MCP local une adresse HTTPS que YouMind peut atteindre.
- Quelques notes avec lesquelles travailler. Vous pouvez utiliser vos propres recherches, notes de projet ou notes de planification de repas.
La connexion fonctionne de cette manière :
YouMind → adresse HTTPS ngrok → Connecteur MCP → votre coffre Obsidian
MCP, abréviation de Model Context Protocol, permet à une application d'IA d'utiliser les outils fournis par une autre application. Le plugin Obsidian expose des outils pour travailler avec votre coffre, et YouMind les utilise pour exécuter votre requête.
Gardez votre ordinateur allumé et connecté à Internet, avec Obsidian, le coffre connecté et ngrok en cours d'exécution chaque fois que vous utilisez cette connexion. L'adresse locale 127.0.0.1 ne pointe que vers votre propre ordinateur, donc YouMind a besoin de l'adresse ngrok pour l'atteindre.
Le connecteur peut lire ou modifier les notes selon les autorisations que vous lui accordez. Gardez son jeton privé et utilisez les autorisations d'outils du plugin et les paramètres de dossier caché pour contrôler l'accès. Le contenu utilisé dans une tâche transite par ngrok et YouMind ; connecter un coffre ne synchronise pas automatiquement l'ensemble du coffre.
Les captures d'écran montrent le flux de travail sur macOS. Certains détails du compte ont été supprimés ou remplacés par des valeurs d'exemple.
1. Autoriser les plugins communautaires dans Obsidian
Ouvrez Paramètres → Plugins communautaires dans Obsidian.
Si votre coffre est en mode Restreint, cliquez sur Quitter le mode restreint pour autoriser les plugins communautaires.
Cliquez sur Parcourir pour ouvrir le répertoire des plugins communautaires.
2. Installer et activer MCP Connector
Recherchez MCP Connector et sélectionnez le plugin par istefox. Vérifiez le nom de l'auteur, car le répertoire inclut des plugins avec des noms similaires.
Ouvrez ses détails et cliquez sur Installer.
Après l'installation, cliquez sur Activer.
Ouvrez MCP Connector dans les paramètres d'Obsidian pour configurer son serveur local et son jeton d'accès. Vous pouvez trouver plus d'informations sur la page du répertoire du plugin.
3. Définir un port de serveur fixe
Trouvez Port fixe, entrez 27200 et cliquez sur Enregistrer.
La section Port du serveur devrait maintenant afficher :
http://127.0.0.1:27200/mcp
Un port fixe permet à votre connexion ngrok de pointer vers le même service local. Si le port 27200 est déjà utilisé, choisissez un port disponible et utilisez ce numéro dans la commande ngrok ci-dessous.
4. Créer un jeton pour YouMind
Dans Contrôle d'accès, cliquez sur Ajouter un jeton.
Nommez le nouveau jeton YouMind afin de pouvoir le reconnaître plus tard.
Cliquez sur Copier sur la ligne de ce jeton. Vous le collerez dans YouMind à une étape ultérieure.
Chaque jeton peut avoir ses propres autorisations d'outils. Cet exemple a besoin d'autorisation pour lire les notes et créer une nouvelle note. Les captures d'écran utilisent la configuration Tous les 52 outils du plugin ; le nombre d'outils disponibles peut changer avec la version du plugin et vos paramètres.
Traitez le jeton comme un mot de passe pour l'accès qu'il accorde. Vous n'avez pas besoin de le coller dans un chat IA.
5. Démarrer un tunnel ngrok
Si vous n'avez pas encore installé ngrok, suivez les instructions d'installation officielles. Sur macOS, si vous utilisez déjà Homebrew, installez-le avec :
brew install ngrok
Ajoutez l'authtoken depuis votre tableau de bord ngrok :
ngrok config add-authtoken VOTRE_AUTHTOKEN_NGROK
L'authtoken ngrok connecte ngrok à votre compte. Le jeton Obsidian de l'étape précédente donne à YouMind l'accès à votre coffre. Gardez ces deux identifiants séparés.
Dans le Terminal, exécutez :
ngrok httphttp://127.0.0.1:27200
Gardez cette session de terminal en cours d'exécution. Une fois que le Statut de la session indique en ligne, copiez l'adresse HTTPS affichée sur la ligne Transfert.
Ajoutez /mcp à la fin de cette adresse. L'URL finale de votre connecteur doit avoir cette structure :
https://VOTRE_DOMAINE_NGROK/mcp
Utilisez le domaine réel affiché dans votre propre session ngrok. Le domaine dans la capture d'écran est un exemple. Si votre adresse de transfert change plus tard, mettez également à jour l'adresse enregistrée dans YouMind.
6. Ajouter le connecteur personnalisé dans YouMind
Dans YouMind, ouvrez Paramètres → Connecteurs et cliquez sur Ajouter un connecteur personnalisé.
Entrez un nom, par exemple obsidian, et collez votre adresse ngrok avec /mcp à la fin. Développez Paramètres avancés. Sous Paramètres personnalisés, cliquez sur Ajouter un paramètre et configurez les éléments suivants :
Paramètre | Valeur |
|---|---|
Nom |
|
URL du serveur | Votre adresse HTTPS ngrok, suivie de |
ID client OAuth | Laissez vide |
Secret client OAuth | Laissez vide |
Paramètre personnalisé |
|
Valeur du paramètre |
|
Secret | Activé |
Remplacez VOTRE_JETON_OBSIDIAN par le jeton complet que vous avez copié depuis Obsidian. Incluez un espace après **Bearer**. Par exemple, si votre jeton était exemple-jeton, la valeur serait :
Bearer exemple-jeton
Ceci n'est qu'un exemple de format. Utilisez votre propre jeton dans la configuration réelle. Cette connexion utilise l'authentification par jeton Bearer, alors laissez les deux champs OAuth vides.
Cliquez sur Ajouter, puis trouvez obsidian dans la liste des connecteurs et cliquez sur Connecter.
Vous devriez voir Connecté à côté de son nom.
Vérifions maintenant la connexion avec une tâche qui lit des notes et en écrit une nouvelle.
7. Préparer quelques notes connexes
YouMind a besoin de contenu réel pour travailler. Pour cet exemple, le coffre contient cinq notes en anglais :
Note | Ce qu'elle contient |
|---|---|
Anti-Inflammatory Eating Basics | Principes généraux de l'alimentation et objectifs pour la première semaine |
Anti-Inflammatory Grocery List | Une liste de courses et des substitutions d'ingrédients |
7-Day Anti-Inflammatory Meal Plan | Une semaine de petits-déjeuners, déjeuners et dîners |
Simple Anti-Inflammatory Meal Prep | Étapes de préparation, recettes simples et notes de conservation |
Anti-Inflammatory Weekly Review | Un modèle de révision et des tâches de suivi non terminées |
Ces notes sont un exemple de matériel pour démontrer le flux de travail. Il ne s'agit pas d'un plan médical ou nutritionnel personnalisé.
Vous pouvez utiliser un sujet différent. Par exemple, combinez des notes de lecture en un guide d'étude, transformez des notes de projet en une liste de prochaines étapes, ou organisez des recherches de voyage en un itinéraire. Mettez à jour le sujet dans l'invite pour qu'il corresponde aux notes de votre coffre.
8. Demander à YouMind de lire, organiser et enregistrer
Démarrez une nouvelle tâche dans YouMind et saisissez :
Passe en revue mes notes Obsidian sur l'alimentation anti-inflammatoire. Résume les principes clés, relie la liste de courses au plan de repas et identifie trois tâches en suspens.
Enregistre le résultat en anglais dans une nouvelle note Obsidian intitulée "Anti-Inflammatory Eating Action Plan", avec des liens internes vers les notes sources.
L'invite indique à YouMind quelles notes lire, comment organiser les informations, quelles tâches identifier et où enregistrer le résultat. Elle nomme également la nouvelle note et demande des liens vers les sources, ce qui facilite la vérification du résultat.
Soumettez la tâche. YouMind utilisera le connecteur pour trouver et lire les notes pertinentes, puis assemblera le résultat. Vous pouvez suivre sa progression dans la conversation.
9. Ouvrir la nouvelle note dans Obsidian
Dans cet exemple, YouMind a renvoyé :
- Un résumé des principes de la note d'introduction.
- Des liens entre la liste de courses et le plan de repas, y compris les ingrédients qui apparaissent dans plusieurs repas.
- Trois tâches en suspens : planifier la visite au supermarché, choisir les déjeuners et les sessions de préparation, et effectuer la révision par la suite.
- Une nouvelle note intitulée Anti-Inflammatory Eating Action Plan, avec des liens internes vers les cinq notes originales.
Toutes les tâches terminées fait référence à la tâche de lecture, d'organisation et d'écriture de YouMind. Les courses et la préparation des repas restent des actions de suivi pour la personne qui utilise le plan.
Revenez à Obsidian et ouvrez Anti-Inflammatory Eating Action Plan.
La nouvelle note apparaît dans la liste des fichiers et son contenu est enregistré dans votre coffre. Dans cette exécution, elle inclut également des tags et des liens cliquables vers les notes originales. La vue Graphique montre ces connexions à côté des notes existantes.
Vous pouvez maintenant continuer à éditer dans Obsidian ou demander à YouMind de continuer avec une requête plus spécifique, comme développer une section ou mettre à jour le plan en utilisant une autre note.
Dépannage
Pourquoi vois-je 401 Non autorisé ?
Vérifiez le paramètre Authorization. Sa valeur doit être Bearer, suivie d'un espace et de votre jeton Obsidian complet. Assurez-vous d'avoir copié le jeton depuis MCP Connector. Si vous l'avez régénéré ou révoqué, mettez à jour la valeur dans YouMind.
Pourquoi vois-je « Échec de la découverte des métadonnées du serveur d'autorisation OAuth (404) » ?
Une vérification de jeton infructueuse peut amener le client à tenter une découverte OAuth. Cette connexion de plugin utilise un jeton Bearer, alors vérifiez d'abord l'en-tête Authorization et laissez les champs ID client OAuth et Secret client OAuth vides. Un préfixe Bearer manquant peut produire cette erreur.
Pourquoi l'ouverture de l'URL /mcp dans un navigateur renvoie-t-elle 405 ?
Le point de terminaison MCP du plugin accepte les requêtes MCP via POST. L'ouverture d'une URL dans la barre d'adresse d'un navigateur envoie normalement GET, ce qui peut renvoyer 405 Méthode non autorisée. Vérifiez la connexion via YouMind et une tâche réelle.
Pourquoi une connexion qui fonctionnait a-t-elle cessé de répondre ?
Vérifiez que votre ordinateur est allumé et en ligne, qu'Obsidian a le bon coffre ouvert, que le plugin est activé et que ngrok affiche toujours en ligne. Comparez ensuite le port local et l'URL ngrok avec les valeurs enregistrées dans YouMind.
Que faire si je ne trouve pas la nouvelle note ?
Recherchez dans le coffre connecté le titre que vous avez spécifié dans l'invite. Vérifiez que le jeton autorise la création de notes. Vous pouvez également demander à YouMind le chemin exact relatif au coffre du fichier qu'il a créé, puis ouvrir ce chemin dans Obsidian.
Prêt à essayer avec vos propres notes ? Ouvrez YouMind et demandez-lui de transformer quelques notes connexes en une nouvelle page utile dans votre coffre.