REST /v2, MCP und lokale Einrichtung

Öffentliche Abfragen benötigen keine Anmeldung. /v1 bleibt verfügbar; /v2 ergänzt Aufgaben, Verbindungen und Prüfbelege. Der private Projektzugang nutzt einen eigenen Bearer-Schlüssel.

Mit einer Aufgabe beginnen

curl -X POST https://api.tracevero.com/v2/workflows/plan \
  -H 'Content-Type: application/json' \
  -d '{"task_id":"gmail-attachments-drive","apps":["gmail","google-drive"]}'

Die Antwort nennt Quellen, Abrufdaten, Katalog- und Regelversion sowie fehlende Schritte. Ein dokumentierter API-Aufruf ist kein praktisch bestätigter Ablauf.

REST /v2

GET /v2/capabilities · find_capabilities
POST /v2/workflows/plan · plan_workflow
GET /v2/connections/:type/:slug · get_connection_options
GET /v2/verifications/:type/:slug · get_verification
POST /v2/compatibility/check · check_compatibility
POST /v2/permissions/explain · explain_permissions
POST /v2/config/validate · validate_config
POST /v2/configure · configure
GET /v2/capability-gaps · get_capability_gaps
POST /v2/changes/impact · get_change_impact
GET /v2/replacements · find_replacement
POST /v2/workflows/snapshot · snapshot

OpenAPI /v2 · Private Überwachung

MCP · Streamable HTTP

https://api.tracevero.com/mcp · tracevero://guide

search: Öffentliche Einträge suchen
fetch: Eintrag mit Quellen lesen
compare: Deklarierte Merkmale vergleichen
configure: Verbindungsvorlage vorbereiten
plan_workflow: Aufgabe in belegte Schritte zerlegen
get_connection_options: Verbindungsvarianten und Prüfgrenzen lesen
validate_config: Bereinigte Konfiguration prüfen

Einrichtung im Client

Verbindung und Belege

curl 'https://api.tracevero.com/v1/suche?q=github&grenze=2'
# Use an ID returned by search, for example mcp/<slug>:
curl 'https://api.tracevero.com/v2/connections/mcp/<slug>'
curl 'https://api.tracevero.com/v2/verifications/mcp/<slug>'
curl 'https://api.tracevero.com/v2/verification-reports/github-remote-public-read'

Den Platzhalter durch eine Kennung aus der Suche ersetzen. Quellenlinks und Datum beim Weiterverwenden erhalten; ein früherer Lesetest belegt keine heutigen Schreibrechte.

Docker: Umgebungsvariable weitergeben

Reproduzierbare Konfigurationsprüfung, kein gestarteter Docker- oder Anbietertest. example:1 und API_TOKEN sind Platzhalter. Die Variable im Client-Prozess allein übergibt sie noch nicht an den Container.

{
  "servers": {
    "example": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "example:1"
      ],
      "env": {
        "API_TOKEN": "<REDACTED>"
      }
    }
  }
}

Gemeldeter Befund: docker_environment_not_forwarded

{
  "servers": {
    "example": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_TOKEN",
        "example:1"
      ],
      "env": {
        "API_TOKEN": "REDACTED"
      }
    }
  }
}

Die Ergänzung -e API_TOKEN reicht den lokal vorhandenen Wert weiter. Sie beweist weder einen gültigen Token noch ausreichende Rechte. Das konkrete Image auf eine geprüfte Version festlegen und nur einen kleinen erlaubten Vorgang testen.

Eigene bereinigte Konfiguration prüfen

Python · TypeScript

tracevero.py · tracevero.ts · SDK + Beispiele · SHA-256 · SDK 0.2.0 (GitHub)

from tracevero import TraceVero
client = TraceVero()
plan = client.plan_workflow(task_id="gmail-attachments-drive")
print(plan["coverage"])

import { TraceVero } from './tracevero.ts';
const client = new TraceVero();
const plan = await client.planWorkflow({ task_id: 'gmail-attachments-drive' });
console.log(plan.coverage);

Privater Test und Überwachung

Projekt erstellen, Schlüssel lokal sichern und den begrenzten lokalen Prüfläufer mit dedizierten Testkonten einrichten. Berichte enthalten nur Prüfnamen und Statuswerte. Der Server prüft Quellen, führt aber keine Anbieteroperation aus.

Projekt einrichten · Prüfläufer-Anleitung

Fehler und Wiederholungen

400 invalid_request / invalid_json: Eingaben gegen OpenAPI prüfen.
404 entry_not_found / project_unavailable: Kennung und beim privaten Zugang den Schlüssel prüfen.
409 run_id_conflict: Dieselbe Laufkennung darf keinen anderen Bericht erhalten.
413 request_too_large: Rumpf begrenzen; keine echten Konfigurationsgeheimnisse senden.
429: Retry-After beachten. Schreibvorgänge vor Wiederholung am Ziel prüfen.

Öffentliche Prüfberichte

tracevero · https://tracevero.de/developers