Sarmate.net Sarmate.net
Home Funzioni Prezzi Documentazione Contatto
Accedi Si registri

Collega la sua IA a Sarmate — guida passo passo

Consenti a un'intelligenza artificiale di leggere, scrivere, compilare e correggere i suoi file LaTeX direttamente nel suo drive di Sarmate. Questa guida illustra nel dettaglio ogni passaggio per collegare la sua IA al suo spazio Sarmate.

Disponibile su tutti i piani (incluso quello gratuito), entro il limite della quota di compilazione del suo piano.

Principio di funzionamento

Un'intelligenza artificiale detta «agentica» è un programma installato sul suo computer, in grado di svolgere compiti in modo autonomo invece di limitarsi a rispondere. Di solito si controlla da un terminale —la finestra in cui si inseriscono i comandi—; alcune, tuttavia, si usano da un browser o da un'applicazione dedicata. Il MCP (Model Context Protocol) è uno standard che indica alle intelligenze artificiali come collegarsi a un servizio esterno e interagire con esso. La sua IA si collega così al server MCP di Sarmate, che la autorizza a leggere, modificare e compilare i file del suo drive a partire dalle sue istruzioni in linguaggio naturale. Quattro concetti ne riassumono il funzionamento.

L'IA viene eseguita sul suo computer

Installata sulla sua macchina, l'IA apre, modifichi e compila i suoi file in modo autonomo, a partire dalle richieste che formuli in linguaggio naturale.

Le sue richieste: nel terminale del suo computer

Il terminale è una finestra del suo computer in cui digiti le sue richieste: è lì che dialoghi con l'IA. (Alcune IA accettano anche il browser.)

Il risultato sul suo drive sarmate.net

Quando chiedi un'azione all'IA dal suo computer, questa la esegue sul suo drive sarmate.net. E se il file interessato è aperto nell'editor di sarmate.net, ne vedi le modifiche in diretta.

Sotto il suo controllo

Ogni modifichi conserva un backup ripristinabile per 30 giorni, l'eliminazione dei file è disattivata e può revocare l'accesso della sua IA a sarmate.net in qualsiasi momento, dal sito web.

Sul suo computer, in un terminale
> Correggi gli errori LaTeX del capitolo 2 e ricompila.
Sul sito di Sarmate (browser)
chapitre2.tex modificato · PDF ricompilato · visibile in tempo reale

In 3 grandi passaggi

Il principio è sempre lo stesso, qualunque sia la sua IA:

1

Crei un token

su sarmate.net

Da sarmate.net, genera una chiave personale che autorizzi la sua IA ad accedere al suo drive.

2

Installa la sua IA

sul suo computer

Installa l'IA che preferisci sul suo computer: Gemini CLI (gratuita), Claude Code… (Le Chat, invece, funziona nel browser, senza installazione.)

3

Collega e usa

sul suo computer, in un terminale

Sul suo computer, incolla la configurazione (con il suo token) in un prompt del terminale, poi chiedi all'IA, in linguaggio naturale, di intervenire sui suoi file di sarmate.net. (Le Chat, invece, si configura nel browser.)

1

Crei il suo token MCP

  1. Apra il gestore file di Sarmate e fai clic sull'icona MCP (in alto a destra).
  2. Fai clic su «Nuovo token», dagli un nome (es. «Il mio Gemini»).
  3. Copi il token (inizi con smt_). ⚠️ Viene mostrato una sola volta — conservalo per il passaggio 3.
2

Scelga la sua IA e segui i passaggi

Per iniziare, può ad esempio provare Gemini CLI, che offre un piano di IA agentica gratuito. Se preferisci evitare il terminale, Le Chat si configura nel browser.

Gemini CLI libero

Gemini CLI è uno strumento a riga di comando che pilota un'IA agentica dal terminale. È disponibile un piano gratuito.

Tutte le operazioni qui sotto si svolgono in un terminale del suo computer — sia l'installazione di Node.js sia i comandi Gemini. Aprine uno (il prerequisito qui sotto spiega come, a seconda del suo sistema). Poi formuli le sue richieste in linguaggio naturale; Gemini interviene sui suoi file, e le modifiche appaiono in tempo reale sul sito Sarmate nel browser.
Passaggio preliminare (una sola volta): aprire un terminale e installare Node.js

