Strava MCP Server

AI'nizi kullanarak Strava verilerinizle konuşun.

Claude'u Strava hesabınıza bağlayın ve düz İngilizcede sorular sorun: "Bu ay ne kadar koştum?", "Son bisiklet turumu analiz et" veya "En hızlı segmentlerimi göster."

Bununla Ne Yapabilirsiniz?

Bağlandıktan sonra, Claude'a tüm Strava verilerinize erişimi olan bir arkadaş gibi konuşun:

🏃 İlerlemenizi Takip Edin

"Bu ay kaç kilometre koştum?"

"Ocak ile Aralık arasında koşu istatistiklerimi karşılaştır"

"Şimdiye kadar en uzun bisiklet turumun ne?"

📊 Antrenmanlarınızı Analiz Edin

"Son bisiklet antrenmanımı parçala - güç, kalp atış hızı ve kadansı göster"

"Dün koşuşum sırasında kalp atış hızı bölgelerim nasıl görünüyordu?"

"Interval antrenmanımda her tur için ortalama tempom ne?"

🗺️ Rotaları ve Segmentleri Keşfedin

"Central Park'ın yakınında en popüler bisiklet segmentleri neler?"

"Yıldızlı segmentlerimi göster"

"Pazar sabahı rotamı GPX dosyası olarak dışa aktar"

🏆 Antrenörlük İçgörüleri Alın

"Bu haftaki antrenman yükümü analiz et"

"Mevcut fitness'im geçen ay ile nasıl kıyaslanıyor?"

"Bu yıl bisiklet performansımın bir özetini ver"

Hızlı Başlangıç (3 Adım)

Adım 1: Claude Desktop'a Ekleyin

Claude Desktop konfigürasyon dosyanızı açın:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Dosyaya bunu ekleyin:

{
  "mcpServers": {
    "strava": {
      "command": "npx",
      "args": ["-y", "@r-huijts/strava-mcp-server"]
    }
  }
}

Adım 1 (alternatif): Claude Code'a Ekleyin

Bu MCP server'ı claude code'a aşağıdaki komutla ekleyebilirsiniz:

claude mcp add --transport stdio strava -- npx @r-huijts/strava-mcp-server

Başarılı kurulumu aşağıdaki gibi doğrulayabilirsiniz:

% claude mcp list
Checking MCP server health...

strava: npx @r-huijts/strava-mcp-server - ✓ Connected

Adım 2: Claude Desktop'ı Yeniden Başlatın

Yeni konfigürasyonu yüklemek için Claude Desktop'ı kapatıp yeniden açın.

Adım 3: Strava Hesabınızı Bağlayın

Claude'a basitçe şunu söyleyin:

"Connect my Strava account" (Strava hesabımı bağla)

Bir tarayıcı penceresi açılacak. Strava API kimlik bilgilerinizi girin, uygulamayı yetkilendirin ve bitti!

Hepsi bu! Aktiviteleriniz hakkında soru sormaya başlayın.

Strava Hesabınızı Bağlama

İlk Kez Kurulum

"Connect my Strava account" dediğinizde işte ne olur:

1. Bir tarayıcı penceresi açılır - kurulum sayfasını gösterir
2. Strava API kimlik bilgilerinizi girin (Client ID ve Client Secret)
3. "Continue to Strava"'ya tıklayın - Strava'ya yönlendirileceksiniz
4. Uygulamayı Strava'da yetkilendirin
5. Başarı mesajını görün - tarayıcıyı kapatabilirsiniz
6. Bitti! Claude bağlı olduğunuzu doğrular

Kimlik bilgileriniz ~/.config/strava-mcp/config.json dosyasına yerel olarak kaydedilir ve oturumlar arasında kalıcı olur.

Strava API Kimlik Bilgilerinizi Almak

Ücretsiz bir Strava API uygulaması oluşturmanız gerekir (tek seferlik kurulum):

