Hosted MCP endpoint https://mcp.converterhq.io/mcp, REST API ile aynı ConverterHQ kaynakları üzerinde çalışan stateless Streamable HTTP sunucusudur. HQTools OAuth kalıcı API key’leri AI istemcilerinden uzak tutar.
Bağlanma
https://mcp.converterhq.io/mcp adresini Streamable HTTP sunucusu olarak ekleyin. Lansman matrisi yalnızca MCP 2026-07-28 sürümünü destekler: her istek aynı sürümü MCP-Protocol-Version başlığında ve params._meta["io.modelcontextprotocol/protocolVersion"] içinde göndermelidir. Yalnızca initialize kullanan eski istemciler desteklenen matrise dahil değildir. Ayrıca params._meta["io.modelcontextprotocol/clientCapabilities"] değerini nesne olarak gönderin (isteğe bağlı uzantı yoksa {}).
OAuth ve scope’lar
MCP endpoint’i kalıcı ConverterHQ API anahtarları yerine yetkilendirilmiş OAuth token’larını kabul eder. Bir Task okumak converterhq.tasks.read, iptal etmek converterhq.jobs.write gerektirir; salt-okunur bir grant yürütmeyi değiştiremez.
Araç kataloğu
On üç araç dönüştürme, tahmin, format ve capability, Job oluşturma/doğrulama/iptal, Task inceleme, Workflow ve kullanım işlevlerini kapsar. convert_file bir HTTPS URL kabul eder; yerel dosya veya ek için önce Files API ve imzalı doğrudan yükleme akışını kullanın ya da istemcinin sağladığı HTTPS URL’yi verin.
Kalıcı Tasks
MCP Tasks uzantısını müzakere eden istemciler bir ConverterHQ Job’a eşlenen kalıcı task alabilir ve daha sonra inceleyip iptal edebilir. Diğerleri Job ID ve get_job kullanır; yürütme için ilk tool çağrısının açık kalması gerekmez.
Workflow değişkenleri
run_workflow, POST /v1/workflows/{id}/run ile aynı doğrulanmış variables, client_reference_id ve metadata değerlerini kabul eder. Schema agent’ın Job oluşturulmadan önce neyi değiştirebileceğini sınırlar.
Güvenli işletim
Minimum OAuth scope kullanın, hassas dış side effect’lerden önce gerektiğinde insan onayı tutun, Job ID’leri saklayın ve istemci artık güvenilir değilse OAuth grant’i iptal edin.