cobrain
Guide · riferimento

Gli strumenti della tua AI

Un'AI collegata a Cobrain ha ventitré strumenti: quindici per leggere, cercare e farsi guidare, sette per scrivere e riordinare, uno per cancellare. Tutti lavorano con i tuoi permessi: quello che tu non puoi fare, non può farlo nemmeno lei.

Il connettore

Un server MCP remoto standard, con OAuth 2.1. Un indirizzo solo, per tutte le AI.

https://cobrain.space/mcp

Protocollo MCP su HTTP (Streamable HTTP). Il programma si registra da solo, l'utente autorizza su una pagina di Cobrain che dice cosa il programma potrà fare, e riceve un permesso che scade e si rinnova. Nessuna chiave API. Ogni strumento gira con l'identità dell'utente che ha autorizzato: le stesse regole del sito, applicate dal database.

Per un programma che non ha una guida

Incolla questo messaggio nella conversazione: contiene nome del server, indirizzo e tipo di autenticazione. Molti programmi si configurano da soli, gli altri ti dicono dove aggiungerlo.

Aggiungi al tuo ambiente il server MCP remoto "cobrain":
https://cobrain.space/mcp

Usa l'autenticazione OAuth nel browser. Se non puoi modificare tu la configurazione, guidami passo passo usando i nomi esatti dei menu.

Se il programma accetta solo un comando, il ponte è npx -y mcp-remote https://cobrain.space/mcp. Se chiede una API key, non serve: chiedigli un server MCP remoto via HTTP con OAuth.

I ventitré strumenti

Nome, cosa fa, e se legge, scrive o cancella. Gli errori arrivano all'AI in inglese, con il suggerimento del percorso giusto quando sbaglia: è la tua AI a raccontarteli nella tua lingua.

list_workspaces

Il tuo brain e quelli che ti sono stati condivisi, con l'accesso che hai su ciascuno. Dice anche con quale account l'AI è collegata.

legge
list_files

L'elenco delle note sotto una cartella. Se la cartella non esiste, propone i nomi simili.

legge
find_notes

Cerca note e cartelle per nome o per pezzo di percorso, come il «trova» di un computer. Risolve anche un [[wikilink]].

legge
fetch

Apre una nota dall'identificativo che un risultato di ricerca si portava dietro e ne dà il testo intero. Esiste solo quando l'AI collegata è ChatGPT: è la metà che gli serve per citare le note con un link cliccabile.

legge
settings_read

Lo usa la pagina del plugin in ChatGPT: legge le impostazioni di Cobrain per mostrarle. Oggi c'è la cadenza del Sogno.

legge
settings_update

Lo usa la pagina del plugin in ChatGPT: salva l'impostazione che hai cambiato (ogni settimana, ogni mese o mai per il Sogno). Tocca solo il tuo brain, mai le note.

scrive
read_file

Legge una nota, o un allegato: le immagini le vede, PDF, Word, PowerPoint, Pages, Keynote, RTF e OpenDocument li legge come testo, i fogli Excel come tabelle, una pagina scansionata la guarda come immagine, di un video riceve alcuni fotogrammi (l'audio no).

legge
load_context

Tutto quello che sta sotto una cartella (o con un tag) in un colpo solo, con le istruzioni prima: regole del brain, scheda dell'unità, lezioni, le ultime decisioni, poi le note. Dichiara quando ha dovuto tagliare.

legge
start_session

Il briefing di un'unità (un cliente, un progetto…): regole, scheda, istruzioni, lezioni, ultime decisioni, le sotto-unità aperte e le ultime quindici modifiche.

legge
list_units

Le unità del brain: percorso, tipo, stato, quante note, ultima modifica.

legge
recent_changes

Le note cambiate di recente, da chi e quando.

legge
list_tags

I tag del brain, con quante note ciascuno.

legge
files_by_tag

Le note che portano un tag.

legge
write_file

Crea una nota, o ne sostituisce tutto il contenuto. Rifiuta di sostituire una nota lunga con un testo molto più corto senza conferma: protegge da un'aggiunta scritta per sbaglio come riscrittura.

scrive
append_file

Aggiunge testo in fondo a una nota (la crea se manca). È quello che l'AI deve usare per aggiungere, invece di riscrivere.

scrive
patch_file

Cambia un pezzo di una nota senza riscriverla tutta: sostituisce un testo esatto con un altro. Se il testo non c'è, o compare più volte, rifiuta invece di indovinare. Non crea note nuove.

scrive
create_unit

Crea un'unità (cliente, progetto, quello che segui) da un modello: la scheda e il registro delle decisioni, che nascono già scritti (cos'è, perché la apri, la prima decisione). Su una cartella esistente aggiunge solo i file che mancano.

