Ana içeriğe geç

Claude Desktop'ı Teamso'ya bağlama

Claude Desktop'a Teamso MCP paketini claude_desktop_config.json dosyasıyla nasıl ekleyeceğinizi, uygulamayı nasıl yeniden başlatacağınızı ve bağlantıyı nasıl deneyeceğinizi anlatır.

Bu makale, Claude Desktop uygulamasını Teamso hesabınıza bağlamayı anlatır. Bu işi asistanı kullanacak kişi kendi bilgisayarında yapar.

Claude Desktop, uzak sunuculara özel bağlayıcı (Custom Connectors) olarak bağlanırken OAuth ister; Teamso ise kişisel erişim token'ı kullanır. Bu yüzden Claude Desktop'ta Teamso, bilgisayarınızda çalışan açık kaynak Teamso MCP paketi (@teamso/teamso-mcp) ile bağlanır. Paket npx ile otomatik indirilir ve doğrudan Teamso'ya bağlanır; ayrıca bir şey kurmanız gerekmez.

Başlamadan önce

  • Bir MCP erişim token'ınız olmalı (Erişim token'ı oluşturma).

  • Bilgisayarınızda Node.js 20 ya da üstü kurulu olmalı (npx komutu Node.js ile gelir). Terminalde node -v yazarak sürümü görebilirsiniz.

  • Claude Desktop'ın güncel sürümü kurulu olmalı.

  • Şirketinizde IP kısıtlaması varsa bilgisayarınızın IP adresine izin verilmiş olmalı (Güvenlik ve erişim ayarları).

Adım adım

  1. Teamso'da MCP erişimi ekranında yeni token oluşturun. Asistanınızı bağlayın kartında Claude Desktop seçilidir (Önerilen). Ayar bloğunun sağ üstündeki Kopyala ile ayarı kopyalayın. Ayarda token'ınız (Token eklendi) ve sabitlenmiş paket sürümü hazırdır; kartta paket adı ve Node.js 20+ gereksinimi de yazar.

    Asistanınızı bağlayın kartında Claude Desktop ayarı

    Token'ı daha önce oluşturduysanız aynı ayarı yer tutucuyla kopyalayın ve işaretli tms_pat_... yerine kendi token'ınızı yazın. Token'ınızı kaybettiyseniz bloğun altındaki nottaki yeni token oluşturun bağlantısıyla yenisini oluşturun; ayar kendiliğinden dolar.

  2. Claude Desktop'ta Settings > Developer bölümünü açın ve Edit Config ile claude_desktop_config.json dosyasını açın. Dosya şuradadır:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  3. Kopyaladığınız ayarı dosyaya yapıştırın. Dosyada başka sunucular varsa yalnız "teamso": { ... } bölümünü mevcut "mcpServers" içine ekleyin. Ayar şu biçimdedir:

    {
  "mcpServers": {
    "teamso": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@teamso/[email protected]"],
      "env": {
        "TEAMSO_ACCESS_TOKEN": "tms_pat_..."
      }
    }
  }
}

  4. Dosyayı kaydedin.

  5. Claude Desktop'ı tamamen kapatıp yeniden açın. Pencereyi kapatmak yetmez: macOS'ta menüden Quit (ya da Cmd+Q), Windows'ta sistem tepsisindeki Claude simgesinden Quit kullanın.

  6. Yeni bir sohbette araçlar menüsünde teamso sunucusunun ve araçlarının göründüğünü kontrol edin.

  7. "Teamso'da kaç gün iznim kaldı?" diye sorarak bağlantıyı deneyin. Claude ilk araç çağrısında izin isteyebilir; izin verin.

Sonuç

Claude Desktop, Teamso araçlarını sizin yetkilerinizle kullanır. Paket bilgisayarınızdan doğrudan Teamso'ya bağlandığı için şirketinizin IP kısıtlaması bilgisayarınızın IP adresine uygulanır. Token'ı iptal ettiğinizde ya da süresi dolduğunda bağlantı hemen kesilir; yeni token'ı aynı dosyada TEAMSO_ACCESS_TOKEN değerine yazıp Claude Desktop'ı yeniden başlatın.

Not: Teamso adresini (https://mcp.teamso.com/v1) Claude Desktop'ın Connectors listesine eklemeyin; bu liste OAuth ister ve token'la çalışmaz.

Yerel paket yalnız İK araçlarını içerir. Distribütör hesabının Landing CMS araçları yalnız sunucu adresinden gelir; ekran bunu Claude Desktop seçiliyken bir notla belirtir. Bu araçları Claude Desktop'ta kullanmak için kartta Diğer (mcp-remote) kurulumunu seçin.

Sık karşılaşılan sorunlar

Belirti: Claude Desktop açılırken yapılandırma hatası veriyor.
​Neden: JSON biçimi bozuk ya da teamso girdisinde type, command, args ve env alanlarından biri eksik.
​Çözüm: Ayarı MCP erişimi ekranından yeniden kopyalayın; virgül ve süslü parantezleri kontrol edin. Ayara timeout alanı eklemeyin, istemci bu alanı yok sayabilir.

Belirti: Teamso araçları listede görünmüyor.
​Neden: Node.js kurulu değil ya da 20'den eski; veya Claude Desktop tamamen kapatılmadı.
​Çözüm: Node.js 20 ya da üstünü kurun, Claude Desktop'ı menüden tamamen kapatıp açın.

Belirti: Araç çağrıları hemen başarısız oluyor.
​Neden: Sürüm sabitlenmediyse npx önbellekteki eski bir paket sürümünü çalıştırıyor olabilir.
​Çözüm: args içinde paket adını sürümle birlikte yazın (ekrandaki hazır ayarda olduğu gibi) ve Claude Desktop'ı yeniden başlatın.

Belirti: "401" ya da "IP_NOT_ALLOWED" hatası.
​Neden: Token geçersiz, süresi dolmuş ya da iptal edilmiş; veya IP adresinize izin verilmemiş.
​Çözüm: Sorun giderme makalesine bakın.

İlgili makaleler

Bu cevap sorunuzu yanıtladı mı?

İlgili Makaleler