CryptoRank MCP Sunucu Dokümantasyonu

Paylaş:

Paylaş:
Hızlı Başlangıç
MCP Sunucu URL'si: https://api.cryptorank.io/mcp
CryptoRank MCP Server, Claude ve ChatGPT gibi AI asistanlarına CryptoRank'in kripto araştırma veri setlerine — fonlama turları, yatırımcı profilleri, token unlock'ları ve daha fazlasına — doğrudan erişim sağlar. Erişim için PRO API planı veya üzeri bir CryptoRank hesabı gereklidir.
Kurulum rehberinizi seçin:
-
Claude'a bağlanma (claude.ai) — tarayıcı tabanlı / Claude Desktop, config dosyası gerekmez
-
ChatGPT'ye bağlanma (chat.openai.com) — tarayıcı tabanlı, config dosyası gerekmez
-
Desktop / IDE Client'larından bağlanma — Claude Code, Cursor, Windsurf ve benzeri araçlar için
Neden CryptoRank MCP kullanmalısınız?
Geleneksel API'ler, AI agent'larınız veriyi kullanmadan önce glue code yazmanızı, sayfalama yönetmenizi ve JSON'u normalize etmenizi gerektirir.
MCP ile CryptoRank, fundraising araması, fund intelligence ve vesting takvimleri gibi alan odaklı araçları, agent'ların doğal dil komutlarından otonom şekilde çağırabileceği şekilde sunar.
Bu, genel amaçlı bir modeli, başka yerlerden kazıması zor veya imkânsız olan verilerle çalışan kripto-yerel bir araştırma, trade veya yatırım asistanına dönüştürmeyi kolaylaştırır.
REST yanıtlarını parse etmek yerine, agent'lar fonlama turları, yatırımcı profilleri, token unlock'ları, proje ekipleri ve piyasa verilerine, modellerin doğal olarak anladığı formatta erişmek için üst düzey araçları çağırır.
Temel veri setleri
CryptoRank MCP, temel fiyatlar ve ticker'ların ötesinde, benzersiz ve araştırma seviyesinde veri setlerine odaklanır.
-
Funding Rounds: ICO/IDO/IEO/özel turlar, toplanan tutarlar, aşamalar, katılımcılar ve tarihler.
-
Funds & Backers: VC profilleri, seviyeler, stratejiler, portföy dağılımları, son anlaşmalar ve çek boyutları.
-
Vesting & Token unlock'lar: detaylı takvimler, yaklaşan unlock'lar, arz/piyasa değeri yüzdeleri.
-
Proje Ekipleri: ekip kompozisyonu, öne çıkan üyeler ve linkler.
Bunların tümü MCP aracı olarak sunulur; böylece agent'lar, "2025'te 10M $'ın üzerinde fon toplayan ve gelecek çeyrekte büyük token unlock'ları olan AI projelerini göster" gibi tek bir sorguda bunları birleştirebilir.
Sunucu seçenekleri
CryptoRank, tek bir kimlik doğrulamalı uzak MCP sunucusu sunar. Ücretsiz anahtarsız seviye ve lokal MCP sunucusu yoktur.
|
MCP Sunucu Türü |
En uygun kullanım |
Durum |
|
Uzak Sunucu (Kimlik Doğrulamalı) |
Production AI agent'lar, ciddi araştırma, dahili araçlar |
Beta |
Tüm erişim mevcut CryptoRank Public API anahtarınız üzerinden sağlanır ve MCP kullanımı PRO (veya üzeri) plan limitlerinize sayılır.
Gereksinimler
İhtiyacınız olanlar, nasıl bağlanmayı planladığınıza bağlıdır.
Web kullanıcıları (claude.ai / chat.openai.com)
Claude veya ChatGPT'yi bir tarayıcıda kullanıyorsanız, kurulum tamamen point-and-click'tir — config dosyası veya terminal gerekmez.
-
PRO API planı veya üzeri CryptoRank hesabı
-
Uyumlu bir abonelik:
-
Claude: claude.ai üzerinde Pro, Max, Team veya Enterprise plan
-
ChatGPT: chat.openai.com üzerinde Plus, Pro, Business veya Enterprise plan
Desktop / IDE kullanıcıları (Claude Desktop, Cursor, Windsurf, vb.)
Config dosyası tabanlı bir MCP client kullanıyorsanız, şunlara ihtiyacınız olacak:
-
PRO API planı veya üzeri bir CryptoRank hesabı ve API anahtarınız
-
MCP uyumlu bir desktop client (ör. Claude Desktop, Cursor, Windsurf, Gemini CLI)
-
JSON konfigürasyon dosyası düzenleme konusunda temel bilgi (ör. claude_desktop_config.json)
Genel, kimlik doğrulamasız bir endpoint ve lokal/çevrimdışı MCP sunucu dağıtımı yoktur.
Claude'a bağlanma (claude.ai)
Gereksinimler: Claude Pro, Max, Team veya Enterprise plan · CryptoRank PRO API hesabı · Modern tarayıcı
Bu rehber, CryptoRank MCP connector'ünü web'de Claude'a eklemeniz için adım adım yol gösterir. Tüm süreç yaklaşık 5 dakika sürer.
Adım 1 — Claude'u açın ve yeni bir sohbet başlatın
claude.ai adresine gidin ve hesabınıza giriş yapın.
Yeni bir konuşma açmak için New chat'e tıklayın.
Adım 2 — Ek menüsünü açın
Sohbet arayüzünde, dosya, connector ve daha fazlasını ekleme butonuna tıklayın (alt araç çubuğundaki artı simgesi).

