[go: up one dir, main page]

MCP

Model Context Protocol

Steuern Sie Noveum mit unterstützten KI-Clients.

Einrichtungsanleitungen sind für Claude, Cursor, VS Code, ChatGPT und weitere verbreitete MCP-Clients verfügbar. Die Kompatibilität variiert je nach Client-Version. Nach der Verbindung kann Ihr Agent in natürlicher Sprache Traces durchsuchen, Evals ausführen, Simulationen starten und NovaPilot-Analysen anstoßen.

noveum-mcp
HTTP · OAuth 2.1

MCP-Endpunkt

ToolsGeneriert

tracesdatasetsevals

Ressourcen16

noveum://projectsnoveum://scorers

Prompts21

debug_tracesrun_evaluation

Ein Endpunkt · unterstützte Noveum-Workflows

Verbinden

Verbinden Sie den Client, den Sie bereits verwenden.

Fügen Sie Ihrem bestehenden Client einen Endpunkt hinzu. Für Headless-Umgebungen geben Sie einen API-Schlüssel ein. Alternativ genügt die URL und Sie melden sich über OAuth an.

  1. Endpunkt hinzufügen

    Richten Sie einen unterstützten MCP-Client auf noveum.ai/api/mcp aus. Einrichtungsanleitungen sind für Cursor, Claude Code, VS Code, ChatGPT und weitere Clients mit kompatibler Streamable-HTTP- und Authentifizierungsunterstützung verfügbar.

  2. Anmelden oder Schlüssel eingeben

    Clients, die nur eine URL benötigen, öffnen automatisch die Anmeldung und Einwilligung von Noveum. Headless-Umgebungen senden stattdessen einen API-Schlüssel im Authorization-Header.

  3. Agenten beauftragen

    Tools, Ressourcen und Prompts werden beim Verbinden geladen. Fragen Sie in natürlicher Sprache nach fehlerhaften Traces, einem Eval-Durchlauf oder einer NovaPilot-Analyse.

Kein Schlüssel erforderlich: Clients mit Unterstützung der MCP-Autorisierung erkennen OAuth automatisch. URL hinzufügen, einmal zustimmen und die Verbindung steht.

Vollständige Serverreferenz lesen
terminal
# Choose one authentication option.
# Option A: OAuth sign-in (URL-only)
claude mcp add --transport http noveum "https://noveum.ai/api/mcp"
# Option B: run instead of Option A for a headless Bearer API key
claude mcp add --transport http noveum "https://noveum.ai/api/mcp" \
--header "Authorization: Bearer NOVEUM_API_KEY"

Tools · Ressourcen · Prompts

Bringen Sie unterstützte Noveum-Workflows zu Ihrem Agenten.

Tools werden aus der aktuellen OpenAPI-Spezifikation erzeugt. 16 Ressourcen und 10 Ressourcenvorlagen liefern Ihrem Agenten vor der Planung reale IDs und Slugs, während 21 Prompts geführte Workflows bündeln.

Tools

Unterstützte HTTP-Aktionen aus der aktuellen OpenAPI-Spezifikation: Datensätze auflisten, Jobs starten und den Fortschritt bis zum Abschluss abrufen.

Traces

Erfasste Spans, Fehler und Latenzen über aufgezeichnete Deployment-Versionen hinweg durchsuchen.

Datasets

Eval-Datasets aus realem Datenverkehr erstellen, versionieren und veröffentlichen.

Evals

Eval-Jobs starten, Durchläufe abrufen und bewertete Ergebnisse lesen.

ETL-Pipelines

Extraktionspipelines erstellen und Mapper mit NovaEval erzeugen.

Scorers

112 veröffentlichte Scorer durchsuchen oder Empfehlungen für ein Dataset erhalten.

Projekte

Projekte, Umgebungen, Nutzung und Organisationsstatus auflisten.

NovaPilot

Analysen starten, Berichte lesen und wiederkehrende Zeitpläne verwalten.

NovaSynth

Personas erzeugen, Simulationen starten und Analysen abrufen.

Ressourcen

