HOC SiteDokümantasyon

Bağlanma ve kimlik doğrulama

MCP isteklerini yetkilendirmenin üç yolu — tarayıcı oturumu üzerinden OAuth, bearer belirteç olarak gönderilen API anahtarı veya login aracından alınan kısa ömürlü erişim belirteci.

MCP mevcut platform hesabınızı kullanır. Kayıt akışı yoktur ve MCP sizin adınıza hesap oluşturamaz.

OAuth

Çoğu MCP istemcisi OAuth destekler. İstemci bir tarayıcı oturumu açar, platform e-posta ve parolanızla giriş yaparsınız ve istemci kendi yenileyebileceği bir belirteç alır. Bu yolu tercih edin: yapılandırma dosyasına kopyalanan bir gizli değer olmaz.

API anahtarları

Hesap ayarlarınızdan bir API anahtarı oluşturun ve Authorization: Bearer <anahtar> olarak gönderin. API anahtarları tarayıcı akışını tamamlayamayan istemciler için doğru seçimdir.

Anahtarlar siteye değil kullanıcıya aittir. Bir anahtar hesabınızın erişebildiği her siteye ulaşabilir; parola gibi saklayın ve sızdıysa değiştirin.

login aracı

login platform e-posta ve parolanızı alır ve bir gün geçerli erişim belirteci döndürür. İstemci OAuth desteklemiyorsa ve API anahtarı saklamak istemiyorsanız kullanın. Belirteç bittiğinde login aracını yeniden çağırın.

login yalnızca oturumda belirteç yokken kayıtlıdır; kimlik doğrulandıktan sonra araç listesinde görünmez.

Belirtecin yetkisi

Belirteç sizin izinlerinizi taşır, ayrı bir ajan izin seti yoktur. Site erişimi, nesne izinleri ve rol dilimleri paneldekiyle aynı şekilde uygulanır. Panelde yazamadığınız bir şeyi yazan araç forbidden döndürür.

401 unauthorized belirtecin eksik, süresi geçmiş veya geçersiz olduğu anlamına gelir. 403 forbidden belirtecin geçerli olduğu ama hesabın site veya rol izninin olmadığı anlamına gelir; yeniden giriş yapmak bunu değiştirmez. Site erişimini ve rol izinlerini kontrol edin.

İlgili