Adım 3 — Özel bir connector ekleyin
Açılan panelde Connectors'a, ardından Manage Connectors'a tıklayın.
Artı simgesine tıklayın, ardından Add custom connector'a tıklayın.

Adım 4 — CryptoRank MCP URL'sini girin
URL alanına şunu girin: https://api.cryptorank.io/mcp

Add'e tıklayın. CryptoRank için bir OAuth yetkilendirme penceresi açılacaktır.
Adım 5 — OAuth üzerinden yetkilendirin
CryptoRank hesabınızla (PRO API planınızla ilişkili olan) giriş yapın ve istendiğinde erişimi onaylayın.
Onayladıktan sonra Claude'a geri yönlendirileceksiniz ve CryptoRank connector'ü connector listenizde görünecek.

Adım 6 — OAuth başlatma sorununu düzeltin
⚠️ Önemli — OAuth Başlatma Sorunu
Connector'ü ekleyip OAuth'u tamamladıktan sonra, connector ilk sohbetinizde doğru yanıt vermeyebilir. Bu, OAuth oturumunun nasıl başlatıldığına dair bilinen bir sorundur.
Çözüm: Listede CryptoRank connector'ünü bulun, OFF konumuna alın, ardından tekrar ON konumuna getirin.
Bu tek seferlik geçişten sonra connector istikrarlı şekilde çalışır.
Adım 7 — Bağlantıyı doğrulayın
Yeni bir sohbet başlatın ve CryptoRank connector'ünün etkin olduğundan emin olun (toggle ON konumunda).
Claude'a şunu sorun:
"En son kripto funding round'ları neler?"
Claude, CryptoRank kaynaklı güncel fonlama verileriyle yanıt vermelidir. ✅
Genel veya eski bilgiler görürseniz, yeni bir sohbet başlatmayı deneyin — konuşma ortasında eklenen connector'ler geriye dönük uygulanmayabilir.
ChatGPT'ye bağlanma (chat.openai.com)
Gereksinimler: ChatGPT Plus, Pro, Business veya Enterprise plan · CryptoRank PRO API hesabı · Modern tarayıcı (Chrome veya Edge önerilir)
Bu rehber, CryptoRank MCP connector'ünü web'de ChatGPT'ye eklemeniz için adım adım yol gösterir. Tüm süreç yaklaşık 5 dakika sürer.
Adım 1 — ChatGPT'yi açın
chat.openai.com adresine gidin ve hesabınıza giriş yapın.
Adım 2 — Settings'i açın
Sağ üst köşedeki profil simgenize tıklayın ve Settings'i seçin.
Adım 3 — Developer Mode'u etkinleştirin
Settings içinde Apps'e gidin, ardından Advanced settings'i açın.
Developer mode'u ON konumuna getirin.

