Belgeler menüsüYapay zekâ ve MCP

Yapay zekâ asistanı ve MCP

Pro sürümde iki özellik vardır: kendi Anthropic veya Google Gemini anahtarınızla çalışan panel içi asistan ve Claude Desktop, Claude Code, OpenAI Codex gibi istemcileri API tokenıyla panele bağlayan MCP sunucusu. İkisi de kullanan kişinin yetkileriyle çalışır, değişiklikler onay ister ve gizli değerler ayıklanır.

Son güncelleme:

Bu sayfada
  1. İki ayrı parça
  2. Ayarlar
    1. Sağlayıcı ve API anahtarı
    2. Asistan seçenekleri
  3. Asistanı kullanmak
    1. Sağlayıcıya giden veriler
  4. MCP sunucusu
    1. MCP seçenekleri
    2. Token ve yetkiler
    3. İstemci bağlamak
  5. İlgili sayfalar

Yapay zekâ asistanı ve MCP sunucusu Pro sürümün özellikleridir. Topluluk sürümünde bu menüler çalışmaz ve /api/mcp istekleri reddedilir. Sürüm farkları için Fiyatlar sayfasına bakın.

#İki ayrı parça

Yapay zekâ asistanıMCP sunucusu
Nerede çalışırPanelin içinde, üst çubuktan açılan sohbetSizin yapay zekâ uygulamanızda
Yapay zekâ anahtarıGerekli (Anthropic veya Google Gemini)Gerekmez
KimlikPanel oturumunuzAPI tokenı veya sunucudaki CLI tokenı
Değişiklik onayıEkranda onay kartıİstemcinin "confirm": true göndermesi

İkisi de aynı araç kataloğunu kullanır. Araçlar hiçbir işlemi doğrudan yapmaz: her çağrı, kullanan kişinin kimliğiyle panelin kendi API uç noktalarına gider. Yetki, paket özellikleri, bayi kapsamı ve işlem geçmişi kuralları panelin geri kalanıyla aynıdır; araçlar üzerinden yetki yükseltilemez.

#Ayarlar

Ayarlar Sunucu Yönetimi → Sistem → Yapay zekâ ve MCP sayfasındadır (yalnızca sunucu yöneticisi). Sayfada üç sekme vardır: Asistan, Kullanım ve sınırlar ve MCP.

#Sağlayıcı ve API anahtarı

Asistan iki sağlayıcıyla çalışır; kendi API anahtarınızı girersiniz:

SağlayıcıAnahtarModeller
AnthropicAnthropic Console → API Keys (sk-ant-…)Claude Sonnet 5 (varsayılan), Claude Opus 5.5
Google GeminiGoogle AI Studio → API keys (AIza…)Anahtarınızın erişebildiği modeller listelenir; varsayılan Gemini 3.8 Flash

Anahtarlar şifreli saklanır, bir daha gösterilmez; arayüzde yalnızca kısaltılmış ipucu (sk-ant-…ab12 gibi) görünür. Dene düğmesi anahtarı sağlayıcıya karşı sınar. Seçili sağlayıcı yalnızca yeni sohbetleri etkiler: her sohbet başladığı sağlayıcı ve modelle devam eder. Anahtarı kaldırırsanız asistan kapanır, MCP sunucusu çalışmaya devam eder.

#Asistan seçenekleri

SeçenekVarsayılanAçıklama
Yapay zekâ asistanını açKapalıKapalıyken sohbetler görünmez, yeni istek yapılmaz
Düşünme düzeyiOrtaDüşük, orta veya yüksek; yanıt kalitesi ile token harcaması arasındaki denge
Kişi başına günlük token bütçesi200.000En az 1000 veya sınırsız; tüm sağlayıcılarda girdi, önbellek, çıktı ve düşünme tokenları toplamı
Sohbet saklama süresi (gün)30Son etkinliği bu süreden eski sohbetler silinir
Kimler kullanabilirHepsi açıkSunucu yöneticisi, bayi, hesap sahibi

Kullanım ve sınırlar sekmesi bugünkü kullanımı kişi ve sağlayıcı bazında, son 14 günün toplamlarını gösterir; burada kullanıcı adına özel günlük sınır (sınırsız veya 0 ile kapalı) tanımlanabilir. Bütçe dolunca asistan o gün yeni istek yapmaz. Bir yönetici başka bir hesaba "olarak" girdiyse kullanım yöneticinin bütçesinden, ekip üyelerinin kullanımı ise hesap sahibinin bütçesinden düşer.

#Asistanı kullanmak

Asistan üst çubuktan çekmece olarak veya menüden açılır:

  • Kullanıcı paneli: Gelişmiş → Yapay Zekâ Asistanı
  • Sunucu Yönetimi: Sistem → Yapay zekâ asistanı (sunucu yöneticisi ve bayi)

Hesap sahipleri için paket bazında Yapay zekâ asistanı paket özelliğiyle kapatılabilir. Asistan site teşhisi, DNS ve e-posta sorunları, SSL durumu, yedekler ve kaynak kullanımı gibi konularda araçlarla bilgi toplar. Kabuk, dosya sistemi veya internet erişimi yoktur; yalnızca listelenen araçları kullanır.

