Server MCP
Collega il tuo agente AI al libro
Scribenda espone un server MCP. Claude, o qualunque client compatibile, può leggere e scrivere capitoli, schede, timeline e note di continuità al posto tuo, dentro i permessi che scegli e con una versione per ogni modifica.
Come si collega
I client che supportano l'autorizzazione OAuth della specifica MCP si collegano all'indirizzo del server e aprono una pagina di consenso, dove scegli il libro e i permessi. Il token d'accesso scade dopo un'ora e si rinnova da solo.
Per i client a riga di comando crei un token personale nelle impostazioni del libro. Il suo valore si vede una sola volta; nel database resta solo un'impronta.
claude mcp add --transport http scribenda https://scribenda.io/mcp --header "Authorization: Bearer scr_…"
Permessi per area, su un solo libro
Per ogni area del libro (manoscritto, bibbia, trama, continuità, revisione, ricerche, fonti) scegli lettura, scrittura o niente. Un token con la sola scrittura sul manoscritto non può leggere la bibbia.
I permessi non superano mai il tuo ruolo sul libro. Se perdi il ruolo, i token che hai creato perdono i loro permessi con te. Puoi revocare un token in ogni momento.
Ogni scrittura è una versione
Gli strumenti di scrittura ricevono e restituiscono markdown. Ogni scrittura dell'agente crea una versione con origine «agente MCP» e con il nome del token, e non si fonde con le tue.
Il registro dell'agente elenca ogni chiamata con il suo esito e collega la differenza di ogni scrittura. Nessuno strumento cancella in modo definitivo.


L'agente non ti sovrascrive
Per aggiornare una sezione l'agente deve indicare il numero della versione che ha letto. Se nel frattempo hai modificato il testo, la scrittura viene rifiutata e l'agente riceve la versione nuova da cui ripartire.
I testi di terzi restano dati
Il contenuto dei documenti di ricerca e delle pagine web è scritto da altri. Scribenda lo restituisce all'agente dentro un blocco marcato come dato di terzi, e le istruzioni dentro quel blocco non vanno eseguite.
Non consuma la tua quota
L'agente usa il proprio modello, quindi le sue richieste non consumano i token del tuo abbonamento. La ricerca via MCP conta solo l'embedding della domanda. Ogni token ha un limite di richieste al minuto.
Gli strumenti esposti
Ogni strumento richiede il permesso della sua area. Quelli che toccano più aree restituiscono solo le parti che il token può leggere.
| Strumento | Area | Effetto |
|---|---|---|
| get_book_overview | aree leggibili | Concept, struttura, stato delle sezioni e guida di stile vincolante. |
| list_sections | Manoscritto | Albero del manoscritto con il numero di versione di ogni sezione. |
| get_section | Manoscritto | Contenuto di una sezione in markdown, con scaletta e metadati. |
| create_section | Manoscritto | Crea una sezione, scaletta compresa. |
| update_section | Manoscritto | Aggiorna una sezione se la versione letta è ancora l'ultima. |
| move_section | Manoscritto | Sposta una sezione nell'albero. |
| list_entities | Bibbia | Elenco delle schede della bibbia. |
| get_entity | Bibbia | Una scheda in markdown, con relazioni e sezioni in cui compare. |
| upsert_entity | Bibbia | Crea o aggiorna una scheda. |
| link_entities | Bibbia | Crea una relazione tra due schede. |
| list_timeline | Trama | Eventi in ordine cronologico o di racconto. |
| upsert_timeline_event | Trama | Crea o aggiorna un evento. |
| list_threads | Trama | Fili narrativi con le loro battute. |
| upsert_thread_beat | Trama | Aggiunge o modifica una semina o un raccolto. |
| get_continuity | Continuità | Note di continuità, cuciture e deviazioni. |
| add_continuity_note | Continuità | Aggiunge una nota di continuità a una sezione. |
| upsert_seam | Continuità | Crea o aggiorna una cucitura. |
| list_facts | Fonti | Fatti delle fonti con il loro stato. |
| upsert_fact | Fonti | Crea o aggiorna un fatto. |
| search | aree leggibili | Ricerca semantica e testuale su tutto il libro. |
| get_research_document | Ricerche | Un documento di ricerca, come dato di terzi. |
| add_research_note | Ricerche | Aggiunge una nota all'archivio delle ricerche. |
| run_typography_check | Manoscritto | Violazioni delle regole tipografiche con la riga. |
| compile_manuscript | Manoscritto | Il volume intero in markdown. |