L’endpoint MCP di AFFiNE consente ai client IA compatibili di cercare note e testo delle lavagne e leggere documenti. L’accesso diretto richiede Streamable HTTP e header Bearer; i client con stdio locale possono usare un ponte locale.
MCP è uno standard aperto per collegare assistenti a strumenti e dati. Le istanze compatibili di AFFiNE Cloud e self-hosted includono un endpoint per workspace. L’accesso diretto richiede Streamable HTTP e un header Authorization. I client solo stdio richiedono un ponte locale come mcp-remote.
Una volta collegato, un assistente può eseguire ricerche per parola chiave e semantiche su tutta la base di conoscenza, lavagne comprese, e leggere interi documenti — con esattamente i permessi che concedi tu, niente di più. Ogni client riceve la propria credenziale, che puoi ruotare o revocare in modo indipendente: «la mia IA vede le mie note» non deve mai diventare «tutto, per sempre».
| Che cos'è | L'endpoint ufficiale del Model Context Protocol, integrato in AFFiNE Cloud e nelle istanze self-hosted |
|---|---|
| Endpoint | POST /api/workspaces/{workspace-id}/mcp |
| Trasporto | Streamable HTTP, senza stato |
| Autenticazione | Credenziale Bearer (prefisso aff_mcp_v1.), creata per client nelle impostazioni del workspace |
| Strumenti | doc_search / read_document; READ_WRITE: development / canary |
| Ambito | Un workspace per credenziale, nel rispetto dei tuoi permessi sui documenti |
| Prezzo | Gratuito su AFFiNE Cloud e sulle istanze self-hosted con le funzioni IA attive |
AFFiNE Cloud o una tua istanza compatibile. Richiede una credenziale Bearer del workspace e rispetta i permessi sui documenti. Di seguito gli strumenti di lettura predefiniti; la disponibilità dipende dall’istanza.
https://app.affine.pro/api/workspaces/{workspace-id}/mcpdoc_searchread_documentServizio separato di lettura di articoli e modelli pubblicati, senza account o credenziali. Non accede al tuo workspace e non scrive documenti. Non inviare mai la credenziale del workspace a questo endpoint.
https://affine.pro/api/public/mcpsearch_public_contentread_public_contentCrea una credenziale in AFFiNE, poi configura il client nel suo formato.
In AFFiNE vai su Impostazioni → Integrations → MCP Server. Funziona su AFFiNE Cloud e sulle istanze self-hosted con le funzioni IA attive.
Clicca 'Create credential', assegna un'etichetta (una per client, ad esempio 'Claude Code' o 'Cursor'), poi scegli la modalità di accesso e una scadenza. Sola lettura è l'impostazione predefinita.
Copia endpoint e credenziale da AFFiNE. Il token viene mostrato una sola volta. Usa l’esempio del tuo client: non tutti accettano lo stesso JSON.
{
"mcpServers": {
"affine_workspace_<workspace-id>": {
"type": "streamable-http",
"url": "https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"headers": { "Authorization": "Bearer aff_mcp_v1...." }
}
}
}
Formato generato da AFFiNE, da adattare al client. Le istanze self-hosted usano il proprio indirizzo.
Controlla trasporto e autenticazione. Claude Code, Cursor e Cline supportano HTTP con header Bearer. Un’interfaccia che accetta solo OAuth non può usare questa credenziale creata manualmente. Il ponte stdio richiede un client capace di avviare processi locali.
Aggiungi AFFiNE con un comando CLI, poi chiedi a Claude di cercare o leggere il tuo workspace da qualsiasi sessione.
claude mcp add --transport http affine \
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp" \
--header "Authorization: Bearer <your-credential>"Aggiungi URL e headers dell’esempio a ~/.cursor/mcp.json. Usa i valori copiati dal tuo workspace; i formati JSON variano tra client.
{
"mcpServers": {
"affine": {
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}Apri le impostazioni MCP di Cline e aggiungi AFFiNE come server Streamable HTTP remoto.
{
"mcpServers": {
"affine": {
"type": "streamableHttp",
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}Questa configurazione avvia il ponte di terze parti mcp-remote in un client capace di avviare processi stdio locali. Serve una versione compatibile di Node.js. Non è un connettore OAuth di Claude sul web.
{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"--header",
"Authorization:${AFFINE_MCP_AUTH}"
],
"env": {
"AFFINE_MCP_AUTH": "Bearer <your-credential>"
}
}
}
}La sola lettura è il valore predefinito. L’implementazione verificata il 26 ottobre 2026 limita credenziali e strumenti di scrittura agli ambienti di sviluppo o canary. Questo non dimostra la disponibilità nel Cloud stabile. Controlla la modalità di accesso e tools/list della tua istanza.
doc_searchRicerca per parola chiave e semantica sui documenti del workspace; restituisce passaggi delimitati con localizzazione di pagina o canvas. Mai file, blob o web.
read_documentRecupera il contenuto completo di un documento per ID, rispettando i tuoi permessi attuali.
create_documentSe abilitato, crea un documento da titolo e corpo Markdown. Non supporta l’inserimento di blocchi database o immagini.
update_documentSe abilitato, aggiorna il corpo Markdown con differenze strutturali, senza cambiare il titolo. Non aggiorna blocchi database o immagini.
update_document_metaSe abilitato, aggiorna il titolo del documento. Lo strumento verificato non espone altri campi di metadati.
Una credenziale raggiunge sempre un solo workspace, con i tuoi permessi.
Revoca l'accesso di un client senza toccare gli altri.
Ogni credenziale riceve una data di scadenza alla creazione.
Il vecchio token resta valido fino a 24 ore o alla scadenza originale, se precedente. La revoca può terminare l’accesso prima.
Ormai molti strumenti per le note parlano MCP. La differenza sta in cosa il server può raggiungere, dove gira e chi lo controlla. Ecco il confronto con le due configurazioni più richieste.
| AFFiNE | Notion MCP | Obsidian | |
|---|---|---|---|
| Integrato, ufficiale | SìUfficiale, integrato nell'app; credenziali nelle impostazioni del workspace | SìServer remoto ufficiale, ospitato da Notion | NoPlugin della community o server di terze parti |
| Self-hosting possibile | SìLo stesso endpoint ufficiale; attiva le funzioni IA sulla tua istanza | NoIl server attuale è solo hosted; un predecessore open source deprecato era self-hostabile | DipendeLocalhost di default; il remoto è fai-da-te |
| Ricerca nelle lavagne | SìLa ricerca indicizza il testo del canvas Edgeless e restituisce localizzazioni di elementi e riquadri | NoNotion non ha una lavagna nativa | NoI file .canvas si leggono solo come JSON grezzo; nessun server diffuso li cerca |
| Modello di distribuzione | Cloud o self-hostedEndpoint ufficiale integrato in AFFiNE; in self-hosting vanno attivate le funzioni IA | Solo hostedIl server ufficiale attuale è ospitato da Notion | LocaleI server della community girano accanto al vault desktop |
| Prezzo | GratuitoGratuito su Cloud e in self-hosting con le funzioni IA attive | Base gratuitaRicerca nelle app collegate e note delle riunioni richiedono i piani Notion AI | GratuitoSia l'app sia i server della community |
Confronto basato su capacità documentate pubblicamente, ad agosto 2026.
I server MCP di Obsidian basati su API REST richiedono l'app desktop in esecuzione. La CLI di Obsidian (2026) è un'interfaccia ufficiale di automazione, ma non è MCP.
È l'endpoint ufficiale del Model Context Protocol integrato in AFFiNE. Permette ad assistenti IA come Claude, Cursor e Cline di cercare e leggere i documenti di uno dei tuoi workspace AFFiNE tramite una connessione HTTP standard e autenticata, con credenziali che crei e controlli nelle impostazioni del workspace.
Sì. È gratuito su AFFiNE Cloud e sulle istanze self-hosted con le funzioni IA attive. Il collegamento in sé non ha costi aggiuntivi.
Sì. doc_search copre allo stesso modo documenti di pagina e lavagne Edgeless: il testo sul canvas viene indicizzato e i risultati portano localizzazioni di blocco, elemento o riquadro — l'assistente può indicare in quale punto della lavagna si trova la risposta. La lettura integrale restituisce il contenuto delle pagine; il contenuto delle lavagne emerge dalla ricerca. La maggior parte dei server MCP per le note vede solo testo semplice.
Sì. L'endpoint MCP ufficiale è disponibile sulle istanze AFFiNE self-hosted: vive sull'indirizzo del tuo server e la configurazione è identica (Impostazioni → Integrations → MCP Server). Le funzioni IA devono essere attive sull'istanza.
La sola lettura è il valore predefinito. L’implementazione verificata il 26 ottobre 2026 limita credenziali e strumenti di scrittura agli ambienti di sviluppo o canary. Questo non dimostra la disponibilità nel Cloud stabile. Controlla la modalità di accesso e tools/list della tua istanza.
Controlla trasporto e autenticazione. Claude Code, Cursor e Cline supportano HTTP con header Bearer. Un’interfaccia che accetta solo OAuth non può usare questa credenziale creata manualmente. Il ponte stdio richiede un client capace di avviare processi locali.
Una credenziale raggiunge sempre un solo workspace, con i tuoi permessi. Revoca l'accesso di un client senza toccare gli altri. Ogni credenziale riceve una data di scadenza alla creazione. Il vecchio token resta valido fino a 24 ore o alla scadenza originale, se precedente. La revoca può terminare l’accesso prima.
Crea una credenziale nelle impostazioni del workspace e i tuoi strumenti IA iniziano oggi a rispondere dalle tue note.
Ultimo aggiornamento: 26 ottobre 2026