Elido'yu Claude Desktop ve Cursor'da Kullanın

Elido, https://api.elido.app/mcp adresinde bir Model Context Protocol (MCP) sunucusu sunar. Bağlandıktan sonra Claude veya Cursor, bağlantı analizlerinizi okuyabilir, URL'leri kısaltabilir ve bağlantı ayrıntılarına bakabilir — doğrudan sohbetten veya editörden.

MCP size ne sağlar

• "spring-2026 bu hafta kaç tıklama aldı?" diye sorun — Claude, Elido'yu sorgular ve gerçek sayıyla yanıt verir.
• "https://example.com/very-long-path bağlantısını newsletter etiketiyle kısalt" deyin — Claude bağlantıyı oluşturur ve size kısa URL'yi gösterir.
• Cursor'da bir sürümü açıklayın ve "sürüm blog yazısı için kısa bir bağlantı oluştur" deyin — satır içi olarak kısaltır.

Salt okunur erişim varsayılandır. Yazma erişimi (bağlantı oluşturma, güncelleme) yetkilendirme sırasında dahil olmayı gerektirir.

Adım 1 — Bir Elido API token'ı oluşturun

1. Kontrol Paneli → API Anahtarları → Yeni anahtar bölümüne gidin.
2. Kapsamları seçin:
   • Salt okunur için links:read analytics:read.
   • Claude'un bağlantı oluşturabilmesini istiyorsanız links:write ekleyin.
3. Token'ı kopyalayın (ek_ ile başlar).

Claude Desktop'ta bağlanın

Claude Desktop, MCP sunucu yapılandırmasını ~/.claude.json dosyasında (veya daha yeni sürümlerde Claude ayarlar arayüzünde) saklar.

Seçenek A — Ayarlar arayüzü (Claude Desktop 0.10+):

1. Claude Desktop'ı açın → Ayarlar → Bağlayıcılar → Bağlayıcı ekle → Özel MCP sunucusu.
2. Sunucu URL'sini yapıştırın: https://api.elido.app/mcp
3. Kimlik Doğrulama altında, Bearer token'ı seçin ve Elido API token'ınızı yapıştırın.
4. Bağlan'a tıklayın. Claude, araç manifestosunu getirir (~2 saniye) ve mevcut Elido araçlarını gösterir.

Seçenek B — Doğrudan yapılandırma dosyası düzenleme:

~/.claude.json dosyasını bir metin düzenleyicide açın ve mcpServers altına bir giriş ekleyin:

{
  "mcpServers": {
    "elido": {
      "url": "https://api.elido.app/mcp",
      "headers": {
        "Authorization": "Bearer ek_your_token_here"
      }
    }
  }
}

Dosyayı kaydedin. Claude Desktop'ı yeniden başlatın. Elido bağlayıcısı, bağlayıcılar listesinde görünür.

Cursor'da bağlanın

1. Cursor'ı açın → Ayarlar → MCP (veya Cmd/Ctrl + , → "MCP" arayın).
2. MCP sunucusu ekle'ye tıklayın.
3. Sunucu URL'si: https://api.elido.app/mcp
4. Kimlik doğrulama başlığı: Authorization: Bearer ek_your_token_here
5. Kaydet'e tıklayın. Cursor manifestoyu getirir. Mevcut araçlar MCP panelinde görünür.

Alternatif — Claude Code CLI (terminal kullanıcıları için):

claude mcp add elido https://api.elido.app/mcp \
  --header "Authorization: Bearer $ELIDO_TOKEN"

Bu, sunucuyu komut satırından ~/.claude.json dosyanıza ekler. ELIDO_TOKEN'ı kabuk profilinizde ayarlayın, böylece her oturumda kullanılabilir olur.

Mevcut araçlar

Araç	Gerekli kapsam	Ne yapar
list_links	links:read	İsteğe bağlı filtrelerle (etiket, alan adı, arama) bağlantıları listeler
get_link	links:read	Slug veya ID'ye göre tek bir bağlantı döndürür
get_analytics	analytics:read	Bir bağlantı için tıklama sayısı + dökümü döndürür
create_link	links:write	Yeni bir kısa bağlantı oluşturur
update_link	links:write	Hedefi, slug'ı, etiketleri veya son kullanma tarihini günceller

Araçlar varsayılan olarak salt okunurdur. Bağlantı oluşturma ve güncelleme, API token'ınızda links:write kapsamını gerektirir.

Erişim kapsamı

MCP sunucusu yalnızca API token'ının ait olduğu çalışma alanından verileri gösterir. Diğer çalışma alanlarına erişemez. Birden fazla çalışma alanınız varsa, her biri için ayrı bir token oluşturun ve farklı adlarla (elido-workspace-a, elido-workspace-b) birden fazla MCP sunucu girişi ekleyin.

Sorun giderme

"Failed to fetch tool manifest" — MCP sunucu URL'si yanlış veya erişilemez durumda. https://api.elido.app/mcp adresini bir tarayıcıda açarak doğrulayın — bir JSON manifestosu döndürmelidir. Bir sertifika hatası alırsanız, ağınız api.elido.app'e TLS'yi engelliyor olabilir.

Bir araç çağrılırken "Unauthorized" — API token'ı Authorization başlığında eksik veya yanlış. Başlık biçiminin tam olarak Authorization: Bearer ek_... olduğunu doğrulayın (ekstra boşluk yok, doğru önek).

Araçlar görünüyor ama yazma araçları "forbidden" döndürüyor — API token'ınızda links:write yok. O kapsamla yeni bir token oluşturun ve MCP yapılandırmanızdaki başlığı güncelleyin.

Yapılandırma düzenlemesinden sonra Claude Desktop, bağlayıcılarda Elido'yu göstermiyor — Claude Desktop'ı tamamen yeniden başlatın (Çıkış yapın, sadece pencereyi kapatmayın). macOS'te, menü çubuğunda çalışan bir Claude örneği olup olmadığını kontrol edin.

Cursor MCP paneli "disconnected" gösteriyor — Cursor, manifestoyu her oturumda yeniden getirir. api.elido.app yanıt vermekte yavaşsa, Cursor zaman aşımına uğrayabilir. MCP panelinde Reconnect'e tıklamayı deneyin. Sorun devam ederse, Elido'nun durum sayfasını kontrol edin.