FTIR.fun FTIR.fun
Entwickler- und KI-Integration

Verbinden Sie FTIR.fun mit jedem KI-Tool oder jeder App

Geben Sie Ihrem KI-Assistenten oder Ihrem eigenen Code direkten Zugriff auf über 130.000 Referenzspektren, Wissensgraph-Peak-Analyse und literaturgestützte Interpretation. Wählen Sie eine von drei Verbindungsmöglichkeiten – MCP für KI-Assistenten, die REST-API für Code oder eine fertige Skill für No-Code-Plattformen. Jeder Pfad unten enthält Schritt-für-Schritt-Anleitungen für erstmalige Benutzer.

1. Wählen Sie Ihren Pfad 2. MCP-Einrichtung 3. REST-API 4. Fähigkeiten & Plugins 5. Was Ihr KI-Assistent kann 6. Fehlerbehebung
Geprüft und gelistet auf

Bevor Sie beginnen — holen Sie Ihren API-Schlüssel

MCP und die REST-API verwenden denselben FTIR.fun-API-Schlüssel. Coze/Doubao verwendet einen vom Plugin-Herausgeber konfigurierten Dienstschlüssel, sodass Endbenutzer keinen persönlichen Schlüssel einfügen. Das Abrufen eines persönlichen Schlüssels dauert etwa eine Minute:

  1. Bei FTIR.fun anmelden Erstellen Sie ein kostenloses Konto, wenn Sie keins haben. Neue Konten enthalten kostenlose Testguthaben.
  2. Öffnen Sie das API-Schlüssel-Dashboard Gehen Sie zu Konto → API-Schlüssel und klicken Sie auf Generieren.
  3. Kopieren und speichern Sie den Schlüssel sofort Der vollständige Schlüssel (beginnt mit ftir_) wird nur einmal angezeigt. Speichern Sie ihn an einem sicheren Ort. Wenn Sie ihn verlieren, generieren Sie einfach einen neuen.
🔑 Bereit? Öffnen Sie das API-Schlüssel-Dashboard in einem neuen Tab, kehren Sie dann zurück und folgen Sie dem von Ihnen oben gewählten Pfad.
⚠️ Der gehostete MCP-Server akzeptiert nur einen Konten-API-Schlüssel, der im FTIR.fun API Keys Dashboard generiert wurde (beginnt mit ftir_). Serverseitige Masterschlüssel sind für REST-Betreiber und können sich nicht beim gehosteten MCP anmelden.

Schritt 1 — Welche Verbindung ist die richtige für Sie?

Alle drei verbinden sich mit derselben Engine: 130.000+ Spektren, Knowledge-Graph-Argumentation und Literaturzitate. Sie brauchen nur eine. Wählen Sie nach Ihrer Arbeitsweise — unsicher? MCP ist die beliebteste Wahl für jeden, der einen KI-Assistenten verwendet.

Was Ihre KI tatsächlich tun kann

Die aktuellen MCP-, REST-, n8n- und LangChain-Distributionen stellen sieben Operationen bereit. Das veröffentlichte Coze-Plugin stellt drei Werkzeuge (analysieren, finden, erklären) zur Verfügung, und andere Vorlagen können eine kleinere deklarierte Menge bereitstellen; überprüfen Sie vor der Nutzung die Karte jeder Plattform. Die folgenden Operationen teilen die gleichen FTIR.fun-Dienste.

Aufgabe MCP-Tool REST-Endpunkt Sagen Sie dies Ihrer KI.
Eine Instrumentendatei lesen parse_ftir_spectrum POST /parse-spectrum Analysieren Sie sample.spc und listen Sie die erkannten Peaks auf.
Identifizieren Sie ein unbekanntes Spektrum analyze_ftir_spectrum POST /ftir/analyze_spectrum Identifizieren Sie, welches Polymer dieses Spektrum ist.
Senden Sie einen vollständigen Drei-Achsen-Bericht. submit_ftir_report POST /ftir/reports Reichen Sie sample.spa für einen vollständigen Bericht im ATR-Modus ein.
Bericht abfragen und abrufen get_ftir_report_status GET /ftir/reports/{task_id} Überprüfen Sie den Berichtsauftrag und geben Sie mir den Link, wenn er fertig ist.
Peaks erklären explain_peaks POST /ftir/explain_peak_assignments Was zeigen die Peaks bei 1715 und 1450 cm-1 an?
Ein bekanntes Referenzspektrum finden find_spectra POST /ftir/find_spectra Referenzspektren für Polystyrol finden.
Öffnen Sie ein früheres Ergebnis erneut fetch_result GET /ftir/result/{result_num} Ergebnis 20260528100755416137536 abrufen.

Unterstützte Dateien: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Gültige sampling_mode-Werte sind KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR und Others. Transmission ist kein gültiger Wert. Behalten Sie die ursprüngliche Dateierweiterung bei, damit FTIR.fun den richtigen Parser auswählt.

Beispielantwort für find_spectra