Zuerst zu lesender Kontext wird als JSON bereitgestellt. So stammen alle IDs, Slugs und Filter-Enums aus realen Daten statt aus Vermutungen.

  • noveum://projects
  • noveum://scorers
  • noveum://filter-values
  • noveum://org-status
  • noveum://datasets
  • noveum://eval-jobs
  • noveum://etl-jobs
  • noveum://novapilot-schedules
  • noveum://novasynth-runs
  • noveum://agent-versions
  • +6 weitere

Prompts

Geführte Prompts legen fest, welche Tools verkettet, welche Ergebnisse abgerufen und wann Abläufe beendet werden. Der Client entscheidet, wie Prompt-Namen dargestellt werden.

  • debug_traces
  • run_evaluation
  • analyze_with_novapilot
  • optimize_costs
  • trace_error_triage
  • compare_eval_runs
  • recommend_scorers_for_dataset
  • full_agent_improvement_cycle
  • test_voice_agent
  • download_novapilot_report_markdown
  • +10 weitere

Rezepte

Reale Workflows in natürlicher Sprache.

Keine Dashboards, keine Abfragesprache. Verbinden Sie Ihren Agenten mit Noveum und beschreiben Sie das gewünschte Ergebnis. Diese Abläufe nutzen Teams täglich.

Fehler finden und priorisieren

debug_traces

Lassen Sie Ihren Agenten direkt aus Ihren Live-Traces ermitteln, was im Produktivbetrieb aus welchem Grund fehlschlägt.

Finde die Fehler-Traces der letzten 24 Stunden, gruppiere sie nach Ursache und zeige mir die drei schwerwiegendsten Fälle mit Beispiel-Spans.

Traces in eine Evaluierung verwandeln

run_evaluation

Erstellen Sie ein Dataset aus realem Datenverkehr und bewerten Sie konfigurierte Elemente mit ausgewählten kompatiblen Scorern.

Erstelle ein Dataset aus den fehlgeschlagenen Traces von gestern, führe eine Evaluierung mit kompatiblen Scorern aus und fasse die Elemente mit den niedrigsten Scores samt verknüpfter Belege zusammen.

Modellkosten senken

optimize_costs

Lassen Sie Ihren Agenten die Nutzung einer Woche zusammenfassen und kostengünstigere Konfigurationen identifizieren, die Ihr Team testen kann.

Analysiere meine Token-Nutzung und Latenz in dieser Woche, identifiziere die teuersten Modellpfade und schlage kostengünstigere Kandidaten für eine kontrollierte Evaluierung vor.

Den Kreislauf End-to-End schließen

full_agent_improvement_cycle

Verknüpfen Sie Trace-Prüfung, Dataset-Erstellung, Evaluierung und eine NovaPilot-Analyse in einer geführten Anfrage.

Prüfe die Traces meines Checkout-Assistenten, erstelle ein Dataset, führe eine Evaluierung aus, starte eine NovaPilot-Analyse und fasse die Empfehlung mit der höchsten Priorität samt ihrer Belege zusammen.

Authentifizierung

Als Mensch anmelden oder als Maschine authentifizieren.

Zwei Modi, ein Endpunkt. Beide berücksichtigen die Rollen Ihrer Organisation. Ein verbundener Agent kann nie mehr ausführen als Sie selbst.

Standard

Anmeldung mit OAuth 2.1

Für interaktive Clients. URL hinzufügen, einmal zustimmen und die Verbindung steht. Kein Schlüssel muss eingefügt und keine OAuth-App registriert werden.

  • Einwilligung pro Nutzer mit festen Lese-, Schreib- und Ausführungsbereichen
  • Jedes Token ist an eine bei der Einwilligung ausgewählte Organisation gebunden
  • Jede App unter Einstellungen → Verbundene Apps sofort widerrufen
Headless

Bearer-API-Schlüssel

Für CI-Pipelines, Cron-Jobs und Server-zu-Server-Clients, die benutzerdefinierte Bearer-Header unterstützen, aber keine Browser-Anmeldung durchführen können.

  • Derselbe Schlüssel wie für die REST-API, gesendet als Authorization-Header
  • Auf Ihre Organisation begrenzt und jederzeit austauschbar
  • Einen bestimmten Schlüssel für skriptgesteuerte, reproduzierbare Umgebungen festlegen

