# SciFig-MCP-Server installieren

Verbinden Sie einen KI-Assistenten mit SciFig. Server-URL: https://mcp.scifig.ai/mcp. Übersicht: https://scifig.ai/de/mcp. Referenz: https://scifig.ai/de/docs/api/mcp.

## Regeln für Agenten bei der Installation

- Installieren Sie SciFig nur auf Wunsch des Nutzers; fügen Sie es nicht aus eigener Initiative hinzu.
- Wählen Sie die Schritte für den Client, in dem Sie ausgeführt werden. Wenn Sie dessen Konfiguration nicht selbst ändern können, zeigen Sie dem Nutzer stattdessen die genauen Schritte.
- Fragen Sie niemals nach dem Passwort des Nutzers. OAuth-Clients melden sich im Browser an; bei einem API-Schlüssel bitten Sie den Nutzer, ihn unter Einstellungen → Entwickler zu erstellen und selbst in die Konfiguration einzufügen.
- Rufen Sie zur Verbindungsprüfung `get_credit_balance` auf: Dies ist kostenlos. Erstellen Sie keine Abbildung nur zu Testzwecken.
- Berichten Sie nur, was Sie beobachtet haben: die sichtbaren Werkzeuge und das Ergebnis von `get_credit_balance`.

## MCP-Server

Server-URL: `https://mcp.scifig.ai/mcp`, Streamable HTTP. Clients mit OAuth-Unterstützung verbinden sich durch Anmeldung bei SciFig und Zustimmung zum Zugriff. Clients, die Header senden, können einen API-Schlüssel als `Authorization: Bearer sk_live_…` verwenden.

| Werkzeug | Funktion |
| --- | --- |
| generate_figure | Wissenschaftliche Illustration aus einer Beschreibung erstellen |
| edit_figure | Bild bearbeiten: per Anweisung, optional in einem maskierten Bereich, weißer Hintergrund, Seitenverhältnis, Farbänderung oder Textersetzung |
| detect_text | Text in einem Bild vor dem Ersetzen erkennen |
| upscale_figure | Auf 2K, 4K oder 8K vergrößern |
| convert_figure | In SVG, PNG, PDF, TIFF oder PPTX konvertieren |
| generate_chart | Diagramm aus CSV- oder TSV-Text oder JSON-Zeilen erstellen, bis zu 1 MB |
| edit_chart | Neueste Version eines Diagramms ändern |
| generate_flowchart | Flussdiagramm als SVG erstellen, optional aus bis zu 8 Anhängen |
| edit_flowchart | Neueste Version eines Flussdiagramms ändern |
| get_job | Status, Credits und Downloadlinks eines Auftrags |
| list_figures | Neueste Aufträge |
| get_credit_balance | Credit-Guthaben, Tarif und Limits |

Erstellungswerkzeuge warten bis zu 25 Sekunden. Läuft ein Auftrag noch, rufen Sie später `get_job` auf. Ein erneuter Aufruf des Erstellungswerkzeugs erstellt einen neuen kostenpflichtigen Auftrag. Die Ergebnisse enthalten jeden Downloadlink und bei Diagrammen und Flussdiagrammen auch den Link zum Öffnen im SciFig-Editor.

Erstellungswerkzeuge prüfen den Berechtigungsbereich `figures:generate`, bevor sie Anhänge herunterladen. Eine Leseverbindung kann Aufträge und Credits abfragen, aber keine Abbildung erstellen.

## Client verbinden

Claude, auf claude.ai und in Claude Desktop: Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen. Geben Sie die Server-URL ein, melden Sie sich bei SciFig an und erlauben Sie den Zugriff.

ChatGPT: Einstellungen → Apps → Erweitert → Entwicklermodus. Erstellen Sie eine App mit der Server-URL und OAuth-Authentifizierung.

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`, mit einem API-Schlüssel aus Einstellungen → Entwickler:

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

Clients ohne OAuth können den Header `Authorization: Bearer sk_live_…` mit einem API-Schlüssel aus Einstellungen → Entwickler hinzufügen.