FibaCloud MCP
Bulut hesabınızın bilgilerini yapay zekâ ile çalışma akışınıza taşıyın. FibaCloud MCP, uyumlu yapay zekâ uygulamalarının seçilen hizmet, fatura ve ürün kategorisi bilgilerini Model Context Protocol üzerinden, onayladığınız izinlerle okumasını sağlar.
Geliştiriciler ve büyüyen ekipler için akış somut: uyumlu bir araçta bulut hesabınız hakkında soru sorun, dönen bilgileri inceleyin ve erişimin kontrolünü elinizde tutun.
Beta, ana FibaCloud hesabınızla kurulan OAuth bağlantısı üzerinden üç salt okunur araç sunar. Erişim, mevcut API erişim yetkisinin kalan süresiyle sınırlıdır ve betada en fazla 3 saat sürer; daha erken sona erebilir. Süre dolduğunda uygulamanız üzerinden yeniden bağlanın. Ek kişi hesapları ve API girişinde MFA doğrulaması gerektiren akışlar bu betada desteklenmez.
Model Context Protocol nedir?
Model Context Protocol (MCP), yapay zekâ uygulamalarını harici verilere ve araçlara bağlayan açık bir protokoldür. Bir MCP sunucusu sunduğu araçları, bu araçların girdilerini ve döndürdüğü bilgileri tanımlar. Uyumlu bir uygulama, kullanıcı bu bilgilere ihtiyaç duyduğunda ilgili aracı çağırabilir.
FibaCloud MCP bu modeli bulut hesabınıza taşır. Akış yapay zekâ uygulamanız → FibaCloud MCP → FibaCloud API şeklindedir. MCP araç arayüzünü sağlar; hesap bilgilerinin kaynağı API olmaya devam eder. Entegrasyon, uygulamanızın onaylanan izinler kapsamında kullanacağı belirli bilgileri döndürür.
Betada sunulan üç araç
Beta araç seti salt okunurdur. Her bağlantı, onaylanan izinlerle sınırlıdır.
| Araç | İzin | Döndürülen bilgiler |
|---|---|---|
list_services | services:read | İzin verilen hizmetlerin kimlikleri, adları ve mevcut durum bilgileri. |
list_invoices | billing:read | Hesabın fatura özetleri; mevcut tarih, tutar, para birimi ve durum bilgileri. |
list_product_categories | catalog:read | Ürün kategorilerinin kimlikleri ve adları. |
Fatura izni hesap genelinde geçerlidir. Hizmetlere verilen erişim kapsamı, fatura özetlerini bu hizmetlerle sınırlandırmaz. Yalnızca hizmet veya kategori bilgisine ihtiyaç duyan bir bağlantı billing:read izni istememelidir.
Bu araçlar sunucu oluşturmaz veya silmez, DNS kaydı değiştirmez, sipariş vermez ve fatura ödemez. DNS bölgesi okuma bu betaya dahil değildir. Kategori aracı kategorileri listeler; fiyat hesaplayıcı işlevi sunmaz. Bildirilen hizmet durumları, uygulama sağlığının anlık testi değildir.
Hangi soruları sorabilirsiniz?
Bağlandıktan sonra aşağıdaki gibi soruları deneyebilirsiniz:
- Hizmetlere genel bakış: “Bu bağlantının okumasına izin verdiğim hizmetleri listele ve bildirilen durumlarını özetle.”
- Fatura inceleme: “Hesabım için dönen fatura özetlerini, son ödeme tarihleri ve para birimleriyle göster.”
- Ürün keşfi: “FibaCloud hangi ürün kategorilerini döndürüyor?”
Bunlar kullanım örnekleridir; canlı yanıtlar değildir. Sonuçlar hesaba, verilen izinlere ve API'nin döndürdüğü verilere bağlıdır. Hesabın tamamını incelemek için ilgili sonuç sayfalarının tümü alınmalıdır; tek bir sayfa listenin yalnızca bir bölümünü içerebilir.
Hesabınız ve bağlantı izinleri
OAuth bağlantısını yapay zekâ uygulamanızdan başlatın. Tarayıcınızda bir FibaCloud giriş sayfası açılır. Mevcut ana FibaCloud hesabınızla giriş yapın, istenen izinleri inceleyin ve erişimi onaylayın. MCP için ikinci bir FibaCloud hesabına ihtiyacınız yoktur.
Onay ekranındaki uygulama adını ve dönüş adresini kontrol edin. Uygulama adı istemci tarafından sağlanır; FibaCloud tarafından doğrulanmış bir uygulama rozeti değildir. Yapay zekâ uygulamasına hesap parolanız veya API tokenınız yerine ayrı bir MCP erişim anahtarı verilir.
Bu beta yalnız ana hesapları destekler. Ek kişi hesapları ve API girişinde ek MFA doğrulaması isteyen hesap akışları bağlantıyı tamamlayamaz. Bu işlemler için bulut panelini veya güncel API belgelerinde desteklenen bir entegrasyonu kullanın.
Erişim süresi ve iptal
Bağlantı erişimi, API erişim yetkisinin kalan süresi boyunca geçerlidir ve betada en fazla 3 saat sürer. İlgili yetki daha erken sona ererse bağlantı da daha erken sona erebilir. Beta, bu süreyi uzatmak için API yenileme tokenı saklamaz veya kullanmaz. Erişim sona erdiğinde yapay zekâ uygulamanızdan yeniden bağlanın; tarayıcıda giriş ve izin onayını tekrar tamamlayın.
Bağlantılarım sayfasını açın, giriş yapın ve ilgili bağlantıda Erişimi iptal et seçeneğini kullanın. Bu işlem sonraki MCP erişimini hemen durdurur; yapay zekâ uygulamasına daha önce gönderilmiş bilgileri silmez.
Araçların döndürdüğü bilgiler seçtiğiniz yapay zekâ uygulamasına iletilir. Özellikle fatura erişimi vermeden önce ilgili uygulamanın veri işleme koşullarını inceleyin. Hesap parolanızı veya API tokenınızı bir sohbet mesajına yapıştırmayın.
MCP mi, REST API mi?
| Yapmak istediğiniz iş | Uygun başlangıç noktası |
|---|---|
| API isteklerini doğrudan yöneten bir backend, betik veya uygulama geliştirmek. | FibaCloud REST API'yi kullanın. |
| Uyumlu bir yapay zekâ uygulamasının araçlarıyla belirli hesap bilgilerini okumak. | Aşağıdaki adımlarla FibaCloud MCP salt okunur betasına bağlanın. |
| Kaynak oluşturmak, yapılandırma değiştirmek veya üç salt okunur aracın dışındaki işlemleri gerçekleştirmek. | Bulut panelini ya da güncel API belgelerinde desteklenen bir işlemi kullanın. |
MCP, REST API'yi tamamlar. API'deki her işlemi sunmak yerine yapay zekâ çalışma akışları için seçilmiş bir araç setini erişime açar.
Uyumlu bir istemciyi bağlayın
HTTPS bağlantı adresi: https://mcp.fibacloud.com/mcp. Bu adresi uygulamanızın uzak MCP sunucusu ayarlarına girin; bu bir protokol uç noktasıdır, tarayıcı giriş sayfası değildir.
İstemci Streamable HTTP, tarayıcı üzerinden OAuth yetkilendirmesi ve PKCE S256 desteklemelidir. Açık OAuth Dinamik İstemci Kaydı (DCR, RFC 7591) kullanılabilir. DCR destekleyen bir istemci kendi bilgilerini ve dönüş adresini kaydeder; elle bir istemci kimliği almanız gerekmez. Yetkilendirmede kullanılan dönüş adresi, kayıtlı adresle tam olarak eşleşmelidir.
- Yapay zekâ uygulamanıza uzak bir MCP sunucusu ekleyin ve URL olarak
https://mcp.fibacloud.com/mcpgirin. - Uygulamanın OAuth bağlantı akışını başlatın. Tarayıcıdaki FibaCloud sayfasında ana hesabınızla giriş yapın.
- Uygulamayı, dönüş adresini ve istenen izinleri inceleyin; erişimi onaylayıp uygulamanıza dönün.
- Uygulamanın araç listesini yenileyin ve onayladığınız izinlerin kapsadığı araçları kullanın. Bağlantının süresi dolduğunda giriş akışını tekrarlayın.
Kurulum ekranları istemciye göre değişir. Yalnızca MCP desteği, bu uzak OAuth akışıyla uyumluluğu göstermez; istemcinin bağlantı, yetkilendirme ve kayıt özelliklerini kontrol edin. Sunucu URL'sine veya sohbet mesajına API tokenı ya da hesap parolası eklemeyin.
FibaCloud ile devam edin
- API referansı: mevcut API'yi inceleyin ve entegrasyona başlayın.
- Sunucu belgeleri: işlem hizmetlerini ve kullanımını tanıyın.
- Alan adları ve DNS: DNS bölgelerinin ve kayıtlarının yönetimini öğrenin.
- Başlangıç kılavuzları: platformun kurulum adımlarına ulaşın.