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.

Il registro delle azioni di un agente collegato via MCP.

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.

La differenza prodotta da una scrittura dell'agente.
La differenza prodotta da una scrittura dell'agente.
Le versioni di una sezione, con l'origine di ogni modifica.
Le versioni di una sezione, con l'origine di ogni modifica.

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.

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