Salt okunur araçlar hemen çalışır. Değişiklik yapan araçlar (oluşturma, güncelleme, silme, askıya alma, servis yeniden başlatma, sertifika alma, yedek başlatma) için ekranda bir onay kartı çıkar ve işlem ancak siz onaylayınca çalışır; onay beklerken yeni mesaj yazarsanız bekleyen çağrılar reddedilmiş sayılır. Onaylanan her değişiklik işlem geçmişine yazılır. Bir yanıt en fazla 12 araç adımı sürer; sınıra ulaşılırsa "devam et" yazarak sürdürebilirsiniz.

#Sağlayıcıya giden veriler

Sohbet mesajları ve asistanın çağırdığı araçların sonuçları (alan adı ayarları, DNS kayıtları, günlük satırları, hesap özetleri…) yanıt üretmek için sohbetin sağlayıcısına gönderilir. Gönderilmeden önce parolalar, özel anahtar blokları, API tokenları, JWT'ler, bulut erişim anahtarları ve adreslerdeki kimlik bilgileri [redacted] ile değiştirilir. Sohbetler panelin veritabanında aynı ayıklanmış hâliyle, saklama süresi boyunca tutulur; her kişi yalnızca kendi sohbetlerini görür (ekip üyeleri ve hesap sahibi birbirininkini göremez).

#MCP sunucusu

Model Context Protocol (MCP) sunucusu, MCP destekleyen yapay zekâ uygulamalarının (Claude Desktop, Claude Code, OpenAI Codex ve diğerleri) panele bağlanmasını sağlar. İki taşıma vardır:

  • Streamable HTTP: panel adresinizdeki /api/mcp uç noktası, Authorization: Bearer <API_TOKEN> ile.
  • stdio: sunucudaki bipanel mcp komutu. İletileri çalışan panelin /api/mcp ucuna iletir ve varsayılan olarak sunucudaki CLI tokenını kullanır, yani tam sunucu yöneticisi yetkisiyle çalışır.

Sunucu araçlar, özet kaynaklar (hesap özeti, sunucu durumu, hesap ayrıntısı) ve iki hazır istem (site teşhisi, güvenlik denetimi) sunar. Açık oturumlar MCP sekmesinde listelenir; 24 saat etkinlik olmayan oturumlar kapanır.

#MCP seçenekleri

SeçenekVarsayılanAçıklama
MCP sunucusunu açAçık/api/mcp ve bipanel mcp; yapay zekâ anahtarı gerektirmez
Hesap sahipleri bağlanabilirAçıkKendi API tokenlarıyla, yalnızca kendi hesaplarının araçlarına
Değişiklik yapan araçları sunAçıkKapalıyken istemciler yalnızca okuma yapabilir

Hesap sahipleri için paket bazında MCP erişimi paket özelliğiyle de kapatılabilir.

#Token ve yetkiler

MCP araçları tokenın sahibinin yetkileriyle çalışır; tokenlarda ayrı bir kapsam ayarı yoktur. Bu yüzden MCP için ayrı bir token oluşturun ve gerekirse süre verin (30 gün, 90 gün, 1 yıl veya süresiz). Tokenlar Gelişmiş → API Tokenları (kullanıcı paneli) ve Sistem → API tokenları (Sunucu Yönetimi) sayfalarında oluşturulur ve iptal edilir; token yalnızca oluşturulduğu anda gösterilir.

Token sahibiGörebildiği
Sunucu yöneticisiTüm hesaplar ve sunucu araçları (servisler, servis günlükleri, yedekleme, posta kuyruğu, güvenlik özeti dahil)
BayiYalnızca kendi müşteri hesapları; yalnızca sunucu yöneticisine açık araçlar listelenmez
Hesap sahibiYalnızca kendi hesabı; paketin kapattığı özelliklerin araçları listelenmez

Değişiklik yapan araçlar yalnızca istemci aynı çağrıyı "confirm": true ile tekrarladığında çalışır. İstemcinizin bu çağrılar için sizden onay istemesini sağlayın. Araç sonuçlarındaki gizli değerler MCP istemcisine de [redacted] olarak gider.

#İstemci bağlamak

Bağlantı talimatları hazır yapılandırmayla birlikte panelde gösterilir: kullanıcı panelinde Gelişmiş → MCP Bağlantısı, bayiler için Sistem → MCP bağlantısı, sunucu yöneticisi için Yapay zekâ ve MCP → MCP sekmesi. Sayfa uç noktanın tam adresini ve iki biçim verir:

  • Claude Desktop ve Claude Code: mcpServers JSON biçimi; HTTP için type: "http", url ve Authorization başlığı.
  • OpenAI Codex: ~/.codex/config.toml içindeki [mcp_servers.<ad>] bölümü. Token dosyaya yazılmaz, bearer_token_env_var ile bir ortam değişkeninden okunur; aynı ayar codex mcp add komutuyla da eklenebilir.

Sunucu yöneticisi stdio'yu sunucunun kendisinde bipanel mcp komutuyla veya başka bir bilgisayardan SSH üzerinden kullanabilir:

ssh root@sunucu bipanel mcp

Başka bir hesabın yetkisiyle çalıştırmak için komuta --token <API_TOKEN> ekleyin. Panel CLI tokenını reddederse sudo bipanel admin reset-token ile yenileyin. Docker veya Railway kapsayıcısında bipanel komutu kapsayıcının içindedir; dışarıdan bağlanmak için HTTP uç noktası en doğrudan yoldur (Docker ve Railway).

#İlgili sayfalar

Bu sayfada eksik ya da hatalı bir bilgi mi var? Bize yazın.