⚠️ Önemli: MCP connector'lerinin çalışması için Developer mode etkin kalmalıdır. Kurulumdan sonra kapatmayın.
Adım 4 — Uygulama oluşturun
Apps & Connectors içindeki Apps bölümüne geri dönün ve Create app'e tıklayın.

Adım 5 — Connector detaylarını girin
Formu doldurun:
-
Name: CryptoRank MCP
-
URL: https://api.cryptorank.io/mcp

Adım 6 — OAuth üzerinden yetkilendirin
Save (veya Add)'e tıklayın. Bir CryptoRank OAuth yetkilendirme penceresi açılacaktır.
CryptoRank hesabınızla (PRO API planınızla ilişkili olan) giriş yapın ve erişimi onaylayın.

Adım 7 — Connector'ü bir sohbette etkinleştirin
Yeni bir sohbet başlatın. Mesaj giriş alanının yanındaki + simgesine tıklayın ve mevcut connector listesinden CryptoRank'i seçin.

Adım 8 — Bağlantıyı doğrulayın
CryptoRank connector'ü etkinken şunu sorun:
"En son kripto funding round'ları neler?"
ChatGPT, CryptoRank kaynaklı güncel fonlama verileriyle yanıt vermelidir. ✅
Genel veya eski veriler görürseniz, yeni bir sohbet başlatın ve connector'ü tekrar seçin — mevcut konuşmalar yeni eklenen connector'leri otomatik olarak almaz.
Desktop / IDE Client'larından bağlanma
Claude Desktop, Cursor, Windsurf ve diğer config tabanlı MCP client'ları için
Web tabanlı client'lar (claude.ai, chat.openai.com) için yukarıdaki adım adım rehberlere bakın.
Çoğu desktop ve IDE MCP client, JSON konfigürasyon dosyası aracılığıyla harici sunucular eklemeyi destekler. Aşağıda, mcp-remote kullanarak CryptoRank uzak MCP sunucusu için örnek bir konfigürasyon yer almaktadır:
|
{ "mcpServers": { "cryptorank_mcp": { "command": "npx", "args": [ "mcp-remote", "https://api.cryptorank.io/mcp" ], "env": { "CRYPTORANK_API_KEY": "YOUR_PRO_API_KEY" } } } } |
YOUR_PRO_API_KEY'i CryptoRank API anahtarınızla değiştirin. Konfigürasyonu kaydedip client'ınızı yeniden başlattıktan sonra CryptoRank araçları otomatik olarak görünecek ve sorgularınızla ilgili olduğunda model tarafından çağrılacaktır.
Yaygın config dosyası konumları:
|
Client |
Config dosyası yolu |
|
Claude Desktop (macOS) |
~/Library/Application Support/Claude/claude_desktop_config.json |
|
Claude Desktop (Windows) |
%APPDATA%\Claude\claude_desktop_config.json |
|
Cursor |
.cursor/mcp.json (proje) veya ~/.cursor/mcp.json (global) |
|
Windsurf |
~/.codeium/windsurf/mcp_config.json |
Örnek araçlar
Kesin araç isimleri zamanla değişebilir, ancak CryptoRank MCP Server, market endpoint'lerine benzer, odaklı ve yüksek sinyalli araçlar etrafında tasarlanmıştır.
Tipik kategoriler şunları içerir:
-
Proje & varlık keşfi (isim, sembol, sektör, etiketler veya anlatılara göre arama).
-
Fundraising & turlar (tarih aralığı, sektör, minimum raise veya lead investor'a göre filtreleme).
-
Fund & yatırımcı profilleri (seviye, tez, portföy kompozisyonu, yakın tarihli anlaşmalar, coğrafyalar).
-
Token unlock'ları & vesting (yaklaşan unlock'lar, geçmiş unlock'lar, etki metrikleri).
Araçlar, AI agent'ların tablo üretmesi, karşılaştırmalar yapması ve ek glue code olmadan birden fazla çağrıyı zincirlemesi için yapılandırılmış, model dostu objeler döndürecek şekilde tasarlanmıştır.
Kullanım örnekleri
Bir AI agent'ın CryptoRank MCP araçlarını kullanarak yanıtlayabileceği örnek komutlar şunlardır:
-
"2025'te 10M USD üzerinde fon toplayan tüm AI projelerini, turları ve lead investor'larıyla birlikte göster."
-
"Gelecek çeyrek için büyük token unlock'larını, unlock değerine ve dolaşımdaki arz yüzdesine göre sıralayarak listele."
-
"a16z'nin DeFi projelerine yaptığı tüm yatırımları bul ve portföy büyüklüklerini ve son exit'lerini özetle."
Her durumda agent, çoklu REST endpoint'lerini elle birleştirmek yerine, fundraising, funds, unlock'lar, ekipler, fiyatlar gibi uygun araçları MCP üzerinden otomatik olarak seçer ve birleştirir.
Fiyatlandırma ve rate limit'ler
CryptoRank MCP Server için ayrı bir fiyatlandırma yoktur; erişim CryptoRank Public API'nin PRO ve üzeri seviyelerine dahildir.
MCP istekleri, mevcut planınızdaki kredileri ve rate limit'leri tüketir; böylece ikinci bir faturalandırma yüzeyi yönetmeden yükseltme veya düşürme yapmanız kolaylaşır.
Rate limit'e ulaşırsanız, agent'ınızın araç kullanımını optimize edebilir veya tıpkı doğrudan REST kullanımı için yapacağınız gibi daha yüksek bir API seviyesine geçebilirsiniz.
Sorun giderme
|
Sorun |
Çözüm |
|
Connector eklendi ancak AI CryptoRank verisini kullanmıyor |
Connector'ü OFF - ON konumuna getirin. Bu, OAuth başlatma sorununu çözer. Geçişten sonra yeni bir sohbet başlatın. |
|
Claude'da "Search and tools" görünmüyor |
Claude Pro, Max, Team veya Enterprise plan gerektirir. Farklı bir tarayıcı deneyin veya cache'inizi temizleyin. |
|
ChatGPT'de "Connectors" seçeneği görünmüyor |
Developer Mode'u etkinleştirin: Settings - Apps & Connectors - Advanced settings - Developer mode ON. |
|
"Unable to connect" hatası |
URL'nin tam olarak https://api.cryptorank.io/mcp olduğundan emin olun. İnternet bağlantınızı kontrol edin ve birkaç dakika içinde yeniden deneyin. |
|
"Rate limit exceeded" hatası |
CryptoRank API planınızın PRO veya üzeri olduğundan emin olun. Tekrar denemeden önce birkaç dakika bekleyin. Daha yüksek limitler için yükseltmeyi düşünün. |
|
OAuth popup görünmüyor |
Tarayıcınızın popup engelleyicisini kontrol edin ve claude.ai veya chat.openai.com için popup'lara izin verin. Chrome veya Edge deneyin. Reklam engelleyicileri geçici olarak devre dışı bırakın. |
|
Genel veya eski veriler alınıyor |
Yeni bir sohbet başlatın. Konuşma ortasında eklenen connector'ler geriye dönük uygulanmayabilir. Açıkça "latest" veya "current" verileri isteyin. |
|
Connector listeleniyor ancak kullanılabilir araç yok |
API anahtarınız PRO erişimine sahip olmayabilir. Planınızı cryptorank.io/public-api/pricing adresinde doğrulayın. |
Sınırlamalar
CryptoRank MCP Server, ücretsiz anahtarsız endpoint'i ve lokal/çevrimdışı MCP dağıtımı olmayan barındırılan bir uzak servistir.
Belirli araçlara ve veri setlerine erişim, planlara göre biraz farklılık gösterebilir ve altta yatan CryptoRank Public API ile aynı yetkilendirme modelini takip eder.