Rivalize

Rivalize MCP Sunucusu

Yapay zeka asistanınız için kaynaklı, tarihli rekabet istihbaratı; Model Context Protocol üzerinden.

Ne yapar

Bu sunucu, Claude, Cursor veya herhangi bir MCP istemcisini Rivalize'e bağlar. Asistanınız, bir rakibin konumlandırmasını, fiyatlandırmasını, reklamlarını, sosyal varlığını, yorumlarını, işe alımlarını ve ivmesini tek bir çağrıyla analiz edebilir, Rivalize'nin takip edilen şirketler evreninde arama yapabilir ve kendi Rivalize hesabınızdaki projeleri, raporları, savaş kartlarını, zaman çizelgelerini ve kanıtları okuyabilir. Her yanıt, bir modelin hafızasından değil, Rivalize'nin tarih ve kaynaklarla birlikte topladığı verilerden gelir.

Sunucu varsayılan olarak salt okunurdur. RIVALIZE_MCP_ALLOW_WRITES=1 ile devre dışı bırakıldığında add_competitor adlı tek bir yazma aracı kullanılabilir.

Hızlı başlangıç

Node.js 22 veya daha yenisini gerektirir (node --version).

1. rivalize.ai adresinde bir hesap oluşturun.
2. Pano → Ayarlar → API Anahtarları altında bir API anahtarı oluşturun. Anahtarlar rk_live_ ile başlar. Herhangi bir plandan bir anahtar çalışır; ücretsiz plan da dahil olmak üzere, bu plan hız sınırlı okumalar alır.
3. Sunucuyu aşağıdaki bloklardan birini kullanarak istemcinize ekleyin.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows) dosyasını düzenleyin, ardından Claude Desktop'u yeniden başlatın:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Claude Code

claude mcp add rivalize -e RIVALIZE_API_KEY=rk_live_... -- npx -y @rivalize/mcp

Cursor

Projenize .cursor/mcp.json dosyasına veya tüm projeler için ~/.cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Cline

Cline'da MCP Sunucuları panelini açın, Yapılandır'ı ve ardından MCP Sunucularını Yapılandır'ı seçin. Bu, cline_mcp_settings.json dosyasını açar. Ekleyin:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Dosyayı kaydedin. rivalize sunucusu yaklaşık 10 ila 15 saniye sonra yeşil bir noktayla görünür (ilk başlatma paketi indirir). Windows'ta başlamazsa, "command": "cmd" ve "args": ["/c", "npx", "-y", "@rivalize/mcp"] kullanın.

Cline'dan sizin için kurmasını isterseniz, onu llms-install.md dosyasına yönlendirin.

Herhangi bir MCP istemcisi (stdio)

Sunucu, stdin ve stdout üzerinden MCP konuşur. İstemcinizi şu şekilde başlatacak şekilde yapılandırın:

Ayar	Değer
Komut	npx
Bağımsız Değişkenler	-y @rivalize/mcp
Ortam	RIVALIZE_API_KEY=rk_live_...
Taşıma	stdio

Windows'ta bazı istemciler npx doğrudan başlatamaz çünkü npx.cmd. Bunun yerine komut olarak cmd ve bağımsız değişkenler olarak /c npx -y @rivalize/mcp kullanın.

Araçlar

On üç salt okunur araç her zaman kullanılabilir. add_competitor yalnızca RIVALIZE_MCP_ALLOW_WRITES değeri 1, true veya yes olarak ayarlandığında kaydedilir; bu olmadan araç istemci için mevcut değildir.