Questi strumenti hanno bisogno di Node.js (un software gratuito). Scelga il suo sistema:

  1. Vai su nodejs.org e scarichi la versione LTS. Avvia il file .msi e fai clic su «Avanti» fino alla fine.
  2. Apra il terminale: tasto Windows, digita PowerShell, Invio.
  3. Verifica con: node --version
  1. Vai su nodejs.org, scarichi la versione LTS (file .pkg) e installala.
  2. Apra il terminale: Cmd + Spazio, digita Terminal, Invio.
  3. Verifica con: node --version
  1. Apra il suo terminale (spesso Ctrl + Alt + T).
  2. Installa Node.js. Su Debian/Ubuntu:
    sudo apt update && sudo apt install -y nodejs npm
  3. Verifica con: node --version
  1. Nel terminale, installa Gemini CLI (una sola volta):
    npm install -g @google/gemini-cli

    macOS / Linux: in caso di errore di permessi, aggiunga sudo all'inizio del comando.

  2. Collega Sarmate (incolla questo comando, con il suo token):
    gemini mcp add --transport http --header "Authorization: Bearer smt_VOTRE_TOKEN" sarmate https://mcp.sarmate.net/mcp
    Sostituisci smt_VOTRE_TOKEN con il token copiato al passaggio 1.
  3. Avvia Gemini digitando semplicemente: gemini
  4. Formula la sua richiesta in linguaggio naturale, ad esempio:
    Elenca i miei file Sarmate, apra il mio documento principale e correggi gli errori di compilazione.
  5. Apra il suo editor Sarmate nel browser: vedi i file cambiare in diretta. ✅

Le Chat (Mistral) senza terminale · browser

Se desideri evitare il terminale: Le Chat si configura interamente nel browser, in pochi clic. Disponibile su tutti i piani Le Chat.

  1. Su chat.mistral.ai → barra laterale sinistra → IntelligenceConnectors+ Add Connector.
  2. Scelga la scheda Custom MCP Connector.
  3. Compila:
    • Nome : Sarmate
    • Server : https://mcp.sarmate.net/mcp
    • Autenticazione : API token — Header Authorization, type Bearer, valore smt_VOTRE_TOKEN
    Sostituisci smt_VOTRE_TOKEN con il token copiato al passaggio 1.
  4. Create — attivo immediatamente, nessun riavvio.

Claude Code il più potente · a pagamento

L'IA agentica più completa per il codice e LaTeX. Richiede un abbonamento Claude (nessuna versione gratuita) ed è il riferimento del settore.

Come Gemini, tutto si pilota dal terminale del suo computer; gli effetti appaiono in tempo reale sul sito Sarmate (browser).
Passaggio preliminare (una sola volta): aprire un terminale e installare Node.js

Questi strumenti hanno bisogno di Node.js (un software gratuito). Scelga il suo sistema:

  1. Vai su nodejs.org e scarichi la versione LTS. Avvia il file .msi e fai clic su «Avanti» fino alla fine.
  2. Apra il terminale: tasto Windows, digita PowerShell, Invio.
  3. Verifica con: node --version
  1. Vai su nodejs.org, scarichi la versione LTS (file .pkg) e installala.
  2. Apra il terminale: Cmd + Spazio, digita Terminal, Invio.
  3. Verifica con: node --version
  1. Apra il suo terminale (spesso Ctrl + Alt + T).
  2. Installa Node.js. Su Debian/Ubuntu:
    sudo apt update && sudo apt install -y nodejs npm
  3. Verifica con: node --version
  1. Collega Sarmate (un comando):
    claude mcp add --transport http sarmate https://mcp.sarmate.net/mcp --header "Authorization: Bearer smt_VOTRE_TOKEN"
    Sostituisci smt_VOTRE_TOKEN con il token copiato al passaggio 1.
  2. Verifica: claude mcp listsarmate ✓ Connected
  3. Avvia claude e chiedigli di agire sui suoi file Sarmate.

Claude Desktop

L'applicazione desktop Claude. Nessun terminale nell'uso quotidiano, ma una piccola configurazione tecnica all'inizio (e Node.js installato).

Passaggio preliminare (una sola volta): aprire un terminale e installare Node.js

