MCP sunucusu: bir yapay zekâ asistanı bağlayın

WbizTool'un MCP sunucusu, bir yapay zekâ asistanının çalışma alanınızla çalışmasını sağlar. Ona “bugün hangi mesajlar başarısız oldu ve neden?”, “kira hatırlatıcısını duraklat” veya “yeni çalışma saatlerimizi bu beş müşteriye gönder” gibi şeyler sorabilirsiniz; o da bunları yapmak için WbizTool hesabınızı kullanır.

Sunucu, Claude Code, Cursor, VS Code ve diğer yapay zekâ araçlarının anladığı Model Context Protocol (MCP) ile konuşur. Arka planda her işlem, kendi API v2 anahtarınızla yapılan bir API v2 çağrısıdır; bu yüzden asistanın neyi görüp neyi yapabileceğine anahtar karar verir.

Bir asistan neler yapabilir#

Asistan yalnızca anahtarın izin verdiği araçları görür (bkz. kapsamlar):

Ayrıca üç hazır istem sunar: günlük özet, başarısız mesajlar ve duyuru taslağı.

Yeni bir numara bağlayamaz (bu panelinizde kalır), dosya yükleyemez, webhook'ları yönetemez ve Unibox gelen kutunuzu okuyamaz.

1. Asistan için bir anahtar oluşturun#

1. API v2 anahtarları kartını açın

   WbizTool'da Ayarlar → API anahtarları sayfasına gidin ve API v2 anahtarları kartını bulun.

2. Yapay zekâ asistanı hazır ayarını kullanın

   v2 anahtarı oluştur'a, ardından Yapay zekâ asistanı için'e tıklayın. Bu, mesajları ve numaraları okuyabilen ve 90 günde sona eren Salt okunur bir anahtar oluşturur – başlamak için güvenli bir yol: asistan bakabilir, ancak hiçbir şey gönderemez veya değiştiremez.

3. Göndermeye yalnızca istiyorsanız izin verin

   Asistanın mesaj göndermesi veya hatırlatıcıları yönetmesi gerekiyorsa Salt okunur işaretini kaldırın ve Mesaj gönderme'yi (gerekirse Hatırlatıcılar'ı da) işaretleyin. Anahtarı numaralarınızın bazılarıyla da sınırlayabilirsiniz.

4. Anahtarı kopyalayın

   Anahtar (wbz_live_…) yalnızca bir kez gösterilir. Bilgisayarınızda WBIZTOOL_API_KEY gibi bir ortam değişkeninde saklayın – paylaştığınız veya commit ettiğiniz bir dosyaya asla yapıştırmayın.

export WBIZTOOL_API_KEY=wbz_live_…

2. Sunucuyu yapay zekâ aracınıza ekleyin#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: komutu bir kez çalıştırın (.mcp.json aracılığıyla bir projeyle paylaşmak için --scope project ekleyin; dosyada anahtarın kendisi değil, ${WBIZTOOL_API_KEY} bulunur).
• Cursor: ~/.cursor/mcp.json dosyasına veya bir projedeki .cursor/mcp.json dosyasına koyun.
• VS Code: .vscode/mcp.json dosyasına koyun. VS Code anahtarı bir kez sorar ve gizli depolama alanında saklar.

Ardından asistana “WbizTool hesabım nedir?” gibi bir şey sorun – çalışma alanınızın adı ve planıyla yanıt vermelidir.

3. Gönderim nasıl güvende kalır#

• Her gönderim önce önizlenir. Bir mesaj istediğinizde asistan önce WbizTool'dan bir önizleme alır – hangi numaradan, kime, tam metin, varsa dosya, ne zaman – ve henüz hiçbir şey gönderilmemiştir. Asistana bu önizlemeyi size göstermesi ve onayınızı beklemesi söylenir. Ancak ondan sonra, tam olarak gördüğünüz şeyle gönderir.
• Yeniden deneme asla iki kez göndermez. Asistan onaylanmış bir gönderimi tekrarlarsa (örneğin bir zaman aşımından sonra), WbizTool zaten gönderdiği mesajla yanıt verir.
• Kesin sınırı anahtar belirler. Salt okunur bir anahtar hiç gönderemez. Mesaj gönderme izni olmayan bir anahtar gönderim araçlarını hiç görmez ve bazı numaralarla sınırlı bir anahtar diğerlerini kullanamaz. WbizTool'un kendi sınırları da geçerlidir: anahtar başına dakikada 60 istek ve numara başına günde en fazla 1.000 mesaj.
• Başkalarından gelen metin veri olarak işaretlenir. Dışarıdan gelen mesajlar, adlar ve dosyalar asistana güvenilmez olarak işaretlenmiş şekilde ulaşır ve asistana bunların içindeki talimatlara asla uymaması söylenir.
• Yanıtlarda gizli bilgi yok. QR kodları ve eşleştirme kodları asla gösterilmez ve listeler dosya bağlantılarını içermez.
• İstediğiniz zaman iptal edin. Anahtarı Ayarlar → API anahtarları sayfasında iptal etmek asistanı hemen durdurur.

Gizlilik#

Bir asistan bağladığınızda, WbizTool'dan okuduğu şeyler (anahtarın görmesine izin verdiğiniz mesajlar, adlar ve numaralar) o asistanın sağlayıcısına gönderilir – örneğin Claude için Anthropic'e veya ChatGPT için OpenAI'ye – ve onların koşullarına göre işlenir. WbizTool'un MCP sunucusunun kendisi hiçbir şey saklamaz: her isteği API v2'ye iletir ve hangi aracın kullanıldığını kaydeder; mesaj metnini veya anahtarınızı asla kaydetmez. Anahtara yalnızca asistanın ihtiyaç duyduğu erişimi verin.

Sorun giderme#

İlgili sayfalar#

• API v2'ye genel bakış
• API anahtarları
• Mesajlar API v2
• Tüm uygulamalar ve entegrasyonlar