MCP Sunucusu

SocialGO MCP sunucusu nedir?

SocialGO MCP sunucusu, paneli Model Context Protocol üzerinden yapay zeka ajanları için bir araç seti olarak açar. Bağlandıktan sonra bir asistan; hizmet kataloğuna göz atabilir, sipariş verip takip edebilir, telafi isteyebilir ve bakiyeyi yönetebilir, hiçbir özel yapıştırıcı kod olmadan. Panelinizin kullandığı API'nin üzerinde ince bir oku-ve-uygula katmanıdır, böylece ajanlar hesabınızın limitleri ve fiyatlandırması içinde kalır.

Claude Desktop, Claude Code, Cursor ve bir MCP SDK'si üzerine kurulu kendi ajanlarınız dâhil, MCP yeteneğine sahip herhangi bir istemciyle çalışır.

İstemcinize ekleyin

Sunucu @socialgo/mcp paketi olarak gelir ve npx üzerinden stdio ile çalışır, böylece kurulacak ya da kendi barındıracağınız bir şey yoktur. Aşağıdaki girdiyi MCP istemci yapılandırmanıza ekleyin:

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code ile onu terminalinizden tek bir komutla kaydedebilirsiniz:

claude mcp add socialgo -- npx @socialgo/mcp

Ekledikten sonra, yukarıdaki komutun onu alabilmesi için ortamda SOCIALGO_API_KEY değerini ayarlamayı unutmayın.

Kimlik doğrulama

Sunucu tek bir ortam değişkeni okur: SOCIALGO_API_KEY. Hesap ayarlarınızdan bir anahtar üretin, gizli tutun ve asla kaynak koduna commit etmeyin. Her araç çağrısı bu anahtarla kimlik doğrulanır ve yetkilendirilir; siparişler eşleşen hesap bakiyesinden faturalandırılır. Erişimi iptal etmek için anahtarı istediğiniz zaman panelinizden döndürün.

Temel araçlar

Sunucu, tüm sipariş yaşam döngüsünü kapsayan küçük ve kararlı bir araç yüzeyi tutar:

• search_services — Hizmetleri platforma, türe ya da anahtar kelimeye göre bulun. Her iş akışının giriş noktasıdır.
• get_service — Bir hizmetin tüm ayrıntılarını getirin: birim fiyat, min/maks miktar ve desteklenen seçenekler.
• create_order — Bir hizmet için hedef bir bağlantıya ya da kullanıcı adına sipariş verin.
• order_status — Bir siparişin canlı durumunu, ilerlemesini ve kalan miktarını kontrol edin.
• balance — Güncel hesap bakiyesini ve para birimini okuyun.
• refill — Teslim edilen miktarın altına düşen uygun bir siparişte telafi isteyin.
• cancel — Hâlâ iptal edilebilir bir siparişi iptal edin ve kalan fonları geri alın.
• list_orders — Son siparişleri güncel durumlarıyla sayfa sayfa gezin.
• add_funds — Hesaba bakiye eklemek için bir yükleme talebi oluşturun.

"Önce-ara-sonra-uygula" tasarımı

Tipik bir SMM paneli, onlarca platformda binlerce hizmet taşır. Hizmet başına bir araç kaydetmek, ajanın araç listesini boğar, bağlam penceresini şişirir ve modeli daha yavaş, daha az isabetli hâle getirir. SocialGO bunu tamamen önler.

Bunun yerine katalog, tek bir keşif aracının arkasında yaşar. Ajan önce binlerce seçeneği bir avuç ilgili eşleşmeye indirmek için search_services çağırır, birini get_service ile inceler ve ancak o zaman create_order ile harekete geçer. Aynı dokuz araç, katalog ne kadar büyürse büyüsün tümünü kapsar; böylece arka uçta yeni hizmetler eklemek, ajanın gördüğü araç yüzeyini asla değiştirmez.

Eksiksiz bir akış şöyle görünür:

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

Bu, araç listesini küçük ve öngörülebilir tutar, kataloğun binlerce hizmete ölçeklenmesini sağlar ve ajana her seferinde güvenilir bir harcamadan-önce-onayla adımı verir.