1Panel MCP Sunucu Entegrasyonu

“1Panel” MCP Sunucu ne yapar?

1Panel MCP Sunucu, 1Panel ile entegrasyon için özel olarak tasarlanmış Model Context Protocol (MCP) sunucusunun bir uygulamasıdır. Bu sunucu, AI asistanları ile 1Panel platformu arasında bir köprü görevi görerek AI ajanlarının 1Panel API’leri ve veri kaynaklarıyla programatik etkileşime geçmesini sağlar. Bu sunucuyu devreye alarak geliştiriciler, AI destekli araçlarla 1Panel ortamlarında sık karşılaşılan idari ve operasyonel görevleri (ör. sistem durumu sorgulama, dosya yönetimi, kontrol komutları yürütme) otomatikleştirip hızlandırabilirler. Sunucu, birden fazla taşıma yöntemi (stdio ve sse) destekleyerek farklı ortamlarda entegrasyon için esneklik sunar ve API token’ları ile host adresleriyle güvenli şekilde yapılandırılabilir.

Prompt Listesi

Mevcut doküman veya kodda prompt şablonlarına dair bir bilgi bulunmamaktadır.

Kaynak Listesi

Mevcut doküman veya kodda açıkça tanımlanmış MCP kaynağı bulunmamaktadır.

Araç Listesi

Mevcut doküman veya kodda (ör. bu Go tabanlı projede server.py yoktur) herhangi bir araç listelenmemiştir.

Bu MCP Sunucunun Kullanım Senaryoları

• 1Panel Otomasyonu: AI asistanları ile standart AI komutları üzerinden servis yeniden başlatma, kullanıcı yönetimi veya durum kontrolü gibi 1Panel idari görevlerini otomatikleştirin.
• Uzaktan Operasyonlar: AI destekli script veya iş akışlarının 1Panel sunucularıyla uzaktan etkileşime geçmesini sağlayarak DevOps ve sistem yönetimi yeteneklerini artırın.
• SSE/Akışlı AI Entegrasyonu: SSE taşıma modu ile 1Panel ve AI ajanları arasında gerçek zamanlı etkileşim, canlı izleme ve hızlı yanıtlar sağlayın.
• Güvenli Programatik Erişim: Erişim token’ları ve ortam tabanlı yapılandırma ile AI ajanlarına sadece gerekli alanları açarak operasyonel güvenliği koruyun.

Kurulumu Nasıl Yapılır

Windsurf

1. 1Panel MCP Sunucu binary’sini veya Docker imajını edinin.

2. 1Panel erişim token’ınızı ve host URL’nizi alın.

3. Windsurf yapılandırma dosyasını düzenleyin.

4. Aşağıdaki JSON parçasını mcpServers altına ekleyin:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<1Panel erişim token'ınız>",
           "PANEL_HOST": "örneğin http://localhost:8080"
         }
       }
     }
   }
   

5. Kaydedin ve Windsurf’u yeniden başlatın, ardından sunucu bağlantısını doğrulayın.

Docker Örneği

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "örneğin http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<1Panel erişim token'ınız>"
      }
    }
  }
}

Claude

1. 1Panel MCP Sunucusunu indirin veya derleyin.
2. 1Panel API token’ınızı ve host bilgisini edinin.
3. Claude’un konfigürasyon dosyasını açın.
4. Windsurf için belirtilenle aynı yapılandırmayı mcpServers altına ekleyin.
5. Kaydedip Claude’u yeniden başlatın.

Cursor

1. 1Panel MCP Sunucusunun kurulu olduğundan emin olun.

2. Erişim token’ınızı ve host URL’nizi alın.

3. Cursor yapılandırma dosyasını düzenleyin.

4. Şunu ekleyin:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<1Panel erişim token'ınız>",
           "PANEL_HOST": "örneğin http://localhost:8080"
         }
       }
     }
   }
   

5. Değişiklikleri kaydedin ve Cursor’u yeniden başlatın.

SSE Modu Örneği

Eğer SSE modunu kullanacaksanız, sunucuyu şu şekilde başlatın:

mcp-1panel -host http://localhost:8080 -token <1Panel erişim token'ınız> -transport sse -addr http://localhost:8000

mcpServers bölümüne şunu ekleyin:

{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Cline

1. 1Panel MCP Sunucusunu kurun.
2. PANEL_ACCESS_TOKEN ve PANEL_HOST değerlerinizi ayarlayın.
3. Cline yapılandırma dosyasını düzenleyip yukarıdakiyle aynı JSON’u ekleyin.
4. Kaydedin ve Cline’ı yeniden başlatın.

API Anahtarlarını Güvenli Saklama

API anahtarları ve hassas bilgileri ortam değişkenlerinde saklayın. Örnek yapılandırma:

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "${PANEL_ACCESS_TOKEN}",
        "PANEL_HOST": "${PANEL_HOST}"
      }
    }
  }
}

${PANEL_ACCESS_TOKEN} ve ${PANEL_HOST} ifadelerini kendi ortam değişkenlerinizle değiştirin.

Bu MCP Nasıl Flow’larda Kullanılır

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için önce akışınıza MCP bileşenini ekleyin ve AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırma bölümünde, MCP sunucu bilgilerinizi şu JSON formatıyla girin:

{
  "MCP-ismi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma tamamlandığında AI ajanı bu MCP’yi bir araç olarak tüm fonksiyon ve yeteneklerine erişerek kullanabilir. “MCP-ismi” yerine “mcp-1panel” yazmayı ve URL’yi kendi MCP sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Bizim görüşümüz

1Panel MCP Sunucu, net kurulum ve entegrasyon talimatları ile birlikte, aktif olarak geliştiriliyor ve yıldız/fork sayısı iyi durumda. Ancak, dokümantasyonundaki detaylı araç, prompt ve kaynak açıklamalarının eksikliği, karmaşık AI iş akışları için kutudan çıktığı gibi kullanılabilirliğini sınırlandırıyor. Yukarıdakilere dayanarak bu MCP uygulamasına 5/10 puan veriyoruz.

MCP Skoru