Integrazione MCP

Server MCP di AFFiNE: collega gli strumenti IA alla tua base di conoscenza

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.

  • Credenziali per workspace, revocabili
  • Streamable HTTP + Bearer
  • 70K+ stelle su GitHub

Collega la base di conoscenza a un client IA compatibile

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».

Il server MCP di AFFiNE in sintesi

Che cos'èL'endpoint ufficiale del Model Context Protocol, integrato in AFFiNE Cloud e nelle istanze self-hosted
EndpointPOST /api/workspaces/{workspace-id}/mcp
TrasportoStreamable HTTP, senza stato
AutenticazioneCredenziale Bearer (prefisso aff_mcp_v1.), creata per client nelle impostazioni del workspace
Strumentidoc_search / read_document; READ_WRITE: development / canary
AmbitoUn workspace per credenziale, nel rispetto dei tuoi permessi sui documenti
PrezzoGratuito su AFFiNE Cloud e sulle istanze self-hosted con le funzioni IA attive

Il tuo workspace o la demo di contenuti pubblici?

Il tuo workspace

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}/mcp
  • doc_search
  • read_document

Contenuti pubblici del sito

Servizio 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/mcp
  • search_public_content
  • read_public_content
Public content API (English)

Collega un client MCP compatibile

Crea una credenziale in AFFiNE, poi configura il client nel suo formato.

  1. Apri le impostazioni MCP del workspace

    In AFFiNE vai su Impostazioni → Integrations → MCP Server. Funziona su AFFiNE Cloud e sulle istanze self-hosted con le funzioni IA attive.

  2. Crea una credenziale

    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.

  3. Incolla la configurazione nel client

    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.

Configurazione client per client

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.

Claude Code

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>"

Cursor

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>"
}
}
}
}

Cline

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>"
}
}
}
}

Client stdio locali, incluso Claude Desktop

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>"
}
}
}
}

Cosa può fare un assistente collegato

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.

Sola lettura

Default
doc_search
Ricerca documenti

Ricerca per parola chiave e semantica sui documenti del workspace; restituisce passaggi delimitati con localizzazione di pagina o canvas. Mai file, blob o web.

read_document
Leggi documento

Recupera il contenuto completo di un documento per ID, rispettando i tuoi permessi attuali.

Lettura e scrittura

Development / canary
create_document
Crea documento

Se abilitato, crea un documento da titolo e corpo Markdown. Non supporta l’inserimento di blocchi database o immagini.

update_document
Aggiorna documento

Se abilitato, aggiorna il corpo Markdown con differenze strutturali, senza cambiare il titolo. Non aggiorna blocchi database o immagini.

update_document_meta
Aggiorna metadati

Se abilitato, aggiorna il titolo del documento. Lo strumento verificato non espone altri campi di metadati.

Limitato al workspace

Una credenziale raggiunge sempre un solo workspace, con i tuoi permessi.

Una credenziale per client

Revoca l'accesso di un client senza toccare gli altri.

Scadenza integrata

Ogni credenziale riceve una data di scadenza alla creazione.

Rotazione dei token

Il vecchio token resta valido fino a 24 ore o alla scadenza originale, se precedente. La revoca può terminare l’accesso prima.

Il server MCP di AFFiNE a confronto

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.

AFFiNENotion MCPObsidian
Integrato, ufficialeSìUfficiale, integrato nell'app; credenziali nelle impostazioni del workspaceSìServer remoto ufficiale, ospitato da NotionNoPlugin della community o server di terze parti
Self-hosting possibileSìLo stesso endpoint ufficiale; attiva le funzioni IA sulla tua istanzaNoIl server attuale è solo hosted; un predecessore open source deprecato era self-hostabileDipendeLocalhost di default; il remoto è fai-da-te
Ricerca nelle lavagneSìLa ricerca indicizza il testo del canvas Edgeless e restituisce localizzazioni di elementi e riquadriNoNotion non ha una lavagna nativaNoI file .canvas si leggono solo come JSON grezzo; nessun server diffuso li cerca
Modello di distribuzioneCloud o self-hostedEndpoint ufficiale integrato in AFFiNE; in self-hosting vanno attivate le funzioni IASolo hostedIl server ufficiale attuale è ospitato da NotionLocaleI server della community girano accanto al vault desktop
PrezzoGratuitoGratuito su Cloud e in self-hosting con le funzioni IA attiveBase gratuitaRicerca nelle app collegate e note delle riunioni richiedono i piani Notion AIGratuitoSia 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.

Domande frequenti

Che cos'è il server MCP di AFFiNE?

È 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.

Il server MCP è gratuito?

Sì. È gratuito su AFFiNE Cloud e sulle istanze self-hosted con le funzioni IA attive. Il collegamento in sé non ha costi aggiuntivi.

Un'IA collegata può cercare nelle mie lavagne?

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.

Funziona con AFFiNE self-hosted?

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.

Posso limitarlo alla sola lettura?

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.

Quali strumenti IA possono collegarsi ad AFFiNE?

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.

Come viene protetto l'accesso?

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.

Metti al lavoro la tua base di conoscenza

Crea una credenziale nelle impostazioni del workspace e i tuoi strumenti IA iniziano oggi a rispondere dalle tue note.

Ultimo aggiornamento: 26 ottobre 2026