REST API¶

Birincil interface /mcp üzerindeki MCP’dir. Health check, file link ve seçili service operation’lar için REST surface de vardır.

Sağlık¶

GET /healthz

Sunucu sağlığını ve temel durum bilgisini döndürür.

MCP¶

POST /mcp

ChatGPT ve diğer MCP client’ların kullandığı Streamable HTTP MCP endpoint.

REST üzerinden araç çağrıları¶

REST araç çağrıları tutarlı başarı/hata envelopes kullanır. Doğrulama hataları ham framework istisnaları yerine yapılandırılmış ok: false payload döndürür.

Agent Skills¶

Sabit Skills registry REST üzerinden de kullanılabilir:

GET  /tools/skill_list
POST /tools/skill_load       {"name": "debugging"}
POST /tools/skill_read  {"name": "debugging", "path": "checklist.md"}

Skill dizinlerindeki değişiklikler bir sonraki çağrıda görünür ve MCP araç listesini değiştirmez.

Dosya bağlantıları¶

Token’lı dosya indirmeleri yerleşik HTTP uygulaması tarafından sunulur. Bağlantılar TTL, isteğe bağlı azami indirme sayısı ve iptal desteğine sahip bearer URL’lerdir.

Kimlik doğrulama¶

Genel kullanıma açık dağıtımlarda OAuth kullanılmalıdır. Geliştirme için localhost bypass etkinleştirilebilir, ancak kimlik doğrulamasız genel erişim güvenli değildir.