find_spectra-Antwort 
{
  "success": true,
  "query": "polystyrene",
  "match_mode": "synonym",
  "match_count": 3,
  "summary": "Found 3 reference spectrum candidates for 'polystyrene'.",
  "results": [
    {"num": 555, "spectrum_number": 555, "name": "PS/PPO",
     "cas": "-", "source_type": "direct_read:spa",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

Beispielantwort für explain_peaks

explain_peaks-Antwort 
{
  "success": true,
  "search_mode": "peak_explanation",
  "peak_explanations": [
    {"peaks_cm1": [1715, 1450],
     "assignment": "1715 cm-1 suggests C=O stretching (ester or carboxylic acid)...",
     "evidence_type": "llm_general_knowledge"}
  ],
  "summary": "Peak explanation based on general FTIR knowledge..."
}

Den vollständigen Bericht erhalten (asynchron)

Das Schnellscreening (analyze_spectrum) wird sofort zurückgegeben. Der vollständige Tri-Achsen-Bericht läuft im Hintergrund und dauert in der Regel 30–90 Sekunden. Reichen Sie keinen Bericht erneut ein, während er läuft – behalten Sie die task_id und fragen Sie sie ab.

  1. Absenden Rufen Sie submit_ftir_report (MCP) oder POST /ftir/reports (REST) auf. Sie erhalten eine task_id und eine reservierte result_num zurück. Das Feld file_base64 ist erforderlich; andere Felder (sampling_mode, prior_context, language_code, sample_name, sample_order_no) sind optional.
    Beispiel für Übermittlung (REST) 
    curl -X POST https://ftir.fun/ftir/reports \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spa", "sampling_mode": "ATR", "language_code": "en"}'
    Antwort übermitteln 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}
  2. Umfrage Rufen Sie get_ftir_report_status (MCP) oder GET /ftir/reports/{task_id} alle 5–10 Sekunden auf, bis completed true ist. Die abgeschlossene Antwort enthält report_url, report_view (strukturierter Berichtsinhalt) und result_num.
    Abfragebeispiel 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Abfrageantwort (in Bearbeitung) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Poll-Antwort (abgeschlossen) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Öffnen Sie den endgültigen Bericht Öffnen Sie die vollständige URL https://ftir.fun/outputdata/?num={result_num} in einem Browser, um die vollständige Tri-Achsen-Ergebnisseite von FTIR.fun anzuzeigen.
⚠️ Reichen Sie denselben Bericht nicht erneut ein, während er in der Warteschlange oder in Bearbeitung ist. Behalten Sie die task_id und fragen Sie wiederholt ab, bis er abgeschlossen oder fehlgeschlagen ist. Doppelte Einreichungen verschwenden Punkte.

Fehlerbehebung

Was Sie sehen Was es bedeutet Was zu tun ist
Der Client öffnet eine Browser-Autorisierungsseite oder meldet, dass die Autorisierungsseite nicht existiert. Ihr Client verwendet einen alten OAuth-ähnlichen Servereintrag. FTIR.fun verwendet kein OAuth — nur einen API-Schlüssel. Löschen Sie den alten ftirfun-Servereintrag, fügen Sie die genaue Konfiguration von dieser Seite ein, laden Sie den Client neu und starten Sie ftirfun erneut.
401 (MCP) / 401 invalid_api_key (REST) Der API-Key fehlt, ist abgelaufen, wurde widerrufen oder falsch eingefügt. Starten Sie den Server neu und fügen Sie nur den rohen Schlüssel ein (beginnt mit ftir_). Generieren Sie einen neuen Schlüssel über das API-Schlüssel-Dashboard falls erforderlich.
Der Server startet, aber es werden keine Tools angezeigt. Der Client hat seinen Katalog nicht aktualisiert oder die Konfiguration verwendet den falschen Schlüsselnamen. Bestätigen Sie für VS Code, dass mcp.json servers (nicht mcpServers) verwendet. Stoppen und starten Sie dann ftirfun oder laden Sie das Fenster neu.
403 insufficient_balance Das Konto hat nicht genügend Punkte für diese Analyse. Überprüfen Sie Ihr Guthaben oder Abonnement in FTIR.fun und versuchen Sie es erneut.
429 rate_limit_exceeded REST-Analyse und -Parsing erlauben 60 Anfragen pro Minute pro API-Schlüssel; REST-Ergebnis- und Report-Status-Lesevorgänge verwenden einen separaten Bucket mit 120 Anfragen pro Minute; MCP erlaubt 60 Aufrufe pro Minute für jeden API-Schlüssel und jedes Tool. Warten Sie die vom Tool gemeldete Wartezeit ab, bevor Sie es erneut aufrufen.
Ein Bericht bleibt in der Warteschlange oder läuft. Vollständige Berichte werden asynchron ausgeführt und dauern länger als die Schnellsuche. Behalten Sie dieselbe task_id und fragen Sie weiter ab. Erstellen Sie keine doppelten Berichtsaufgaben.
422 oder missing_input Der Anforderungstext enthält nicht die erforderlichen Felder oder hat ein ungültiges Format. Für analyze_spectrum müssen Sie mindestens eines der folgenden Felder angeben: peaks, query oder file_base64. Überprüfen Sie, ob Ihr JSON gültig ist, der Content-Type application/json ist und die erforderlichen Felder vorhanden sind. Siehe die obigen Beispielanfragen.
413 file_too_large Die hochgeladene Spektrumdatei überschreitet die Größenbeschränkung. Exportieren Sie eine kleinere Datei oder verwenden Sie nur Peakpositionen über das Feld spectrum.peaks.

Bereit zu bauen?

Die vollständige REST-Referenz enthält jeden Endpunkt, Anfrage- und Antwortformate, Authentifizierung, Ratenbegrenzungen, Fehlercodes, MCP-Tooldefinitionen und Codebeispiele in Python und curl.

Anfrage einreichen Formular