Der gehostete MCP-Endpunkt https://mcp.converterhq.io/mcp ist ein zustandsloser Streamable-HTTP-Server über denselben ConverterHQ-Ressourcen wie die REST-API. HQTools OAuth hält dauerhafte API-Schlüssel aus KI-Clients heraus.
Verbinden
Fügen Sie https://mcp.converterhq.io/mcp als Streamable-HTTP-Server hinzu. Die Launch-Matrix unterstützt ausschließlich MCP 2026-07-28: Jede Anfrage muss dieselbe Version im Header MCP-Protocol-Version und in params._meta["io.modelcontextprotocol/protocolVersion"] senden. Ältere reine initialize-Clients gehören nicht zur unterstützten Matrix. Senden Sie außerdem params._meta["io.modelcontextprotocol/clientCapabilities"] als Objekt ({} ohne optionale Erweiterungen).
OAuth und Scopes
Der MCP-Endpunkt akzeptiert delegierte OAuth-Token, keine dauerhaften ConverterHQ-API-Schlüssel. Das Lesen einer Task erfordert converterhq.tasks.read, das Abbrechen converterhq.jobs.write; ein reiner Lese-Grant kann die Ausführung daher nicht verändern.
Tool-Katalog
Dreizehn Tools decken Konvertierung, Schätzung, Formate und Capabilities, Job-Erstellung/-Validierung/-Abbruch, Task-Inspektion, Workflows und Usage ab. convert_file akzeptiert eine HTTPS-URL; lokale Dateien oder Anhänge laden Sie zuerst über die Files-API und den signierten Direkt-Upload hoch oder verwenden eine vom Client bereitgestellte HTTPS-URL.
Dauerhafte Tasks
Clients mit ausgehandelter MCP-Tasks-Erweiterung können eine dauerhafte MCP-Task erhalten, die auf einen ConverterHQ-Job zeigt, und sie später prüfen oder abbrechen. Andere nutzen Job-ID und get_job; die Ausführung benötigt keine offene ursprüngliche Tool-Verbindung.
Workflow-Variablen
run_workflow akzeptiert dieselbe validierte Variablen-Map, client_reference_id und metadata wie POST /v1/workflows/{id}/run. Das Workflow-Schema begrenzt, was ein Agent vor Job-Erstellung einsetzen darf.
Sicher betreiben
Verwenden Sie minimale OAuth-Scopes, menschliche Freigabe vor sensiblen externen Effekten wenn nötig, speichern Sie Job-IDs und widerrufen Sie den OAuth-Grant, sobald der Client nicht mehr vertraut wird.