Come collegare Obsidian a YouMind tramite MCP
Il tuo vault Obsidian potrebbe già contenere tutto ciò che ti serve per il tuo prossimo progetto: ricerche, piani, appunti di lettura e attività incomplete. Collegarlo a YouMind ti permette di trasformare quelle note in qualcosa di utilizzabile, con una semplice richiesta in linguaggio naturale.
In questa guida, collegherai un vault Obsidian locale a YouMind, chiederai a YouMind di leggere e organizzare una serie di appunti, e salverai il risultato di nuovo in Obsidian. L'esempio utilizza cinque note sull'alimentazione antinfiammatoria per creare un piano d'azione con collegamenti alle fonti originali.
Prima di iniziare
Ti serviranno:
- La versione desktop di Obsidian e un vault che puoi modificare.
- Un account YouMind con accesso ai connettori personalizzati.
- Un account ngrok. Useremo ngrok per dare al tuo server MCP locale un indirizzo HTTPS raggiungibile da YouMind.
- Qualche nota su cui lavorare. Puoi usare le tue ricerche, note di progetto o appunti per la pianificazione dei pasti.
La connessione funziona così:
YouMind → indirizzo HTTPS ngrok → Connettore MCP → il tuo vault Obsidian
MCP, acronimo di Model Context Protocol, permette a un'applicazione AI di utilizzare gli strumenti forniti da un'altra applicazione. Il plugin Obsidian espone strumenti per lavorare con il tuo vault, e YouMind li usa per eseguire la tua richiesta.
Mantieni il computer acceso e connesso a Internet, con Obsidian, il vault collegato e ngrok in esecuzione ogni volta che usi questa connessione. L'indirizzo locale 127.0.0.1 punta solo al tuo computer, quindi YouMind ha bisogno dell'indirizzo ngrok per raggiungerlo.
Il connettore può leggere o modificare le note in base ai permessi che gli concedi. Mantieni privato il suo token e utilizza le autorizzazioni degli strumenti del plugin e le impostazioni delle cartelle nascoste per controllare l'accesso. I contenuti utilizzati in un'attività passano attraverso ngrok e YouMind; collegare un vault non sincronizza automaticamente l'intero vault.
Gli screenshot mostrano il flusso di lavoro su macOS. Alcuni dettagli dell'account sono stati rimossi o sostituiti con valori di esempio.
1. Abilita i plugin della community in Obsidian
Apri Impostazioni → Plugin della community in Obsidian.
Se il tuo vault è in modalità Restretta, clicca su Esci dalla modalità Restretta per consentire i plugin della community.
Clicca su Sfoglia per aprire la directory dei plugin della community.
2. Installa e abilita MCP Connector
Cerca MCP Connector e seleziona il plugin di istefox. Controlla il nome dell'autore, poiché la directory include plugin con nomi simili.
Apri i suoi dettagli e clicca su Installa.
Dopo l'installazione, clicca su Abilita.
Apri MCP Connector nelle impostazioni di Obsidian per configurare il suo server locale e il token di accesso. Puoi trovare maggiori informazioni sulla pagina del plugin nella directory.
3. Imposta una porta fissa del server
Trova Porta fissa, inserisci 27200 e clicca su Salva.
La sezione Porta del server dovrebbe ora mostrare:
http://127.0.0.1:27200/mcp
Una porta fissa mantiene la tua connessione ngrok che punta allo stesso servizio locale. Se la porta 27200 è già in uso, scegli una porta disponibile e usa quel numero nel comando ngrok qui sotto.
4. Crea un token per YouMind
In Controllo accessi, clicca su Aggiungi token.
Assegna al nuovo token il nome YouMind in modo da poterlo riconoscere in seguito.
Clicca su Copia sulla riga di quel token. Lo incollerai in YouMind in un passaggio successivo.
Ogni token può avere le proprie autorizzazioni per gli strumenti. Questo esempio necessita dell'autorizzazione per leggere le note e crearne una nuova. Gli screenshot utilizzano la configurazione Tutti i 52 strumenti del plugin; il numero di strumenti disponibili può variare in base alla versione del plugin e alle tue impostazioni.
Tratta il token come una password per l'accesso che concede. Non è necessario incollarlo in una chat AI.
5. Avvia un tunnel ngrok
Se non hai ancora installato ngrok, segui le istruzioni di configurazione ufficiali. Su macOS, se usi già Homebrew, installalo con:
brew install ngrok
Aggiungi l'authtoken dalla tua dashboard ngrok:
ngrok config add-authtoken IL_TUO_NGROK_AUTHTOKEN
L'authtoken ngrok collega ngrok al tuo account. Il token Obsidian del passaggio precedente dà a YouMind accesso al tuo vault. Tieni separate queste due credenziali.
In Terminale, esegui:
ngrok httphttp://127.0.0.1:27200
Mantieni attiva questa sessione del terminale. Una volta che Stato sessione indica online, copia l'indirizzo HTTPS mostrato sulla riga Inoltro.
Aggiungi /mcp alla fine di quell'indirizzo. Il tuo URL finale del connettore dovrebbe avere questa struttura:
https://IL_TUO_DOMINIO_NGROK/mcp
Usa il dominio effettivo mostrato nella tua sessione ngrok. Il dominio nello screenshot è un esempio. Se il tuo indirizzo di inoltro cambia in seguito, aggiorna l'indirizzo salvato anche in YouMind.
6. Aggiungi il connettore personalizzato in YouMind
In YouMind, apri Impostazioni → Connettori e clicca su Aggiungi connettore personalizzato.
Inserisci un nome, ad esempio obsidian, e incolla il tuo indirizzo ngrok con /mcp alla fine. Espandi Impostazioni avanzate. Sotto Parametri personalizzati, clicca su Aggiungi parametro e configura quanto segue:
Impostazione | Valore |
|---|---|
Nome |
|
URL del server | Il tuo indirizzo HTTPS ngrok, seguito da |
OAuth Client ID | Lascia vuoto |
OAuth Client Secret | Lascia vuoto |
Parametro personalizzato |
|
Valore del parametro |
|
Segreto | On |
Sostituisci IL_TUO_TOKEN_OBSIDIAN con il token completo che hai copiato da Obsidian. Includi uno spazio dopo **Bearer**. Ad esempio, se il tuo token fosse token-di-esempio, il valore sarebbe:
Bearer token-di-esempio
Questo è solo un esempio di formato. Usa il tuo token nella configurazione effettiva. Questa connessione utilizza l'autenticazione Bearer Token, quindi lascia vuoti i due campi OAuth.
Clicca su Aggiungi, quindi trova obsidian nell'elenco dei connettori e clicca su Connetti.
Dovresti vedere Connesso accanto al suo nome.
Ora controlliamo la connessione con un'attività che legge le note e ne scrive una nuova.
7. Prepara alcune note correlate
YouMind ha bisogno di contenuti reali su cui lavorare. Per questo esempio, il vault contiene cinque note in inglese:
Nota | Cosa contiene |
|---|---|
Anti-Inflammatory Eating Basics | Principi generali di alimentazione e obiettivi per la prima settimana |
Anti-Inflammatory Grocery List | Una lista della spesa e sostituzioni di ingredienti |
7-Day Anti-Inflammatory Meal Plan | Una settimana di colazioni, pranzi e cene |
Simple Anti-Inflammatory Meal Prep | Passaggi di preparazione, ricette semplici e note di conservazione |
Anti-Inflammatory Weekly Review | Un modello di revisione e attività di follow-up non completate |
Queste note sono materiale di esempio per dimostrare il flusso di lavoro. Non costituiscono un piano medico o nutrizionale personalizzato.
Puoi usare un argomento diverso. Ad esempio, combina appunti di lettura in una guida allo studio, trasforma note di progetto in un elenco di prossimi passi, o organizza ricerche di viaggio in un itinerario. Aggiorna l'argomento nel prompt in modo che corrisponda alle note nel tuo vault.
8. Chiedi a YouMind di leggere, organizzare e salvare
Avvia una nuova attività in YouMind e inserisci:
Rivedi le mie note Obsidian sull'alimentazione antinfiammatoria. Riassumi i principi chiave, collega la lista della spesa con il piano alimentare e identifica tre attività in sospeso.
Salva il risultato in inglese come una nuova nota Obsidian intitolata "Anti-Inflammatory Eating Action Plan", con collegamenti interni alle note originali.
Il prompt dice a YouMind quali note leggere, come organizzare le informazioni, quali attività identificare e dove salvare il risultato. Nomina anche la nuova nota e richiede collegamenti alle fonti, rendendo l'output facile da verificare.
Invia l'attività. YouMind utilizzerà il connettore per trovare e leggere le note pertinenti, quindi metterà insieme il risultato. Puoi seguirne i progressi nella conversazione.
9. Apri la nuova nota in Obsidian
In questo esempio, YouMind ha restituito:
- Un riepilogo dei principi contenuti nella nota introduttiva.
- Collegamenti tra la lista della spesa e il piano alimentare, inclusi quali ingredienti compaiono in più pasti.
- Tre attività in sospeso: pianificare la spesa, scegliere pranzi e sessioni di preparazione, e completare la revisione successiva.
- Una nuova nota intitolata Anti-Inflammatory Eating Action Plan, con collegamenti interni alle cinque note originali.
Tutte le cose da fare completate si riferisce all'attività di lettura, organizzazione e scrittura di YouMind. La spesa e la preparazione dei pasti rimangono azioni di follow-up per la persona che utilizza il piano.
Torna a Obsidian e apri Anti-Inflammatory Eating Action Plan.
La nuova nota appare nell'elenco dei file e i suoi contenuti sono salvati nel tuo vault. In questa esecuzione, include anche tag e collegamenti cliccabili alle note originali. La vista grafico mostra quelle connessioni insieme alle note esistenti.
Ora puoi continuare a modificare in Obsidian o chiedere a YouMind di proseguire con una richiesta più specifica, come espandere una sezione o aggiornare il piano utilizzando un'altra nota.
Risoluzione dei problemi
Perché vedo 401 Non autorizzato?
Controlla il parametro Authorization. Il suo valore deve essere Bearer, seguito da uno spazio e dal tuo token Obsidian completo. Assicurati di aver copiato il token da MCP Connector. Se lo hai rigenerato o revocato, aggiorna il valore in YouMind.
Perché vedo "Rilevamento dei metadati del server di autorizzazione OAuth fallito (404)"?
Un controllo del token non riuscito può indurre il client a tentare il rilevamento OAuth. Questa connessione plugin utilizza un Bearer Token, quindi controlla prima l'intestazione Authorization e mantieni vuoti i campi OAuth Client ID e Secret. Un prefisso Bearer mancante può produrre questo errore.
Perché l'apertura dell'URL /mcp in un browser restituisce 405?
L'endpoint MCP del plugin accetta richieste MCP tramite POST. L'apertura di un URL nella barra degli indirizzi di un browser normalmente invia GET, che può restituire 405 Metodo non consentito. Verifica la connessione tramite YouMind e un'attività effettiva.
Perché una connessione funzionante ha smesso di rispondere?
Controlla che il computer sia acceso e online, che Obsidian abbia aperto il vault corretto, che il plugin sia abilitato e che ngrok mostri ancora online. Quindi confronta la porta locale e l'URL ngrok con i valori salvati in YouMind.
Cosa succede se non riesco a trovare la nuova nota?
Cerca nel vault collegato il titolo che hai specificato nel prompt. Verifica che il token permetta di creare note. Puoi anche chiedere a YouMind il percorso esatto relativo al vault del file che ha creato, quindi aprire quel percorso in Obsidian.
Pronto a provarlo con le tue note? Apri YouMind e chiedigli di trasformare alcune note correlate in una nuova pagina utile nel tuo vault.