Questi strumenti hanno bisogno di Node.js (un software gratuito). Scelga il suo sistema:

  1. Vai su nodejs.org e scarichi la versione LTS. Avvia il file .msi e fai clic su «Avanti» fino alla fine.
  2. Apra il terminale: tasto Windows, digita PowerShell, Invio.
  3. Verifica con: node --version
  1. Vai su nodejs.org, scarichi la versione LTS (file .pkg) e installala.
  2. Apra il terminale: Cmd + Spazio, digita Terminal, Invio.
  3. Verifica con: node --version
  1. Apra il suo terminale (spesso Ctrl + Alt + T).
  2. Installa Node.js. Su Debian/Ubuntu:
    sudo apt update && sudo apt install -y nodejs npm
  3. Verifica con: node --version
  1. Apra (o crei) il file di configurazione:
    • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows : %APPDATA%\Claude\claude_desktop_config.json
  2. Incolla:
    { "mcpServers": { "sarmate": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.sarmate.net/mcp", "--header", "Authorization: Bearer smt_VOTRE_TOKEN"] } } }
    Sostituisci smt_VOTRE_TOKEN con il token copiato al passaggio 1.
  3. Chiudi completamente Claude (Cmd+Q su Mac) e poi riavvialo.

ChatGPT (modalità sviluppatore)

Nel browser, senza terminale, ma la scrittura dei file è spesso limitata a seconda del suo piano OpenAI.

  1. ChatGPT → SettingsApps & ConnectorsAdvanced settings → attiva la Developer mode.
  2. Crei un connettore: URL https://mcp.sarmate.net/mcp, transport Streamable HTTP, header Authorization: Bearer smt_TUO_TOKEN.
    Sostituisci smt_VOTRE_TOKEN con il token copiato al passaggio 1.
ChatGPT Plus/Pro è spesso limitato alla sola lettura; la scrittura è riservata ai piani Business/Enterprise/Edu.

Cursor

Editor di codice con IA. Nessun terminale: una configurazione in un file.

  1. Apra (o crei) ~/.cursor/mcp.json e incolla:
    { "mcpServers": { "sarmate": { "url": "https://mcp.sarmate.net/mcp", "headers": { "Authorization": "Bearer smt_VOTRE_TOKEN" } } } }
    Sostituisci smt_VOTRE_TOKEN con il token copiato al passaggio 1.
  2. Verifica in Cursor → Settings → MCP (punto verde).

Cline / Continue (VS Code)

Cline : barra laterale di Cline → MCP Servers → Configure MCP Servers, poi incolla:

{ "mcpServers": { "sarmate": { "url": "https://mcp.sarmate.net/mcp", "headers": { "Authorization": "Bearer smt_VOTRE_TOKEN" }, "disabled": false } } }

Continue : ~/.continue/config.yaml

mcpServers: - name: sarmate url: https://mcp.sarmate.net/mcp headers: Authorization: Bearer smt_VOTRE_TOKEN
Sostituisci smt_VOTRE_TOKEN con il token copiato al passaggio 1.

Altro client

Qualsiasi client compatibile con MCP funziona con queste 3 informazioni:

  • URL : https://mcp.sarmate.net/mcp
  • Transport : Streamable HTTP / SSE
  • Header : Authorization: Bearer smt_VOTRE_TOKEN

Per un client che parla solo stdio (senza HTTP), usa il ponte:

npx -y mcp-remote https://mcp.sarmate.net/mcp --header "Authorization: Bearer smt_VOTRE_TOKEN"
Sostituisci smt_VOTRE_TOKEN con il token copiato al passaggio 1.
Ti servono dettagli tecnici (elenco degli strumenti, FAQ avanzate)? Documentazione tecnica →

Domande frequenti

È necessario padroneggiare il terminale?
Non è necessario. Basta copiare due o tre comandi forniti, una sola volta; in seguito le interazioni con l'IA avvengono in linguaggio naturale. Se preferisci non usare il terminale, Le Chat si configura interamente nel browser.
Che cos'è Node.js e perché installarlo?
È un software gratuito che Gemini CLI, Claude Code e Claude Desktop usano per funzionare. Lo si installa una sola volta, con pochi clic (vedi «Prerequisito» in ogni sezione interessata). Le Chat e ChatGPT non ne hanno bisogno.
Quale piano serve? Basta quello gratuito?
L'MCP è aperto a tutti i piani, incluso quello gratuito, limitato dalla quota di compilazione del suo piano. Lato IA: Gemini CLI ha un piano gratuito; Claude Code richiede un abbonamento a Claude.
Non si connette, lo strumento non compare.
Verifica: (1) hai riavviato lo strumento dopo la configurazione? (2) il token è copiato per intero, preceduto da Bearer ? (3) per Gemini/Claude, node --version risponde correttamente (Node.js installato)?
Posso collegare Claude.ai (il sito / l'app)?
Non ancora (Claude.ai richiede OAuth, non ancora implementato). Nel frattempo, Claude Desktop e Claude Code offrono le stesse funzionalità con la stessa IA.

Pronto a collegare la sua IA?

Crei il suo token, poi segui Gemini CLI (gratuito) al passaggio 2.