scrive
attach_file

Allega un file vero (immagine, PDF, audio) accanto a una nota: finisce nella cartella «allegati» di quel ramo e la nota ne riceve il riferimento. Il file arriva in base64, da un indirizzo pubblico, oppure caricato a parte con un link firmato.

scrive
move_file

Rinomina o sposta una nota o una cartella intera.

scrive
delete_file

Manda nel cestino del brain una nota, un allegato o una cartella con tutto quello che contiene. Il proprietario del brain la recupera dal cestino per 30 giorni, con le sue versioni; poi se ne va per sempre. L'AI il cestino non lo vede e non lo ripristina.

cancella
start_project

Il copione del brainstorming guidato per impostare una nuova unità con te: cosa seguire, come chiamarla, che struttura darle. Non tocca niente da solo.

guida
dream_tidy_up

Il Sogno: fra le note toccate negli ultimi giorni (da 1 a 15) o in una cartella trova cosa riordinare — note che dicono la stessa cosa, registri di decisioni cresciuti troppo, link che non portano da nessuna parte — e dà all'AI il copione per sistemarlo con te: le cose ovvie le fa, per il resto chiede.

guida

Quelli dell'interfaccia di ChatGPT

Non li usa l'AI: li chiama ChatGPT quando scrivi @ nella casella o apri Cobrain dalla barra laterale. Leggono e basta, con i tuoi permessi.

search_mentions

Lo usa la casella di scrittura di ChatGPT, non l'AI: quando scrivi @ ti propone le note per nome (le ultime toccate se non hai ancora scritto niente), e la nota che scegli arriva all'AI da leggere.

legge
open_brain

Apre Cobrain a tutto schermo dalla barra laterale di ChatGPT: l'albero del brain, la ricerca e la nota aperta, con il tasto «Allega alla chat».

legge
brain_panel

La stessa app di Cobrain, in una scheda accanto alla conversazione.

legge
app_note

Dà all'app di Cobrain la nota da mostrare, già impaginata: l'HTML scritto dentro una nota esce come testo, mai come codice.

legge

Cosa non possono fare

Per chi valuta il connettore prima di autorizzarlo.

  • Uscire dai permessi dell'utente. Un ramo non condiviso non è raggiungibile: la regola sta nel database, non nel connettore.
  • Cancellare la storia. Ogni scrittura conserva la versione precedente della nota; la cancellazione di una nota lascia le versioni.
  • Toccare l'account. Niente strumenti per cambiare email, piano, condivisioni o autorizzazioni: si fa solo dal sito.
  • Parlare con altri servizi. Il connettore legge e scrive nel brain e basta: nessuna rete, nessun invio altrove.
  • Restare collegati senza permesso. L'autorizzazione si revoca dalla pagina Connessioni, e da quel momento ogni chiamata viene rifiutata.

Ogni chiamata resta tracciata: quale strumento, con che esito, in quanto tempo. E ogni nota dice quale programma l'ha modificata. Per il resto, la privacy.

Gratis, senza carta

Collega la tua AI.

Le guide lo fanno passo passo per Claude, ChatGPT, Claude Code, Codex, Cursor e Antigravity. Per tutti gli altri, il messaggio qui sopra.

Crea il tuo brain, è gratisEntra nel tuo brainMille note, tutte le AI che vuoi collegare.