SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

Nedir?

MCP sunucusu https://get-api.simplyboost.io/api/v1/mcp adresinde bulunur. Streamable HTTP aktarımını kullanır ve REST API (Authorization: Bearer sb_live_…) ile aynı API token'ını, aynı planları (Growth, Pro ve Enterprise), aynı izinleri ve aynı limitleri kullanır. Her araç, eşleşen REST uç noktasının yaptığı işi yapar ve aynı kapsamı gerektirir; asistan, kullanmasına izin verilmeyen bir aracı hata olarak değil, açık bir ret olarak görür.

Durumsuzdur: her çağrı tek bir istek ve tek bir yanıttan oluşur, tutulması gereken bir oturum yoktur; bu nedenle herhangi bir makineden bağlanabilirsiniz. Sunucu kendi başına hiçbir zaman akış başlatmaz.

Bir istemci bağlama

İki yol vardır. Oturum açma (OAuth): sunucunun adresini ekleyin ve istemci istediğinde, ekip sahibi olarak bir SimplyBoost sekmesinde onay verip ekibi, izinleri ve sohbet botlarını seçin. claude.ai ve ChatGPT bağlayıcıları, Cursor, Codex ve Claude Code bu şekilde bağlanır; yapıştırmanız gereken hiçbir şey yoktur. Token: elle yapılandırdığınız bir istemci veya kendi betiğiniz için Settings → API bölümünde, asistanın ihtiyaç duyduğu izinlerle sınırlı bir token oluşturun ve bunu başlık olarak gönderin.

Claude Code (istediğinde oturum açın)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code ve mcp.json kullanan diğer istemciler (istendiğinde oturum açın)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

Oturum açmak yerine token kullanarak aynı bağlantıyı kurma

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

Oturum açılarak kurulan bağlantı 90 gün sürer, yalnızca sahibinin işaretli bıraktığı izinlere sahip olur (işaretlenmedikçe silme kapalıdır) ve Settings → API → Connected apps bölümünde listelenir; ekip sahibi bağlantıyı istediği zaman kesebilir. Token oluşturma kuralında olduğu gibi, bağlantıyı yalnızca ekip sahibi onaylayabilir. Onay ekranındaki uygulama adı, uygulamanın kendisi hakkında bildirdiği addır; SimplyBoost bunu doğrulamaz.

İstemci yapılandırmasındaki bir token, hesabınızın parolasıdır. Kendi bilgisayarınızda saklayın, son kullanma tarihi belirleyin ve yapılandırma dosyası paylaşılırsa token'ı yenileyin. Oturum açmak bu sorunu önler: hiçbir gizli bilgi dosyaya yazılmaz.

İstemci geliştiricileri için: sunucu, MCP yetkilendirme belirtimine uyar. Kimlik bilgisi içermeyen bir istek, korunan kaynak meta verilerini (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp) belirten bir WWW-Authenticate başlığıyla 401 yanıtını verir; bu meta veriler de yetkilendirme sunucusunu (https://get-api.simplyboost.io/.well-known/oauth-authorization-server) belirtir. İstemciler kendilerini kaydeder (Dynamic Client Registration), PKCE (yalnızca S256) ile yetkilendirme kodu akışını kullanır, kaynağı belirtebilir ve yenilenen refresh token'lar alır. Erişim token'ları bir saat geçerlidir ve yalnızca MCP uç noktasında çalışır; REST uç noktaları API token'larını kullanır.

Araçlar

Bağımsız değişkenler ve sonuçlar REST API (chatbotId, threadId, camelCase alanları) ile aynı adları kullanır; bu nedenle uç nokta sayfaları her ikisini de açıklar. Bir sohbet botunun kimliğini bulmak için list_chatbots ile başlayın.

Araç	Gereken	Yaptığı
get_account	hiçbir şey	Hesap, plan ve token'ın kendi izinleri.
get_usage	account:read	Bu faturalandırma döneminde kullanılan mesajlar.
list_chatbots, get_chatbot	chatbots:read	Token'ın kullanabileceği sohbet botları.
send_message	conversations:write	Bir ziyaretçinin yapacağı gibi sohbet botuna soru sorun; planın mesaj kotasına dahil edilir. Devam etmek için threadId değerini gönderin.
list_conversations, get_conversation, list_messages	conversations:read	Tüm kanallardaki konuşmalar ve mesajları.
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	Bir konuşmayı kişi olarak yönetin: üstlenin, yanıtlayın, geri devredin, çözüme kavuşturun veya yeniden açın.
list_leads, get_lead	leads:read	Bir sohbet botunun topladığı potansiyel müşteriler.
update_lead	leads:write	Bir potansiyel müşterinin bilgilerini değiştirin veya dönüşüm sağladığını işaretleyin.
delete_lead	leads:delete	Bir potansiyel müşteriyi silin.
list_knowledge_sources, get_knowledge_source	knowledge:read	Bir sohbet botunun bildikleri; her kaynağın durumu ve metniyle birlikte.
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	Sohbet botuna metin veya web sitesi öğretin, bir kaynağı düzenleyin ya da bir web sitesini yeniden okuyun.
delete_knowledge_source	knowledge:delete	Bir kaynağı kaldırın.

Dosya yüklemeleri ve webhook'lar araç olarak sunulmaz; bunlar için REST uç noktalarını kullanın. Silme araçları yıkıcı olarak işaretlenir ve sunucunun talimatları asistana önce size sormasını söyler.

Hatalar ve limitler

Reddedilen bir araç çağrısı (eksik izin, token'ın göremediği bir sohbet botu, geçersiz bağımsız değişken veya plan limiti), REST API'nin vereceği aynı code ve mesajla birlikte hata olarak işaretlenmiş bir araç sonucu döndürür; böylece asistan neyi değiştirmeniz gerektiğini size söyleyebilir. Eksik veya geçersiz bir token 401, API içermeyen bir plan veya süresi dolmuş abonelik 403, token başına hız limiti ise 429 yanıtını verir; REST API'dekiyle tamamen aynıdır.

JSON-RPC 2.0 biçiminde olmayan bir mesaj, JSON-RPC hatası döndürür. Oturum olmadığı ve sunucu akışı bulunmadığı için uç noktadaki GET ve DELETE, 405 yanıtını verir.