Serveur MCP

URL du serveur : https://mcp.scifig.ai/mcp, Streamable HTTP. Les clients prenant en charge OAuth se connectent en ouvrant une session SciFig et en autorisant l’accès ; ceux qui envoient des en-têtes peuvent utiliser une clé API sous la forme Authorization: Bearer sk_live_….

Les outils de création attendent jusqu’à 25 secondes. Si une tâche est encore en cours, appelez get_job plus tard ; rappeler l’outil de création crée et facture une nouvelle tâche. Les résultats répertorient chaque lien de téléchargement et, pour les graphiques et diagrammes de flux, le lien d’ouverture dans l’éditeur SciFig.

Les outils de création vérifient la portée figures:generate avant de télécharger les pièces jointes. Une connexion en lecture seule peut consulter les tâches et les crédits, mais ne peut pas créer de figure.

Claude, sur claude.ai et dans Claude Desktop : Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Saisissez l’URL du serveur, connectez-vous à SciFig et autorisez l’accès.

ChatGPT : Paramètres → Applications → Avancé → Mode développeur. Créez une application avec l’URL du serveur et l’authentification 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, dans ~/.cursor/mcp.json, avec une clé API créée dans Paramètres → Développeur :

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

Les clients sans OAuth peuvent ajouter l’en-tête Authorization: Bearer sk_live_… avec une clé API créée dans Paramètres → Développeur.

generate_chart accepte uniquement des données texte, jusqu’à 1 MB. Pour les classeurs Excel (et leur sheet_name) ou les fichiers plus volumineux, utilisez POST /charts/generations.

• Le serveur est à l’adresse https://mcp.scifig.ai/mcp (Streamable HTTP). Il appelle cette API pour vous ; les tarifs, crédits, limites et erreurs sont donc identiques.
• Les paramètres d’image et de pièce jointe acceptent une file_id, une URL https ou une URL de données. Les URL et URL de données sont d’abord téléversées avec POST /files et comptent donc dans les limites de téléversement. Les URL de SciFig sont refusées (transmettez la file_id). Les redirections ne sont suivies que vers d’autres adresses https.
• Une requête au serveur MCP est limitée à 4 MB. Base64 augmente la taille d’un fichier d’un tiers ; une URL de données peut donc contenir environ 3 MB. Transmettez les fichiers plus volumineux par une URL https.
• Le serveur vérifie vos identifiants uniquement lors de initialize et de tools/call. Un jeton expiré ou révoqué renvoie 401 pour permettre au client de le renouveler ou de se reconnecter. Un compte banni ou en cours de suppression renvoie 403.
• Les images terminées sont affichées directement dans la conversation si elles ne dépassent pas 1 MB. Chaque résultat contient des liens de téléchargement ; les graphiques et diagrammes de flux ajoutent un lien pour ouvrir le résultat dans l’éditeur SciFig.
• Chaque création utilise un nouvel Idempotency-Key, sauf si l’assistant fournit idempotency_key. Demander à nouveau crée donc une nouvelle tâche facturée. Utilisez get_job pour consulter son avancement.
• Une réponse d’erreur inclut idempotency_key et, lorsqu’une tâche existe, job_id. Après un dépassement de délai ou une erreur serveur, réessayez avec la même clé ou appelez get_job. Un refus tel que 402 INSUFFICIENT_CREDITS reste enregistré sous sa clé ; renvoyez alors la requête avec une nouvelle clé.