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.

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.

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:

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

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

generate_chart akzeptiert ausschließlich Textdaten bis zu 1 MB. Für Excel-Arbeitsmappen (und deren sheet_name) oder größere Dateien verwenden Sie POST /charts/generations.

• Der Server befindet sich unter https://mcp.scifig.ai/mcp (Streamable HTTP). Er ruft diese API in Ihrem Namen auf; Preise, Credits, Limits und Fehler sind daher identisch.
• Bild- und Anhangparameter akzeptieren eine file_id, eine https-URL oder eine Daten-URL. URLs und Daten-URLs werden zunächst über POST /files hochgeladen und zählen zum Upload-Limit. SciFig-eigene URLs werden abgelehnt (verwenden Sie die file_id). Weiterleitungen werden nur zu anderen https-Adressen verfolgt.
• Eine Anfrage an den MCP-Server ist auf 4 MB begrenzt. Base64 vergrößert Dateien um ein Drittel, sodass eine Daten-URL etwa 3 MB enthalten kann. Übergeben Sie größere Dateien als https-URL.
• Der Server prüft Ihre Zugangsdaten nur bei initialize und tools/call. Ein abgelaufenes oder widerrufenes Token führt zu 401, damit der Client es aktualisieren oder sich erneut anmelden kann. Ein gesperrtes Konto oder ein Konto, das gerade gelöscht wird, führt zu 403.
• Fertige Bilder werden bis zu einer Größe von 1 MB direkt im Chat angezeigt. Jedes Ergebnis enthält Download-Links; Diagramme und Flussdiagramme enthalten außerdem einen Link zum Öffnen im SciFig-Editor.
• Jede Erstellung verwendet einen neuen Idempotency-Key, sofern der Assistent keinen idempotency_key übergibt. Eine erneute Aufforderung erstellt und berechnet daher einen neuen Job. Verwenden Sie get_job, um den Fortschritt abzufragen.
• Ein Fehlerergebnis gibt den idempotency_key und, sofern ein Job existiert, die job_id zurück. Wiederholen Sie nach einer Zeitüberschreitung oder einem Serverfehler mit demselben Schlüssel oder rufen Sie get_job auf. Eine Ablehnung wie 402 INSUFFICIENT_CREDITS bleibt unter ihrem Schlüssel gespeichert; senden Sie die Anfrage dann mit einem neuen Schlüssel.