1. strava.com/settings/api adresine gidin
2. "Create an App"a tıklayın (veya mevcut uygulamanızı görüntüleyin)
3. Formu doldurun:
   • Application Name: İstediğiniz herhangi bir ad (örneğin, "My Claude Assistant")
   • Category: Herhangi birini seçin
   • Website: Herhangi bir şey olabilir (örneğin, http://localhost)
   • Authorization Callback Domain: localhost olmalı
4. Client ID ve Client Secret'ı kopyalayın

Hepsi bu! Bunu sadece bir kez yapmanız gerekir.

Bağlantınızı Yönetme

• Durumu kontrol edin: "Am I connected to Strava?" (Strava'ya bağlı mıyım?)
• Yeniden bağlayın: "Connect my Strava account" (kullanmak için force: true)
• Bağlantıyı kesin: "Disconnect my Strava account" (Strava hesabımı çıkar)

Kurulum Seçenekleri

Seçenek A: Sadece Kullanın (Önerilen)

Kurulum gerekli değil! Hızlı Başlangıç'taki npx komutu en son sürümü otomatik olarak indirir ve çalıştırır.

Seçenek B: Küresel Olarak Yükleyin

Eğer bir kez yüklememeyi tercih ederseniz:

npm install -g @r-huijts/strava-mcp-server

Ardından Claude config'inizi güncelleyin:

{
  "mcpServers": {
    "strava": {
      "command": "strava-mcp-server"
    }
  }
}

Not: Paket adı @r-huijts/strava-mcp-server olsa da, geriye dönük uyumluluk için çalıştırılabilir adı strava-mcp-server kalır.

Seçenek C: Kaynaktan Derleyin

Kodu değiştirmek isteyen geliştiriciler için:

git clone https://github.com/r-huijts/strava-mcp.git
cd strava-mcp
npm install
npm run build

Ardından Claude'u yerel derlemesine işaret edin:

{
  "mcpServers": {
    "strava": {
      "command": "node",
      "args": ["/path/to/strava-mcp/dist/server.js"]
    }
  }
}

Örnek Konuşmalar

Sabah Check-in

Siz: Bu haftada egzersiz için ne yaptım?

Claude: Strava'daki bu haftanın aktivitelerine baktığımızda şunları tamamladınız:

• Pazartesi: 5,2km koşu (28:15)
• Çarşamba: 45km bisiklet turu (1:32:00)
• Cumartesi: 10km koşu (52:30)

Toplam: 3 aktivite içinde 60,2km. Harika tutarlılık!

Antrenman Analizi

Siz: Son bisiklet antrenmanımı detaylı olarak analiz et

Claude: İşte dün "Evening Loop" turununuzun analizi:

Genel Bakış

• Mesafe: 42,3 km
• Zaman: 1:28:45
• Ort. Hız: 28,6 km/s

Güç Analizi

• Ortalama Güç: 185W
• Normalleştirilmiş Güç: 198W
• Maksimum Güç: 520W

Kalp Atış Hızı

• Ortalama: 142 bpm
• Maksimum: 175 bpm
• Bölge 4+ saati: 23 dakika

Güç-kalp atış hızı oranınız iyi aerobik verimliliği gösteriyor...

Yeni Rotalar Bulma

Siz: Boulder, Colorado'nun yakınında zorlu bisiklet tırmanışları bul

Claude: Boulder'ın yakınında popüler tırmanış segmentleri:

1. Flagstaff Road - 5,2km, %6,8 ort. gradient
2. Sunshine Canyon - 3,8km, %7,2 ort. gradient
3. Left Hand Canyon - 8,1km, %4,5 ort. gradient

Bunlardan herhangi birini yıldızlamak istiyorum musunuz böylece daha sonra kolayca bulabilirsiniz?

Mevcut Araçlar

Hesap ve Profil

Aktiviteler

İstatistikler ve İlerleme

Segmentler

Rotalar

Kulüpler

Sorun Giderme

"Connect my Strava account" tarayıcı açmıyor

• Claude Desktop'ın MCP server'ı çalıştırdığından emin olun (Claude'da hataları kontrol edin)
• Claude Desktop'ı yeniden başlatmayı deneyin
• Port 8111'in bir firewall tarafından engellenmediğini kontrol edin

"Authentication failed" veya "Invalid token"

• Token'ınız süresi bitmiş olabilir - "Connect my Strava account" deyin yeniden bağlanmak için
• Strava API uygulamanızın strava.com/settings/api adresinde hala etkin olduğundan emin olun

"Missing credentials" hatası

• OAuth akışını tamamlamanız gerekir - "Connect my Strava account" deyin
• Ortam değişkenlerini kullanıyorsanız, 4'ünün tümünün ayarlandığından emin olun (Geliştirici bölümüne bakın)

Claude Strava araçlarını görmüyor

• claude_desktop_config.json'inizin geçerli JSON olduğundan emin olun (trailing commas yok!)
• Config değişiklikleri yaptıktan sonra Claude Desktop'ı yeniden başlatın
• Hata mesajleri için Claude'un geliştirici konsolunu kontrol edin

Paket adı değişikliğinden sonra JSONRPC.ProtocolTransportError

@r-huijts/strava-mcp-server'a güncelledikten sonra JSONRPC hatası alıyorsanız:

1. npx cache'i temizleyin: Terminal'de rm -rf ~/.npm/_npx çalıştırın
2. Config'i doğrulayın - @r-huijts/strava-mcp-server kullanıyor (eski strava-mcp-server değil)
3. Claude Desktop'ı tamamen yeniden başlatın (kapat ve yeniden aç)
4. Manuel test edin: npx -y @r-huijts/strava-mcp-server çalıştırın - "Starting Strava MCP Server v1.2.1..." görmelisiniz

Geliştiriciler İçin

npm install
npm run build
npm test

Lisans

MIT License - ayrıntılar için LICENSE dosyasına bakın.

Sorular? GitHub üzerinde bir issue açın.