Ringhum'u Claude ve diğer yapay zeka araçlarına bağlayın (MCP)

Ringhum'un bir MCP sunucusu vardır. MCP (Model Context Protocol), yapay zeka uygulamalarının dış araçları kullanması için standart bir yoldur. Ringhum'u Claude veya ChatGPT gibi bir yapay zeka uygulamasına bağladığınızda, çalışma alanınız hakkında sade bir dille sorular sorabilirsiniz. Örneğin: "Dünkü kaçırılan aramaları özetle", "Bu hafta hangi arayanlar geri arama istedi?" veya "Yeni çalışma saatlerimizi SSS'lere ekle". Yapay zeka uygulaması, Ringhum API'siyle aynı kurallar ve izinler üzerinden çalışır.

Neye ihtiyacınız var

• Sunucu URL'si: https://ringhum.com/mcp. Bu, Geliştiriciler sayfasındaki MCP sunucusu kartında bir Kopyala düğmesiyle de gösterilir.
• Uzak MCP sunucularını destekleyen bir yapay zeka uygulaması, örneğin Claude, ChatGPT, Claude Code, Cursor, Windsurf veya VS Code.
• Çalışma alanında Sahip veya Admin rolü. Yalnızca sahipler ve adminler bir uygulama bağlayabilir veya bir API anahtarı oluşturabilir.

Bağlanmanın iki yolu vardır. Giriş yapmak en kolayıdır ve Claude ve ChatGPT gibi sohbet uygulamalarına uygundur. Bir API anahtarı, bir URL ve bir başlık alan geliştirici araçlarına uygundur.

Salt okunur veya okuma ve değiştirme erişimi

Yapay zeka uygulamasının ne kadarını yapabileceğine siz karar verirsiniz.

Salt okunur erişimle, bir şeyi değiştiren araçlar uygulamaya hiç sunulmaz.

Önemli: Değiştirme erişimiyle, yapay zeka uygulaması müşterilerinize gerçek mesajlar gönderebilir ve gerçek aramalar yapabilir. Ringhum, bu araçları çalışma alanınızın dışına ulaşan olarak işaretler ve silmeleri yıkıcı olarak işaretler, bu yüzden çoğu yapay zeka uygulaması bunları çalıştırmadan önce sizden onay ister. Onaylamadan önce uygulamanın ne yapmak üzere olduğunu okuyun.

Claude'u giriş yaparak bağlama

1. Claude'da (web, masaüstü veya mobil), Ayarlar → Konektörler'i açın ve Özel konektör ekle'yi seçin.
2. URL olarak https://ringhum.com/mcp'yi yapıştırın ve kaydedin.
3. Bağla'ya tıklayın. Bir Ringhum sayfası açılır. İstenirse giriş yapın.
4. Bağla sayfasında, uygulamanın kullanabileceği Çalışma alanını seçin.
5. Ne yapabilir altında, Bilgiye bak veya Bilgiye bak ve değişiklik yap'ı seçin.
6. İzin ver'e tıklayın. Claude'a geri gönderilirsiniz.

Uygulama şifrenizi asla görmez. Claude'daki tam menü adları zamanla değişebilir; ayarlarında konektörleri veya entegrasyonları arayın.

ChatGPT: URL'yi Ayarlar → Uygulamalar ve Konektörler'de özel bir konektör (MCP sunucusu) olarak ekleyin, ardından Bağla'ya tıklayın ve 3'ten 6'ya kadar olan adımları izleyin.

Claude Code: aşağıdaki komutu çalıştırın, ardından /mcp komutunu çalıştırın ve Authenticate'i seçin.

claude mcp add --transport http ringhum https://ringhum.com/mcp

Erişime izin verdikten sonra, kullanmaya devam ettiğiniz sürece bağlantı kendini yeniler. Uygulama 90 gün kullanılmazsa, tekrar bağlamanız gerekir.

Bir API anahtarıyla bağlanma

Bunu, bir istek başlığı ayarlamanıza izin veren araçlar için veya giriş yapmak istemediğinizde kullanın.

1. Geliştiriciler'de bir API anahtarı oluşturun. Salt okunur bir bağlantı için yalnızca read'i, değişikliklere izin vermek için read ve write'ı işaretleyin. Bkz. API anahtarları ve kapsamlar.
2. Sunucuyu, anahtarı Authorization başlığında kullanarak uygulamanıza ekleyin.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf ve Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Yalnızca yerel sunucuları çalıştırabilen bir uygulama, npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…" üzerinden bağlanabilir.

Araçlar neleri kapsar

Ringhum API'sindeki her işlem bir araç olarak kullanılabilir: hesabınız ve kullanımınız, asistanlar, telefon numaraları, aramalar ve dökümler, kişiler, randevular ve müsaitlik, siparişler ve ürünler, oda rezervasyonları, gelen kutusu, metin ve WhatsApp mesajları, kampanyalar, webhook'lar, şirket profili, hizmetler, SSS'ler ve bilgi bankası, yanıtlanamayan sorular, ödeme bağlantıları, değerlendirme istekleri, gelir ve spam koruması. Arama kayıtları tek istisnadır: bir araç olarak kullanılamazlar.

Her araç, eşleşen API isteğini çalıştırır, bu yüzden aynı plan sınırları, doğrulama ve hız sınırları geçerlidir. Araç çağrıları, API'nin dakikada 120 istek sınırına sayılır. Araçların tam listesi /docs adresindeki API referansının MCP bölümündedir.

Bağlı uygulamaları görme ve bağlantısını kesme

Giriş yaparak bağladığınız uygulamalar, Geliştiriciler'de Bağlı yapay zeka uygulamaları altında, onları kimin bağladığı, Erişimleri (Yalnızca okuma veya Okuma ve değiştirme) ve en son ne zaman kullanıldıklarıyla birlikte listelenir.

Bir uygulamayı kaldırmak için Bağlantıyı kes'e tıklayın ve onaylayın. Erişimini hemen kaybeder ve tekrar onaylanması gerekir. Bir uygulamanın erişimini değiştirmek için, bağlantısını kesin ve diğer seçimle tekrar bağlayın.

Bir API anahtarıyla yapılan bir bağlantı için, anahtarı API anahtarları altında iptal edin.

Sorun giderme

"Bir çalışma alanının yalnızca sahipleri ve adminleri uygulama bağlayabilir." Çalışma alanı sahibinden uygulamayı bağlamasını veya sizi Admin yapmasını isteyin. Bkz. Ekibinizi davet edin.

"Giriş isteğinin süresi doldu. Yapay zeka uygulamanızdan tekrar bağlanmaya başlayın." Onay sayfası çok uzun süre açık kaldı. Yapay zeka uygulamasından tekrar başlayın.

Uygulama yetkili olmadığını söylüyor veya tekrar giriş yapmanızı istiyor. Uygulamanın bağlantısı kesildi, anahtar iptal edildi veya artık çalışma alanının üyesi değilsiniz. Tekrar bağlayın.

Uygulama değişiklik yapamıyor. Salt okunur erişimle bağlandı, veya API anahtarında write kapsamı yok.

Uygulama yanlış çalışma alanına bakıyor. Kontrol etmesi için ona who_am_i'yi çağırmasını isteyin. Her bağlantı bir çalışma alanı kullanır. Başka birini seçmek için bağlantısını kesin ve tekrar bağlayın.