HOC SiteDokümantasyon

Yapay zekâ ajanları (MCP)

HOC Site MCP sunucusu, yönetim paneli ve REST API ile aynı platform yeteneklerini HTTP üzerinden sunar; ajanlar gerçek site verisini okuyup yazabilir.

MCP mevcut platform hesabınızı kullanır. Kendi başına hesap oluşturmaz.

Ajanınız veya MCP istemciniz büyük olasılıkla OAuth destekler; tarayıcı oturumu üzerinden yetki verirsiniz. OAuth kullanılmadığında veya istemci kimlik bilgilerini yenilemesi gerektiğinde login aracı e-posta ve parolanızla kimlik doğrulama isteğinde bulunur.

MCP HTTP isteklerini kullanıcı ayarlarından aldığınız API anahtarıyla da yetkilendirebilirsiniz. OAuth kullanamayan istemciler anahtarı Authorization: Bearer olarak göndermelidir. Login ucundan alınan bir günlük erişim belirteci de süresi dolana kadar çalışır.

Sunucunun sundukları

  • Talimatlar. get_mcp_instructions geçerli kuralları döndürür: tasarım oyun kitabı ve araç bazlı ipuçları.
  • Belgeler. get_docs belge okuyucusudur. Tüm ağacı tek çağrıda almak için mode=manifest, tek sayfa için mode=content, birkaç sayfayı bağımlılıklarıyla birlikte almak için mode=bundle kullanın.
  • Araçlar. Kayıtlı her aracın MCP araçları altında bir sayfası vardır: girdiler, çağırdığı REST uçları ve aynı işi yapan yönetim ekranı.
  • Tasarım katalogları. Blok şemaları canlı katalogdan gelir; blok türlerini yalnızca get_docs yanıtlarından ekleyin.

Verimli okuma

mode=bundle ile tek bir get_docs çağrısı, alışılmış keşif döngüsünün yerini alır:

  • paths ihtiyacınız olan sayfaları adlandırır, örneğin design/page ve objects/lifecycles.
  • include bağımlılıkları ekler: body, ancestors, children, shared-concepts, blocks, lifecycles, related-tools, related-endpoints.
  • depth kaç seviye alt öğe döneceğini belirler.
  • budgetBytes yanıtı sınırlar. Sığmayan sayfalar sessizce kesilmek yerine omitted içinde listelenir.

Bağlanma

Bağlanma ve kimlik doğrulama OAuth, API anahtarları ve login aracını anlatır. Her aracın REST karşılığı API uçları kataloğundadır.