Araç	Erişim	Ne yapar	Temel bağımsız değişkenler
teardown_competitor	okuma	Bir rakibin tek çağrılık strateji analizi Markdown olarak: konumlandırma, fiyatlandırma, reklamlar, sosyal, yorumlar, işe alımlar, ivme ve saldırılacak zayıflıklar; verilerin en son ne zaman yenilendiğiyle birlikte	domain (gerekli)
list_universe_companies	okuma	Rivalize evreninde, takip edilen şirketlerin müşteriler arası veri kümesinde arama yapın	q, category (kısa ad), layer, limit (1-100), offset
get_universe_company	okuma	Bir şirket için tam evren profili: kimlik, fiyatlandırma, özellikler, reklamlar, sosyal, yorumlar, finansman ve işe alımlar, sıralamalar, sinyaller, ivme	domain (gerekli), layers
list_projects	okuma	Hesabınızdaki projeler; diğer araçların aldığı project_id değerini döndürür	yok
list_reports	okuma	Raporlarınız, en yenisi en üstte. Okuma asla rapor oluşturmaz	project_id, limit (1-100), offset
get_report	okuma	Bir rapor Markdown olarak, tamamı veya bir bölümü veya bir rakibi aynı anda	report_id (gerekli), section, competitor, page
list_competitors	okuma	Takip ettiğiniz rakipler, ivme puanı, tehdit seviyesi bandı ve API'nin sağladığı yerlerde her rakibin Özetinizdeki durumuyla birlikte	project_id, limit (1-100), offset
get_competitor_intelligence	okuma	Takip edilen bir rakip için en son saklanan istihbarat; bir alan yalnızca ölçüldüğünde mevcuttur	competitor_id (gerekli)
get_battlecard	okuma	Takip edilen bir rakip için kaynaklı satış savaş kartı. Pro planı gerektirir	competitor_id (gerekli)
get_strategic_timeline	okuma	Rakip hamlelerinin kanıt bağlantılı zaman çizelgesi: fiyatlandırma, ürün, kişiler, finansman ve içerik/sosyal	project_id (gerekli), days (30, 90, 180), competitor_id, lanes, format, page
get_competitive_landscape	okuma	Rakiplerin aktivite ve stratejik öneme göre güncel veya saklanan haftalık konumları	project_id (gerekli), week (YYYY-MM-DD), format, page
get_freshness	okuma	Bir projedeki her takip edilen rakibin en son ne zaman gerçekten gözlemlendiği ve nasıl	project_id (gerekli)
get_evidence	okuma	Ürününüz veya bir rakip için gerçeklerin arkasındaki kaynaklar: URL, neyi desteklediği ve ne zaman okunduğu	project_id (gerekli), competitor_id
add_competitor	yazma, isteğe bağlı	Bir projeye rakip URL'leri ekleyin. Kredi harcar ve analizi sıraya koyar	project_id (gerekli), urls (1-10, gerekli)

project_id ve competitor_id, list_projects ve list_competitors kaynaklı UUID'lerdir. Hesabınızı okuyan araçlar yalnızca kendi verilerinizi görür.

Rapor bölümleri

get_report, bir section alır; böylece asistanınız tüm rapor yerine bir sorunun ihtiyaç duyduğu kısmı okuyabilir:

Bölüm	İçerik
tldr, biggest-threat, blind-spots, actions	Raporun başlık bölümleri (actions, ürününüzün ne yapması gerektiğidir)
battlecards	Kaynaklı satış savaş kartları
competitors	Her rakibin bölümünün tamamı
pricing, momentum, app-store, strengths, weaknesses, key-findings, creators, ads, tech-stack	Her rakibin bölümünden toplanan tek bir konu

Bir rapor yalnızca verisi olan bölümlere sahiptir; başka bir ad istemek, sahip olduğu bölümleri listeleyen bir hata döndürür. section, competitor ile birleşir; böylece section: "pricing" ile competitor: "Acme", Acme'nin fiyatlandırmasını döndürür. Raporun fabrikasyon kontrolünün kaldırdığı iddialar, raporda olduğu gibi [removed — unverified] olarak görünür.

Uzun yanıtlar

Her yanıt 25.000 karakterin altında kalır ve hiçbir şey sessizce kesilmez:

• Markdown (get_report, get_strategic_timeline, get_competitive_landscape) bölüm sınırlarında sayfalara bölünür. Her sayfa Page N of M, ne kadar kaldığı ve sonraki sayfa için tam çağrı ile başlar.
• Listeler (list_universe_companies, list_competitors, list_reports) pagination.next_offset döndürür; null olana kadar ondan devam edin.
• Nesneler (get_universe_company ve zaman çizelgesi veya manzara JSON'u) uzun dizileri sınırlar ve sınırı _capped içinde kaydeder. Hâlâ sığmayan bir alan, onu getiren çağrıyla birlikte _omitted içinde listelenir.

Örnek komutlar

• "linear.app'i analiz et." (teardown_competitor)
• "AI geliştirici araçlarında oyuncular kimler?" (list_universe_companies)
• "En son raporumu özetle, sonra rakiplerimin ne ücret aldığını göster." (list_reports, get_report ile section: "pricing")
• "Bu çeyrekte rakiplerimden hangisi en çok hareket etti ve ne yaptılar?" (get_competitive_landscape, get_strategic_timeline)
• "En büyük rakibime karşı satış konuşma noktaları ver." (list_competitors, get_battlecard)
• "Bu fiyatlandırma iddiası nereden geliyor ve ne kadar taze?" (get_evidence, get_freshness)

Yapılandırma

Değişken	Gerekli	Varsayılan	Açıklama
RIVALIZE_API_KEY	evet	yok	Rivalize API anahtarınız. rk_live_ ile başlamalıdır; eksik veya hatalıysa sunucu başlangıçta bir mesajla çıkar.
RIVALIZE_API_URL	hayır	https://rivalize.ai	Rivalize API'sinin kaynağı. Bir anahtar yalnızca onu veren sunucuda çalışır: rivalize.ai için bunu boş bırakın ve kendi kendine barındırılan veya üretim dışı bir Rivalize sunucusu için o sunucunun kaynağına ayarlayın; aksi takdirde her çağrı 401 döndürür.
RIVALIZE_MCP_ALLOW_WRITES	hayır	kapalı	1, true veya yes (herhangi bir büyük/küçük harf) add_competitor kaydeder. Başka herhangi bir değer veya ayarsız, sunucuyu salt okunur tutar.
HTTPS_PROXY / HTTP_PROXY	hayır	yok	İstekleri kurumsal bir proxy üzerinden yönlendirin. Küçük harfli biçimler de okunur ve her ikisi de ayarlandığında HTTPS_PROXY kazanır. NO_PROXY dikkate alınır. Hatalar proxy ana bilgisayarını adlandırır, asla kimlik bilgilerini adlandırmaz.

Sorun giderme

"Bağlantı kapandı"

Sunucu başlatılamadığında, birçok istemci yalnızca "Bağlantı kapandı" veya başarısız bir durum gösterir. Sunucu, nedenini stderr'inin ilk satırı olarak rivalize-mcp: önekiyle yazdırır ve çoğu istemci stderr'i MCP günlüğünde tutar. Olağan nedenler:

1. RIVALIZE_API_KEY eksik veya geçersiz. Günlük rivalize-mcp: RIVALIZE_API_KEY is required okur veya anahtarın bir Rivalize API anahtarına benzemediğini söyler (rk_live_ ile başlamalıdır). Anahtarı sunucunun env bloğuna koyun ve istemciyi yeniden başlatın.
2. Node.js 22'den eski. node --version çalıştırın ve Node.js 22 veya daha yenisini kurun. İstemciniz, kendi PATH üzerinde ilk gelen node ve npx kullanır; bu, terminalinizinkinden farklı olabilir.
3. Ağ erişimi yok. npx paketi ilk çalıştırmada indirir ve her araç çağrısı https://rivalize.ai (veya RIVALIZE_API_URL) adresine gider. Kurumsal bir proxy arkasında HTTPS_PROXY ayarlayın. Bir ağ hatası, sunucuyu ve ECONNREFUSED veya ENOTFOUND gibi neden kodunu adlandırır.

Mesajı doğrudan görmek için sunucuyu aynı anahtarla bir terminalde çalıştırın:

RIVALIZE_API_KEY=rk_live_... npx -y @rivalize/mcp

Sağlıklı bir sunucu stderr'e rivalize-mcp-server connected via stdio yazdırır ve girişi bekler (durdurmak için Ctrl+C'ye basın). Başka herhangi bir şey, istemcinizin bağlanamamasının nedenidir.

Her çağrı 401 döndürüyor

Anahtar, gönderildiği sunucu tarafından reddedildi ve hata o sunucuyu adlandırır. Anahtarın iptal edilmediğini ve anahtar farklı bir Rivalize sunucusu tarafından verilmediği sürece RIVALIZE_API_URL ayarının boş olduğunu kontrol edin.

Bir araç daha yüksek bir plan gerektirdiğini söylüyor

Okumalar her planda kullanılabilir. Savaş kartları ve tam zaman çizelgesi veya manzara geçmişi gibi bazı yetenekler daha yüksek bir plan gerektirir; hata hangisini söyler ve rivalize.ai/pricing adresine bağlantı verir.

Docker

Depo, Node 22 üzerinde aynı stdio sunucusunu oluşturan ve onu root olmayan bir kullanıcı olarak çalıştıran bir Dockerfile içerir.

docker build -t rivalize-mcp .