noveum.read

Projekte, Traces, Datasets, Evals und Berichte lesen

noveum.write

Datasets, Jobs und Einstellungen erstellen und aktualisieren

noveum.execute

Jobs für ETL, Evals, NovaPilot und NovaSynth starten

Berechtigungsbereiche schränken die Möglichkeiten einer verbundenen App ausschließlich weiter ein. Ihre Rolle und RBAC-Berechtigungen in der Organisation gelten zusätzlich.

FAQ

Antworten auf Ihre MCP-Fragen.

Was ist der Noveum MCP-Server?
Der Noveum MCP-Server ist ein entfernter Model-Context-Protocol-Server unter noveum.ai/api/mcp. Die Verbindung gibt einem unterstützten Client sicheren Zugriff auf Tool-Ebene auf Ihren Noveum-Workspace. Traces, Datasets, Evaluierungen, Scorer und Workflows zur Agentenverbesserung lassen sich in natürlicher Sprache steuern.
Welche KI-Clients können sich verbinden?
Einrichtungsanleitungen sind für Claude und Claude Code, Cursor, VS Code, ChatGPT im Entwicklermodus, Windsurf, Cline, Replit, Zed, Goose und weitere Clients verfügbar. Transport- und Authentifizierungsunterstützung ändern sich zwischen Client-Versionen; prüfen Sie daher Ihre aktuelle Version. Kompatible URL-Clients können sich über OAuth anmelden. Headless- oder skriptgesteuerte Clients wie cURL, Python und CI können einen Bearer-API-Schlüssel verwenden.
Benötige ich einen API-Schlüssel oder wird OAuth verwendet?
Beides funktioniert über denselben Endpunkt. Interaktive Clients erkennen OAuth 2.1 automatisch. Sie fügen die URL hinzu, stimmen einmal zu und sind ohne einzufügenden Schlüssel verbunden. Headless-Umgebungen senden stattdessen einen Authorization: Bearer-Header mit einem Noveum-API-Schlüssel.
Was kann ein Agent damit konkret ausführen?
Aus der aktuellen Noveum-OpenAPI-Spezifikation generierte Tools können Traces durchsuchen und lesen, Datasets erstellen, Evaluierungen ausführen, Scorer verwalten und unterstützte ETL-, NovaPilot- sowie NovaSynth-Jobs starten. Der Server veröffentlicht außerdem 16 Ressourcen, 10 Ressourcenvorlagen und 21 geführte Prompts. Jede Aktion berücksichtigt die Rollen und Berechtigungen Ihrer Organisation.
Ist die Verbindung sicher und wie funktionieren Berechtigungen und Widerruf?
OAuth-Tokens sind an eine einzelne Organisation gebunden, die Sie bei der Einwilligung auswählen, sowie an grobe Berechtigungsbereiche zum Lesen, Schreiben und Ausführen, welche die Möglichkeiten einer verbundenen App nur weiter einschränken. Ihre RBAC-Berechtigungen gelten zusätzlich. Widerrufen Sie verbundene Apps unter Einstellungen, Verbundene Apps. Die Ablaufzeit wird beim Erstellen jedes API-Schlüssels gewählt; bei Bedarf können Sie einen Schlüssel jederzeit unter Einstellungen widerrufen oder ersetzen.
Entstehen für die Verbindung zusätzliche Kosten?
Nein. Der MCP-Server ist in Noveum enthalten und für die Verbindung fällt keine separate Gebühr an. Die Nutzung der zugrunde liegenden Plattform für Traces, Evaluierungen und Jobs richtet sich nach Ihrem regulären Noveum-Tarif.

Nächster Schritt

Schließen Sie Ihre Agenten an den Kreislauf an

Produktive KI-Agenten, denen Ihre Kunden vertrauen können.

Im Produktivbetrieb bewährt bei Enterprise- und wachstumsstarken Teams