Bu makale, Claude Code, Cursor, Windsurf ve MCP destekleyen diğer istemcileri Teamso'ya bağlamayı anlatır. Bu işi asistanı kullanacak kişi kendi bilgisayarında yapar.

Bu istemciler bilgisayarınıza bir şey kurmadan Teamso'nun hosted MCP sunucusuna bağlanır: adres https://mcp.teamso.com/v1, kimlik doğrulama Authorization: Bearer <token> başlığıdır. Sunucu token'ınızı saklamaz; her isteği sizin adınıza Teamso'ya iletir.

Başlamadan önce

Bir MCP erişim token'ınız olmalı (Erişim token'ı oluşturma).
Kullanacağınız istemci kurulu olmalı. Yalnız OAuth ile bağlanabilen istemciler desteklenmez.

Adım adım

Teamso'da MCP erişimi ekranında yeni token oluşturun. Asistanınızı bağlayın kartında istemcinizi seçin: Claude Code, Cursor, Windsurf ya da Diğer. Kartta Sunucu adresi ve Başlık ile birlikte seçtiğiniz istemcinin numaralı adımları görünür. Komutu ya da ayarı bloğun sağ üstündeki Kopyala ile kopyalayın; yeni oluşturduğunuz token içine yerleştirilmiştir (Token eklendi). Token'ı daha önce oluşturduysanız ayar yer tutucuyla gösterilir: işaretli tms_pat_... yerine kendi token'ınızı yazın.
İstemcinize göre devam edin.

Claude Code

Terminalde Claude Code için kopyaladığınız komutu çalıştırın:

claude mcp add --transport http teamso https://mcp.teamso.com/v1 --header "Authorization: Bearer tms_pat_..."

Bağlantıyı kontrol etmek için claude mcp get teamso çalıştırın ya da Claude Code içinde /mcp yazın. teamso sunucusunun durumu connected olmalıdır.

Cursor

Cursor'da Cmd+Shift+P (Windows'ta Ctrl+Shift+P) ile komut paletini açıp Open MCP settings komutunu çalıştırın.

Sunucuyu ~/.cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "teamso": {
      "url": "https://mcp.teamso.com/v1",
      "headers": {
        "Authorization": "Bearer tms_pat_..."
      }
    }
  }
}

Cursor'u yeniden başlatın; Teamso araçları MCP listesinde görünür.

Windsurf

Windsurf'te Settings > MCP bölümünü açın (dosya: ~/.codeium/windsurf/mcp_config.json).

Sunucuyu ekleyin. Windsurf adresi url yerine serverUrl alanında bekler:

{
  "mcpServers": {
    "teamso": {
      "serverUrl": "https://mcp.teamso.com/v1",
      "headers": {
        "Authorization": "Bearer tms_pat_..."
      }
    }
  }
}

Windsurf'ü yeniden başlatın.

Diğer istemciler

Streamable HTTP destekleyen her istemci https://mcp.teamso.com/v1 adresine Authorization: Bearer tms_pat_... başlığıyla bağlanır.
Yalnız stdio destekleyen istemciler hosted sunucuya mcp-remote ile ulaşır. Hazır ayar MCP erişimi ekranında, Asistanınızı bağlayın kartında Diğer seçilince görünür:

Teamso MCP Sunucusu kurulum kılavuzunda tüm istemcilerin ayarları bir arada görülebilir:

Sonuç

İstemci, Teamso araçlarını sizin yetkilerinizle kullanır. "Teamso'da kaç gün iznim kaldı?" diye sorarak deneyin. İstekler hosted sunucu üzerinden gider; sunucu gerçek IP adresinizi imzalayarak Teamso'ya iletir, böylece şirketinizin IP kısıtlaması size uygulanır. Hosted sunucu token başına dakikalık istek sınırı uygular.

Sık karşılaşılan sorunlar

Belirti: İstemci "401 Unauthorized" diyor.
Neden: Başlık yanlış yazılmış ya da token geçersiz, süresi dolmuş veya iptal edilmiş.
Çözüm: Başlığın tam olarak Authorization: Bearer tms_pat_... biçiminde olduğunu kontrol edin (Bearer ile token arasında bir boşluk). Gerekirse yeni token oluşturun.

Belirti: Windsurf bağlanamıyor.
Neden: Adres url alanına yazılmış.
Çözüm: Windsurf'te adresi serverUrl alanına yazın.

Belirti: Araçlar listede görünmüyor.
Neden: İstemci ayar değişikliğini yeniden başlatılmadan okumadı.
Çözüm: İstemciyi tamamen kapatıp açın; Claude Code'da claude mcp get teamso ile kaydı kontrol edin.

Diğer hatalar için: Sorun giderme.

Claude Code, Cursor, Windsurf ve diğer istemcileri Teamso'ya bağlama