# Installa il server MCP SciFig

Collega un assistente IA a SciFig. URL del server: https://mcp.scifig.ai/mcp. Panoramica: https://scifig.ai/it/mcp. Riferimento: https://scifig.ai/it/docs/api/mcp.

## Regole per gli agenti che eseguono l’installazione

- Installa SciFig solo se l’utente lo ha chiesto; non aggiungerlo di tua iniziativa.
- Scegli i passaggi per il client in cui sei in esecuzione. Se non puoi modificarne la configurazione, mostra invece all’utente i passaggi esatti.
- Non chiedere mai la password dell’utente. I client OAuth accedono nel browser; per una chiave API, chiedi all’utente di crearla in Impostazioni → Sviluppatore e di incollarla personalmente nella configurazione.
- Per verificare il collegamento, chiama `get_credit_balance`: è gratuito. Non creare una figura solo per fare un test.
- Riporta solo ciò che hai osservato: gli strumenti visibili e il risultato di `get_credit_balance`.

## Server MCP

URL del server: `https://mcp.scifig.ai/mcp`, Streamable HTTP. I client che supportano OAuth si collegano accedendo a SciFig e autorizzando l’accesso; quelli che inviano intestazioni possono usare una chiave API come `Authorization: Bearer sk_live_…`.

| Strumento | Funzione |
| --- | --- |
| generate_figure | Crea un’illustrazione scientifica da una descrizione |
| edit_figure | Modifica un’immagine: istruzioni, eventualmente una regione mascherata, sfondo bianco, proporzioni, cambio di colori o sostituzione del testo |
| detect_text | Rileva il testo in un’immagine prima di sostituirlo |
| upscale_figure | Ingrandisci a 2K, 4K o 8K |
| convert_figure | Converti in SVG, PNG, PDF, TIFF o PPTX |
| generate_chart | Crea un grafico da testo CSV o TSV o righe JSON, fino a 1 MB |
| edit_chart | Modifica l’ultima versione di un grafico |
| generate_flowchart | Disegna un diagramma di flusso in SVG, eventualmente da un massimo di 8 allegati |
| edit_flowchart | Modifica l’ultima versione di un diagramma di flusso |
| get_job | Stato, crediti e link di download di un processo |
| list_figures | Processi recenti |
| get_credit_balance | Saldo crediti, piano e limiti |

Gli strumenti di creazione attendono fino a 25 secondi. Se un processo è ancora in esecuzione, chiama `get_job` più tardi; richiamare lo strumento di creazione crea e addebita un nuovo processo. I risultati elencano tutti i link di download e, per grafici e diagrammi di flusso, il link che apre il risultato nell’editor SciFig.

Gli strumenti di creazione controllano l’ambito `figures:generate` prima di scaricare gli allegati. Un collegamento di sola lettura può consultare processi e crediti, ma non può creare figure.

## Collega il tuo client

Claude, su claude.ai e in Claude Desktop: Impostazioni → Connettori → Aggiungi connettore personalizzato. Inserisci l’URL del server, accedi a SciFig e consenti l’accesso.

ChatGPT: Impostazioni → Applicazioni → Avanzate → Modalità sviluppatore. Crea un’applicazione con l’URL del server e autenticazione OAuth.

Claude Code:

```bash
claude mcp add --transport http scifig https://mcp.scifig.ai/mcp
```

Codex (`~/.codex/config.toml`):

```toml
[mcp_servers.scifig]
url = "https://mcp.scifig.ai/mcp"
```

Cursor, in `~/.cursor/mcp.json`, con una chiave API creata in Impostazioni → Sviluppatore:

```json
{
  "mcpServers": {
    "scifig": {
      "url": "https://mcp.scifig.ai/mcp",
      "headers": { "Authorization": "Bearer sk_live_…" }
    }
  }
}
```

I client senza OAuth possono aggiungere l’intestazione `Authorization: Bearer sk_live_…` con una chiave API creata in Impostazioni → Sviluppatore.