MCP

Everyn MCP ist ein gehosteter, organisationsbezogener Model-Context-Protocol-Server. Ein verbundener Host kann ein Dataset hochladen oder wiederfinden, einen wiederverwendbaren Job erstellen oder patchen, einen expliziten Sample- oder Full-Run starten, warten ohne die Arbeit abzubrechen und eine Complete-Results-CSV für die lokale Analyse exportieren.

Der kanonische Endpoint ist https://mcp.everyn.ai/mcp über Streamable HTTP. Protokollversion 2026-07-28. Es gibt vierzehn Tools. Erfinde kein fünfzehntes Tool und keinen hostspezifischen Shortcut.

MCP ist kein zweites Produkt. Datasets, Jobs, Runs, Usage und Billing bleiben in Everyn. Receipts führen auf die passende Seite in der Everyn-App.

Workflow

1. Rufe get_context nur für die aktuell authentifizierte Organisation auf.
2. Lade ein Dataset hoch oder finde es wieder. Wenn upload_csv einen Signed Transfer Descriptor zurückgibt, nutze genau dieses strukturierte Feld, um Bytes zu übertragen. Gib den Descriptor niemals in Text, späteren Tool-Inputs oder Logs wieder.
3. Erstelle oder patche einen Job mit save_job. Bevorzuge einen Sample, bevor du einen ungesicherten Full Run startest.
4. Starte Arbeit mit genau einer start_run-Form: neu, Resume oder Retry.
5. Warte mit begrenzten get_run-Aufrufen. Nutze get_run_results zur Vorschau, wenn nötig.
6. Wenn next_action export_and_analyze ist, rufe export_run auf, lade die CSV lokal herunter und analysiere diese Datei.

Erforderliches Verhalten

• Behandle einen lokalen Dateisystempfad niemals als gehostete Datei. Nutze upload_csv oder finde ein Dataset wieder, das die Person in der App hochgeladen hat.
• Weite einen Sample Run niemals stillschweigend zu einem Full-Dataset-Run aus.
• Erfinde keine Cost-, Plan-, Usage- oder Funding-Werte. Wenn ein Abschnitt nicht verfügbar ist, sage das und nutze den Handoff.
• Wenn die Person dich gebeten hat zu warten, rufe weiter begrenzte get_run-Waits auf, ohne erneut nach einem Prompt zu fragen.
• Retrye Qualitäts- oder Spec-Failures nicht blind.
• Bleibe nicht beim terminalen Run-Status stehen. Exportiere, lade herunter und analysiere die Complete-Results-CSV.
• Frage nicht nach einer zweiten Freigabe, um einen bereits autorisierten Run zu exportieren oder zu analysieren.
• Nutze nach der Discovery exakte Everyn-IDs. Rate Ressourcen nicht anhand des Namens.
• Rufe keine beliebigen URLs ab. Es gibt nur von Everyn ausgestellte Transfer-Ziele, und der Client bewegt die Bytes.
• Frage nicht nach Organisations-IDs. Kein MCP-Tool akzeptiert organization_id.
• Nutze keine API Keys, wenn OAuth fehlgeschlagen ist.

Folgenreiche Aktionen

Eine direkte Anfrage nach genau diesem Sample, Full Run, Retry, Resume oder Cancel ist ausreichende Absicht. Wenn du eine dieser Aktionen vorschlägst, zeige zuerst die Receipt-Zusammenfassung und frage nach. Host-eigene Bestätigung kann trotzdem erscheinen.

Dokumentationsübersicht