Elido'yu herhangi bir yapay zeka ajanına bağlayın.
Elido MCP, bağlantı, QR ve analitik API'lerimizi MCP araçları olarak sunan açık kaynaklı bir sunucudur. 30 saniyede Claude Desktop, Cursor veya kendi ajanınıza ekleyin.
MCP nedir?
Model Context Protocol, yapay zeka ajanlarının araçlar, dosyalar ve API'lerle yapılandırılmış bir şekilde konuşmasını sağlayan Anthropic kaynaklı açık bir standarttır. Tek protokol, birçok istemci.
MCP'den önce, bir yapay zeka ajanını harici bir hizmete bağlamak; özel prompt talimatları yazmak, elle hazırlanmış bir araç şeması sürdürmek ve modelin bunu doğru çağırmasını ummak anlamına geliyordu. MCP bunun yerine standartlaştırılmış bir protokol sunar: sunucu araçlarını JSON Schema ile tanımlar, istemci bunları otomatik olarak keşfeder ve her çağrı tipli ve denetlenebilirdir. Tek bir protokol; Claude Desktop, Cursor, Claude Code, Continue.dev ve MCP destekleyen diğer tüm istemcilerde çalışır.
Elido MCP sunucusu, ortamınızda yerel olarak çalışır. API anahtarınızı saklar, ajandan gelen yapılandırılmış araç çağrılarını api.elido.app'e yapılan REST isteklerine dönüştürür ve yapılandırılmış sonuçlar döndürür. Ajan anahtarınızı asla görmez; api.elido.app modelle asla doğrudan konuşmaz.
Çalışma zamanı akışı
Sohbet mesajınızdan Elido API'sine ve geri dönüşe
Dizi dört adımdan oluşur. Her biri hızlıdır - MCP katmanı 5ms'nin altında ek yük ekler. api.elido.app'e yapılan REST çağrısı AB'den 30-80ms sürer. Bir tarayıcıya alt-tab yapmadan önce sonucu sohbette görürsünüz.
Nasıl çalışır
MCP, ince bir iletişim protokolüdür. Sunucu ortamınızda çalışır, API anahtarınızı saklar ve ajandan gelen yapılandırılmış araç çağrılarını api.elido.app'e yapılan REST isteklerine dönüştürür.
- 1. Ajan araçları ister
Başlangıçta MCP istemcisi (Claude Desktop, Cursor, kendi ajanınız), Elido sunucusundan araç kataloğunu ister. Sunucu, mevcut her aracın JSON-Schema açıklamasını döndürür - adlar, parametreler, dönüş biçimleri.
- 2. Kullanıcı sohbette bir istek yapar
'Bu URL'yi launch-2026 etiketiyle kısalt' dediğinizde, ajan bunu katalogla eşleştirir ve yapılandırılmış argümanlarla create_link'i çağırmaya karar verir. İstemciniz bunu görüntülüyorsa (Claude Desktop görüntüler), araç çağrısını çalıştırılmadan önce görürsünüz.
- 3. Sunucu api.elido.app'e istek gönderir
Yerel MCP sunucusu, isteği ELIDO_API_KEY'inizle imzalar ve ilgili REST uç noktasını çağırır. Gecikmenin büyük kısmı api.elido.app'e gidiş-dönüşten kaynaklanır - AB'den tipik olarak 30-80ms; MCP katmanı bunun üzerine 5ms'den az ekler.
- 4. Sonuç ajana geri döner
Yanıt, ajanın alıntılayabileceği, özetleyebileceği veya bir sonraki çağrıya zincirleyebileceği yapılandırılmış bir araç sonucu olarak döner. Hatalar, ajanın size başvurmadan toparlanabilmesi için eyleme geçirilebilir mesajlar içerir (hız sınırı ipucu, kapsam eksik, bulunamadı).
Kullanılabilir araçlar
Her araç JSON-Schema tipiyle tanımlanmıştır. Ajan, başlangıçta parametre adlarını, türlerini ve açıklamalarını görür. Manuel prompt mühendisliği gerekmez.
Örnek oturum
Kurulumdan sonra nasıl görünür
Bu, Elido MCP sunucusu eklendikten sonraki gerçek bir Claude Code oturumudur. Ajan, başlangıçta araçları keşfeder. Bundan sonra sade bir dil yeterlidir.
$ claude
> What tools do you have available?
Claude: I have access to the Elido MCP server with these tools:
- create_link: Shorten a URL with optional slug, domain, and tags
- list_links: Search and filter links by tag, folder, or query
- get_link_analytics: Click counts, geo, devices, conversions
- create_qr: Generate a QR code for a short link
- list_workspaces: Enumerate accessible workspaces
> Shorten https://elido.app/pricing with tag launch-2026
Claude: [calling create_link with {url, slug: "pricing-launch", tags: ["launch-2026"]}]
Result: eldo.link/pricing-launch · 0 clicks · audit loggedClaude Desktop ve Claude Code'da araç çağrısı çalıştırılmadan önce görünür. Ajanın hangi argümanları geçtiğini tam olarak görürsünüz. Çağrı tetiklenmeden önce iptal edebilirsiniz.
Ekipler bununla neler geliştiriyor
Üretimde gördüğümüz üç kalıp. Ekibinizin zaten çalıştığı biçime uyanı seçin.
Neden doğrudan API çağrıları değil de MCP?
Üç yaklaşım da aynı Elido uç noktalarına ulaşır. Farklar kurulum süresinde, güvenlik duruşunda ve ajanın akıl yürütmesinin ne kadar okunabilir olduğunda ortaya çıkar.
| Tüm özellikler, yan yana | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| Kurulum süresi | 30 saniye (yapılandırma + anahtar) | Özel prompt + araç tanımları (saatler) | Manuel yapıştırma / kazıma (otomasyon yok) |
| Araç kataloğu | Otomatik keşfedilir, JSON-Schema tipli | Elle yazılır, API geliştikçe güncelliğini yitirir | Yok - ajan tahmin etmek zorunda |
| API anahtarı yönetimi | Yerel sunucunun ortam değişkenlerinde kalır | Prompt'lara yapıştırılır (sızıntıya açık) | Panoya yapıştırılır (çereze bağlı) |
| Denetim kaydı | Sohbet geçmişinde yapılandırılmış araç çağrıları | Serbest metin - sonradan aramak zor | Tarayıcı geçmişi; niyeti yakalamaz |
| Çoklu istemci yeniden kullanımı | Tek yapılandırma, N adet MCP destekli istemci | Her istemci için yeniden prompt yazma | Tarayıcı başına durum, taşınabilirlik yok |
Test edilen istemciler
Kararlılık dereceleri, her sürümde her istemciye karşı çalışan dahili test paketimize dayanır. "Kararlı", tüm araç kataloğunun testleri geçtiği anlamına gelir. "Beta", çalıştığı ama uç durumların (akan sonuçlar, uzun listeler) beklenmedik şekilde davranabileceği anlamına gelir.
Güvenlik
Varsayılan olarak salt okunur. Anahtar yerelde kalır.
Güvenlik modeli, gerekli en az kapsam ilkesini izler. Varsayılan kurulum salt okunur erişime sahiptir. Her değişiklik kaydedilir. API anahtarı yerel sunucu sürecinden asla çıkmaz.
Anahtar izolasyonu
ELIDO_API_KEY, sunucunun ortam değişkenlerinde bulunur - asla bir prompt'ta yer almaz, asla modele gönderilmez. Model aracı çağırır; sunucu isteği imzalar. Model konuşmasının ele geçirilmesi anahtarı ifşa etmez.
Kapsam denetimi
Salt okunur varsayılandır. Yazma veya silme erişimi vermek bilinçli bir çalışma alanı ayarı gerektirir. Yazma etkinleştirilse bile her değişiklik, çağıran anahtarla birlikte çalışma alanı denetim kaydında görünür.
Açık kaynak
Sunucu, github.com/elidoapp/mcp-server adresinde MIT lisansıyla sunulur. Devreye almadan önce kaynak kodunu inceleyin. Yaygın fork'lar, çalışma alanına özgü zenginleştirme veya dahili araç çağrıları ekler.
30 saniyede kurun
Sunucu yerel olarak çalışır ve çalışma alanınızın API anahtarına karşı kimlik doğrulaması yapar. Zaten yapacağınız api.elido.app çağrıları dışında hiçbir veri makinenizden çıkmaz.
- 1Sunucuyu istemci yapılandırmanıza ekleyin
- 2ELIDO_API_KEY değişkenini ayarlayın (Ayarlar → API Anahtarları bölümünden bir tane oluşturun)
- 3İstemcinizi yeniden başlatın. Elido araçları ajanın araç listesinde görünür.
{
"mcpServers": {
"elido": {
"command": "npx",
"args": ["-y", "@elido/mcp-server"],
"env": { "ELIDO_API_KEY": "elido_pk_..." }
}
}
}Aynı kod parçacığı Cursor için de çalışır - .cursor/mcp.json dosyasına ekleyin. Claude Code için projenizin .mcp.json dosyasına ekleyin. API anahtarını Ayarlar → API Anahtarları bölümünden oluşturun. Çoğu iş akışı için salt okunur kapsam yeterlidir.
Sık sorulan sorular
Verilerim makinemden çıkıyor mu?+
Sadece zaten yapacağınız api.elido.app çağrıları çıkar. MCP sunucusu stdio (varsayılan) veya yerel SSE kullanır - eve telefon etmez, telemetri göndermez ve doğrulamak isterseniz kaynak kodu GitHub'da mevcuttur. Panoyla aynı AB veri ikamet kuralları geçerlidir.
Ajan yanlışlıkla bağlantılarımı silebilir mi?+
Varsayılan kurulumda hayır. Salt okunur mod varsayılandır; yazma/silme izni vermek bilinçli bir çalışma alanı ayarı gerektirir. Yazma etkinleştirilse bile her değişiklik, onu çağıran API anahtarıyla birlikte denetim kaydında görünür.
Hangi istemciler destekleniyor?+
Claude Desktop, Cursor ve Claude Code kararlıdır. Continue.dev beta aşamasındadır. stdio veya SSE üzerinden MCP 0.1.0 konuşan herhangi bir istemci çalışır - referans istemci uygulamasına karşı test ediyoruz.
Hız sınırı nedir?+
Çalışma alanınızın API anahtarıyla aynıdır - sürekli 100 istek/saniye, 200 patlama (burst), Retry-After ile 429 döner. MCP sunucusu 429'u bir araç hatası olarak ilettiği için ajan geri çekilebilir; ekstra bir katman eklemiyoruz.
Bu, /ai/llm sayfasındaki LLM entegrasyonlarıyla nasıl karşılaştırılır?+
Farklı katmanlar. /ai/llm tüketiciye yöneliktir (özel GPT'ler, Slack botları, deep-link düğmeleri) - hazır, tek tıkla kullanılır. MCP ise altta yatan geliştirici protokolüdür: bu entegrasyonların herhangi biri MCP üzerine inşa edilebilir ve birçok üçüncü taraf istemci tam olarak bunu yapar.
Kendi fork'umu çalıştırabilir miyim?+
Evet. Depo MIT lisanslıdır. Yaygın fork'lar özel araçlar ekler (ör. çalışma alanına özgü meta veri zenginleştirme, Notion/Linear'a dahili bağlantılar). Birini yayınlarsanız bir issue açın - geniş çapta faydalı araçları ana projeye kazandırmak istiyoruz.
Hava boşluklu (air-gapped) ortamlarda çalışır mı?+
Kendi barındırdığınız Elido için evet. MCP sunucusunun yalnızca api-core uç noktanıza ağ erişimine ihtiyacı vardır; bu özel VPC'niz olabilir. Genel bulut Elido, diğer tüm API istemcileri gibi api.elido.app'e giden erişime ihtiyaç duyar.
API anahtarı için güvenlik modeli nedir?+
Standart 'gerekli en az kapsam' ilkesi geçerlidir. Tek bir çalışma alanına özgü bir anahtar oluşturun, istemciniz bilinen bir IP'den çalışıyorsa IP'ye göre kısıtlayın ve üç ayda bir yenileyin. Anahtarın ele geçirilmesi, herhangi bir API anahtarının ele geçirilmesiyle aynı etki alanına sahiptir - çalışma alanıyla sınırlı, denetim kaydına işlenmiş ve iptal edilebilir.
Okumaya devam edin
Panonun içindeki yapay zeka - slug oluşturun, sade bir dille sorular sorun.
Özel GPT'ler, Slack botları, deep-link düğmeleri. /ai'nin hazır tarafı.
Zapier, HubSpot, Slack ve diğerleri. MCP'nin doğru araç olmadığı yerler.
MCP'nin sarmaladığı REST uç noktaları. MCP'nin henüz sunmadığı bir araca ihtiyacınız olduğunda faydalıdır.
30 saniyede hazır
Kod parçacığını Claude Desktop veya Cursor'a ekleyin, yeniden başlatın ve araçların ajanınızın kataloğunda belirdiğini görün.