Per collegare Obsidian a Claude servono due pezzi: il plugin Local REST API dentro Obsidian e un server MCP che lo raggiunge. Con Claude Code il collegamento si fa con un solo comando; con Claude Desktop serve un ponte in più. Se ti basta far leggere le note a Claude, a volte non serve nessun connettore: basta aprire Claude Code nella cartella del vault.
In breve
- Il plugin Local REST API espone il vault in locale su
127.0.0.1, con una chiave API come credenziale. - Oggi le strade sono 2: il server MCP integrato nel plugin stesso (una ventina di strumenti), oppure il server esterno mcp-obsidian (7 strumenti).
- Claude Code si collega con
claude mcp add; Claude Desktop passa da un file di configurazione e, per il server integrato, da un ponte (mcp-remote). - Il connettore può scrivere e cancellare note: parti con un vault di prova e con una copia di sicurezza.
- Se Claude deve solo leggere e modificare file Markdown, la cartella del vault aperta in Claude Code è più semplice e non espone nessuna porta.
I numeri da tenere a mente
Dalle fonti ufficiali, consultate il 19 ottobre 2026:
- 7 strumenti in mcp-obsidian (README del progetto); il server integrato del plugin ne espone di più, tra lettura, scrittura, ricerca e comandi (README del plugin).
- 10 tentativi con credenziale errata in 60 secondi, poi errore 429 (README del plugin).
- 300 secondi (5 minuti) di validità predefinita per gli indirizzi firmati di download (README del plugin).
- 10.000 token per l’avviso e 25.000 token di limite predefinito sull’output di uno strumento MCP: l’avviso scatta già al 40% del limite. Una risposta HTTP non può superare 16 MiB (documentazione di Claude Code).
- Una connessione HTTP inattiva si chiude dopo 5 minuti, un processo locale (stdio) dopo 30 minuti: l’HTTP ha circa il 17% del tempo dello stdio, cioè l’83% in meno (documentazione di Claude Code, calcolo mio).
- Lo strumento di ricerca semplice del server integrato restituisce al massimo 20 file, con le prime 10 corrispondenze per ciascuno (README del plugin).
Come funziona il collegamento tra Obsidian e Claude
Obsidian è un’app che lavora su file Markdown in una cartella. Claude non vede quella cartella da solo: ha bisogno di un canale. MCP (Model Context Protocol) è il protocollo con cui Claude parla con strumenti esterni; il plugin Local REST API è ciò che permette a quegli strumenti di parlare con Obsidian.
Secondo il README del plugin (consultato il 19 ottobre 2026), l’endpoint sicuro risponde sulla porta 27124 in HTTPS, mentre la porta 27123 in HTTP è opzionale e la attivi tu nelle impostazioni. L’accesso alla cartella di configurazione .obsidian è bloccato per impostazione predefinita. Se una stessa origine presenta una credenziale sbagliata 10 volte in un minuto, le credenziali errate successive vengono rifiutate con errore 429 fino alla fine di quel minuto. Gli indirizzi firmati per scaricare file scadono per impostazione predefinita dopo 300 secondi.
Passo 1: installare il plugin Local REST API
- In Obsidian apri Impostazioni → Plugin della community → Sfoglia.
- Cerca «Local REST API», installa e attiva il plugin.
- Apri le impostazioni del plugin e copia la chiave API. Trattala come una password: chi la possiede può leggere e scrivere il tuo vault.
Il plugin genera una propria autorità di certificazione, che può garantire solo per 127.0.0.1, localhost e gli host che configuri tu. Per evitare avvisi puoi scaricarla da https://127.0.0.1:27124/obsidian-local-rest-api.crt e renderla attendibile sul tuo computer.
Strada A: il server MCP integrato nel plugin
Il README del plugin descrive un server MCP già incluso, raggiungibile su https://127.0.0.1:27124/mcp/ con trasporto Streamable HTTP e chiave API come bearer token. Gli strumenti coprono lettura, scrittura, aggiunta in coda, modifica per sezione, spostamento, copia e cancellazione dei file, ricerca, elenco dei tag e comandi di Obsidian.
Per Claude Code il comando, preso dal README del plugin, è:
claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ \
--header "Authorization: Bearer <la-tua-chiave-api>"Per Claude Desktop il README indica che serve mcp-remote come ponte, perché Claude Desktop non supporta in modo nativo i server MCP remoti su HTTP, da dichiarare nel file di configurazione di Claude Desktop; la sintassi esatta cambia con la versione, quindi copiala dalla pagina del plugin invece che da un articolo.
Strada B: il server esterno mcp-obsidian
Il progetto mcp-obsidian è un server MCP separato che usa il plugin come back-end. Richiede Python 3.11 o superiore e legge 3 variabili d’ambiente: OBSIDIAN_API_KEY, OBSIDIAN_HOST (predefinito 127.0.0.1) e OBSIDIAN_PORT (predefinita 27124).
La configurazione per Claude Desktop, dal README del progetto:
{
"mcpServers": {
"mcp-obsidian": {
"command": "uvx",
"args": ["mcp-obsidian"],
"env": {
"OBSIDIAN_API_KEY": "<la-tua-chiave-api>"
}
}
}
}Gli strumenti sono 7: elenco dei file del vault, elenco di una cartella, lettura di un file, ricerca, modifica relativa a un titolo, aggiunta in coda e cancellazione.
Per Claude Code lo stesso server si registra così, secondo la documentazione ufficiale:
claude mcp add --env OBSIDIAN_API_KEY=<la-tua-chiave-api> --transport stdio obsidian \
-- uvx mcp-obsidianIl doppio trattino separa le opzioni di Claude dal comando del server. E se subito dopo --env metti direttamente il nome del server, la CLI lo scambia per un’altra coppia chiave-valore e rifiuta il comando: per questo c’è --transport stdio in mezzo.
Quale strada scegliere
| Server integrato nel plugin | mcp-obsidian | |
|---|---|---|
| Cosa installi | Solo il plugin | Plugin + Python 3.11 o superiore e uvx |
| Strumenti | Più numerosi, inclusi comandi di Obsidian | 7, più semplici |
| Claude Code | Trasporto HTTP diretto | Processo locale (stdio) |
| Claude Desktop | Serve il ponte mcp-remote | Configurazione diretta |
| Superficie di rischio | Più ampia (comandi, file binari) | Più ridotta |
Se non sai da dove cominciare: Claude Code e un vault di prova, strada A. Se lavori soprattutto da Claude Desktop e vuoi pochi strumenti, strada B.
Verificare che funzioni
In Claude Code digita /mcp: apre il pannello dei server collegati, con il loro stato. Poi fai una prova che non può fallire in silenzio: chiedi a Claude di elencare le cartelle del vault e di leggere una nota che conosci. Se risponde con contenuti tuoi, il collegamento è vivo; se risponde in modo generico, non lo è, e conviene guardare il pannello prima di fidarsi.
Alcuni limiti da conoscere sui vault grandi, dalla documentazione di Claude Code (consultata il 19 ottobre 2026): l’output di uno strumento MCP genera un avviso oltre 10.000 token e il limite predefinito è 25.000 token; una risposta HTTP non può superare 16 MiB; una connessione HTTP inattiva viene chiusa dopo 5 minuti, un processo locale (stdio) dopo 30 minuti. Una nota molto lunga o una ricerca larga può quindi arrivare tagliata: meglio chiedere a Claude di leggere una nota alla volta.
Sicurezza: cosa può fare un connettore che scrive
La documentazione di Claude Code avverte di verificare di fidarsi di ogni server prima di collegarlo, perché i server che recuperano contenuti esterni espongono al rischio di prompt injection. Nel caso di un vault il rischio è concreto: una nota ricopiata da una pagina web può contenere istruzioni rivolte all’AI.
- Parti da un vault di prova o da una copia del tuo, non dal vault vero.
- Tieni la cancellazione sotto controllo: entrambi i server la includono tra gli strumenti.
- Non condividere il file di configurazione: contiene la chiave API. Gli scope di Claude Code sono 3 (
local,project,user) e lo scopeprojectsalva il server in un file pensato per il controllo di versione condiviso: per una chiave usalocal(predefinito) ouser. - Tieni una copia del vault con versioni: se un’azione sbaglia, torni indietro in un minuto.
È lo stesso ragionamento che applico a ogni agente che scrive: prima si decide dove l’AI non deve agire da sola, poi si accende. Ne parlo in Gate umano: dove un agente AI non deve mai decidere da solo.
Quando non serve nessun connettore
Un vault di Obsidian è una cartella di file Markdown. Claude Code lavora sui file della cartella in cui lo apri: se lo avvii nella cartella del vault, può leggere, cercare e modificare le note direttamente, senza plugin, senza chiave e senza porte aperte. Per molti usi (riassumere, riordinare, collegare note, preparare una bozza) è la scelta più semplice. Il connettore diventa utile quando vuoi che Claude Desktop veda il vault, o quando ti servono funzioni proprie di Obsidian come la nota attiva, i tag o i comandi.
Cosa ho imparato usandolo ogni giorno
Io il vault lo uso con Claude Code tutti i giorni, e scrivo le lezioni dei miei errori. La lezione che torna più spesso è questa: un collegamento che sembra attivo non è un collegamento provato. Un pannello che mostra il server come collegato non basta: se la risposta di Claude è generica, sta leggendo il modello, non le tue note. Per questo la prova è sempre la stessa, leggere una nota che conosci a memoria, prima di qualunque altra cosa.
La seconda lezione riguarda la scrittura. Un connettore che modifica le note va acceso dopo avere deciso dove l’AI può agire da sola, non prima: l’AI scrive solo dove puoi correggerla e dove hai una copia con versioni. Costruisco e uso ogni giorno un sistema di agenti AI sorvegliato da controlli automatici e test, e ho imparato che comodità e controllo vanno decisi nello stesso momento.
Chi manda in produzione agenti che toccano dati propri incontra gli stessi problemi, e li ho raccolti in Agenti AI in produzione: cosa si rompe davvero. Il quadro completo di come uso il vault è nell’articolo su Second Brain con Obsidian e Claude Code, e se ti chiedi quanto costa far girare più agenti insieme c’è il costo mensile reale di una flotta di agenti AI.
Domande frequenti
Come si collega Obsidian a Claude?
Installi il plugin Local REST API in Obsidian, copi la chiave API e registri un server MCP in Claude: con Claude Code, un comando claude mcp add; con Claude Desktop, una voce nel file di configurazione.
Claude può leggere le mie note di Obsidian senza MCP?
Sì, se usi Claude Code aperto nella cartella del vault: lavora direttamente sui file Markdown. Il connettore serve per Claude Desktop o per le funzioni specifiche di Obsidian.
Il collegamento è sicuro?
Il plugin lavora in locale e richiede una chiave API, ma i server MCP possono scrivere e cancellare. Prova prima su un vault di copia e tieni un backup.
Quale server MCP per Obsidian conviene?
Il server integrato nel plugin se usi Claude Code e vuoi più funzioni; mcp-obsidian (7 strumenti) se preferisci un set ridotto e la configurazione diretta in Claude Desktop.
Perché Claude Desktop non vede il server HTTP del plugin?
Secondo il README del plugin, Claude Desktop non supporta in modo nativo i server MCP remoti su HTTP e ha bisogno del ponte mcp-remote.
Fonti consultate il 19 ottobre 2026: README di Obsidian Local REST API, README di mcp-obsidian, documentazione MCP di Claude Code.
