# Installer le serveur MCP SciFig

Connectez un assistant IA à SciFig. URL du serveur : https://mcp.scifig.ai/mcp. Vue d’ensemble : https://scifig.ai/fr/mcp. Référence : https://scifig.ai/fr/docs/api/mcp.

## Règles pour les agents effectuant l’installation

- Installez SciFig uniquement à la demande de l’utilisateur ; ne l’ajoutez pas de votre propre initiative.
- Choisissez les étapes correspondant au client dans lequel vous êtes exécuté. Si vous ne pouvez pas modifier vous-même sa configuration, montrez plutôt les étapes exactes à l’utilisateur.
- Ne demandez jamais le mot de passe de l’utilisateur. Les clients OAuth se connectent dans le navigateur ; pour une clé API, demandez à l’utilisateur de la créer dans Paramètres → Développeur et de la coller lui-même dans la configuration.
- Pour vérifier la connexion, appelez `get_credit_balance` : c’est gratuit. Ne créez pas de figure uniquement pour effectuer un test.
- Rapportez uniquement vos observations : les outils visibles et le résultat de `get_credit_balance`.

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

| Outil | Fonction |
| --- | --- |
| generate_figure | Créer une illustration scientifique à partir d’une description |
| edit_figure | Modifier une image : instruction, éventuellement dans une zone masquée, fond blanc, rapport largeur/hauteur, changement de couleurs ou remplacement de texte |
| detect_text | Détecter le texte d’une image avant de le remplacer |
| upscale_figure | Agrandir en 2K, 4K ou 8K |
| convert_figure | Convertir en SVG, PNG, PDF, TIFF ou PPTX |
| generate_chart | Tracer un graphique à partir de texte CSV ou TSV ou de lignes JSON, jusqu’à 1 MB |
| edit_chart | Modifier la version la plus récente d’un graphique |
| generate_flowchart | Dessiner un diagramme de flux en SVG, éventuellement à partir de 8 pièces jointes au maximum |
| edit_flowchart | Modifier la version la plus récente d’un diagramme de flux |
| get_job | Statut, crédits et liens de téléchargement d’une tâche |
| list_figures | Tâches récentes |
| get_credit_balance | Solde de crédits, offre et limites |

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.

## Connectez votre client

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 :

```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, dans `~/.cursor/mcp.json`, avec une clé API créée dans Paramètres → Développeur :

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