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_….

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.

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:

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

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

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

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

{
  "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.

generate_chart accetta solo dati di testo, fino a 1 MB. Per le cartelle di lavoro Excel (e il relativo sheet_name) o i file più grandi, usa POST /charts/generations.

• Il server si trova all’indirizzo https://mcp.scifig.ai/mcp (Streamable HTTP). Chiama questa API per tuo conto, quindi prezzi, crediti, limiti ed errori sono gli stessi.
• I parametri per immagini e allegati accettano una file_id, un URL https o un URL di dati. Gli URL e gli URL di dati vengono prima caricati con POST /files, quindi contano nei limiti di caricamento. Gli URL di SciFig vengono rifiutati (passa la file_id); i reindirizzamenti sono seguiti solo verso altri indirizzi https.
• Una richiesta al server MCP è limitata a 4 MB. Base64 aumenta le dimensioni di un file di un terzo, quindi un URL di dati può contenere circa 3 MB. Passa i file più grandi come URL https.
• Il server verifica le credenziali solo in initialize e tools/call. Un token scaduto o revocato restituisce 401, così il client può aggiornarlo o accedere di nuovo; un account bloccato o in fase di eliminazione restituisce 403.
• Le immagini completate vengono mostrate direttamente nella conversazione se non superano 1 MB. Ogni risultato include link per il download; grafici e diagrammi di flusso aggiungono un link per aprire il risultato nell’editor SciFig.
• Ogni creazione usa un nuovo Idempotency-Key, a meno che l’assistente non passi idempotency_key. Ripetere la richiesta crea e addebita quindi una nuova attività. Usa get_job per seguirne l’avanzamento.
• Un risultato di errore restituisce idempotency_key e, se esiste un’attività, job_id. Dopo un timeout o un errore del server, riprova con la stessa chiave o chiama get_job. Un rifiuto come 402 INSUFFICIENT_CREDITS rimane salvato sotto la sua chiave; in quel caso, invia la richiesta con una nuova chiave.