{
  "mcpServers": {
    "rivalize": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RIVALIZE_API_KEY", "rivalize-mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Kapsayıcıyı -i ile ve TTY olmadan çalıştırın, çünkü MCP stdin ve stdout kullanır. Değeri olmayan -e RIVALIZE_API_KEY, anahtarı istemcinin ortamından geçirir; böylece docker run komut satırında asla görünmez. Gerekirse -e RIVALIZE_API_URL veya -e RIVALIZE_MCP_ALLOW_WRITES aynı şekilde ekleyin.

Gizlilik Politikası

Bu sunucu, Rivalize API'si için ince bir istemcidir.

• Ne gönderir ve nereye gönderir. Her araç çağrısı, Rivalize API'sine https://rivalize.ai adresine veya RIVALIZE_API_URL içinde belirlediğiniz kaynağa bir HTTPS isteği haline gelir. Bir istek, API anahtarınızı Bearer token olarak, rivalize-mcp/<version> değerinde bir User-Agent ve araç argümanlarını taşır: örneğin bir şirket alan adı, bir arama terimi, bir proje, rapor veya rakip kimliği ve yazma etkinleştirilmişse eklediğiniz rakip URL'leri. HTTPS_PROXY veya HTTP_PROXY ayarlarsanız, istekler bu proxy üzerinden gider. Başka hiçbir yere hiçbir şey gönderilmez.
• Ne göndermez. Telemetri, analiz veya çökme raporu yoktur. Makinenizdeki dosyaları, konuşmanızı veya diğer araçların çıktılarını okumaz; yalnızca MCP istemcinizin kendi araçlarına ilettiği argümanları görür.
• Yerel olarak ne saklar. Hiçbir şey. Dosya yazmaz, önbellek tutmaz ve çalıştırmalar arasında durum saklamaz. Anahtarınız, bu sunucuda değil, MCP istemcinizin yapılandırmasında yaşar. Tanılama mesajları, MCP istemcinizin kaydedebileceği stderr'e gider; bunlar asla API anahtarınızı içermez.
• Rivalize isteklerle ne yapar. API, bunları rivalize.ai/privacy adresindeki Rivalize Gizlilik Politikası kapsamında işler. Rivalize, bu verilerin veri denetleyicisi olan Downshift LLC tarafından işletilir. Gizlilik soruları privacy@rivalize.ai adresine gönderilir.

Güvenlik

Lütfen güvenlik açıklarını herkese açık bir sorun olarak değil, konu satırında "security" yazarak support@rivalize.ai adresine özel olarak bildirin. Paket sürümünü (npm view @rivalize/mcp version veya yukarıdaki User-Agent), ne yaptığınızı ve ne olduğunu ekleyin. Raporunuzu kabul edeceğiz ve çözülene kadar sizi güncel tutacağız.

API anahtarınıza bir kimlik bilgisi gibi davranın. İstemcinizin env bloğunda veya kabuk ortamınızda tutun, asla paylaşılan veya taahhüt edilen bir dosyada değil ve sızan bir anahtarı Dashboard → Settings → API Keys altında iptal edin.

Katkıda Bulunma

Hata raporları ve özellik istekleri github.com/Downshift/rivalize-mcp/issues adresinde memnuniyetle karşılanır. Hesap ve faturalandırma soruları için support@rivalize.ai adresine e-posta gönderin.

Sunucu üzerinde yerel olarak çalışmak için:

npm ci
npm run typecheck
npm run build      # emits dist/, which the rivalize-mcp bin runs
npm test           # offline: every API call is mocked or served by a local fixture

server.json, MCP Registry girişidir. Testler, onu resmi şemaya karşı doğrular (schema/ içinde satılmıştır) ve adının, sürümünün ve paketinin package.json ile eşleştiğini kontrol eder.

Değişiklik Günlüğü

0.3.2

• list_competitors artık asistanınıza en iyi rakibi nasıl seçeceğini söyler: API bunu döndürdüğünde rakibin Brief'inizdeki (brief.standing) konumuna göre, aksi takdirde momentum_score ile. threat_level, momentum puanının bandı olarak ne olduğu şeklinde tanımlanır ve artık bir sıralama olarak sunulmaz.
• Bir satırın konumu hâlâ okunurken (brief.state deferred olduğunda), list_competitors aynı sayfayı 1,5 saniye arayla en fazla 4 kez ister. brief döndürmeyen bir API'ye karşı, her çağrı için eskisi gibi bir istek yapar.
• Kendi kendine barındırılan veya üretim dışı bir Rivalize sunucusu için 401 ipucunda ve add_competitor açıklamasında daha net ifadeler.

0.3.1

• Bu deponun geçmişinin başladığı sürüm: on üç salt okunur araç, isteğe bağlı add_competitor yazma aracı, açık sayfalama ile 25.000 karakterin altında tutulan yanıtlar, proxy desteği ve server.json içindeki MCP Registry girişi.

Lisans

MIT, © 2026 Downshift LLC. LICENSE bölümüne bakın.