Context7 MCP nedir? Kod asistanına güncel kütüphane belgesi getirmek, kurulum, API anahtarı ve ücret

Kod yazan asistanlar kütüphaneleri eğitildikleri tarihteki hâliyle bilir. Context7 bir MCP sunucusu: kurulunca asistan kod yazmadan önce kullandığın kütüphanenin güncel, sürüme özel belgesini ve kod örneğini okur; isteğinin sonuna "use context7" yazman yeter. Böylece eski sürüme ait ya da var olmayan kod önerme ihtimali azalır. Uzak sunucu olarak kurulur, bilgisayarda Node.js gerekmez.

Ne yapar: Asistana güncel kütüphane belgesi getirir
Tür: MCP sunucusu (uzak ya da yerel)
Nerede: Claude Code, Claude Desktop, Cursor, VS Code, Codex
API anahtarı: Önerilir, zorunlu değil
Dışarı giden: Asistanın arama sorgusu; kodun gitmez
Türkçe: Resmî kaynak yazmıyor
Ücret: Ücretsiz plan: ayda 1.000 çağrı

Context7 ne işe yarar?

Kod yazan yapay zekâ asistanları kütüphaneleri genelde eğitim verisinden bilir; bu da eski sürüme ait kod ya da hiç var olmayan fonksiyonlar üretmelerine yol açabilir. Context7 bu sorunu azaltmayı hedefler: asistan kod yazmadan önce ilgili kütüphanenin güncel belgesini ve kod örneğini Context7'den çeker. MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır.

Kütüphanenin güncel belgesini getirtmekNe alırsın: İstenen kütüphanenin belge parçaları ve kod örnekleriBağlantı gerekir

Sunucu iki araç sunar: biri kütüphane adını Context7 kimliğine çevirir, öteki o kimlikle belge ve kod örneği getirir. Belgede yazma ya da silme aracı listelenmiyor.

Kime yarar: Claude Code, Cursor ya da VS Code ile kod yazan ve sık güncellenen kütüphanelerle (örneğin web çatıları) çalışan geliştiricilere. Kod yazmıyorsan işine yaramaz.

MCP ne demek? Bir köprü

MCP, asistanın kendi dışındaki bir servise bağlanmasını sağlayan ortak bağlantı biçimi. Context7 bu köprünün öbür ucundaki servis: asistan sorunu ona sorar, o da kütüphanenin belgesini geri yollar.

Sen"Bunu yaz. use context7"

AsistanClaude Code, Cursor, VS Code…

Context7Kütüphane belgesi ve kod örneği

Giden: asistanın oluşturduğu arama sorgusu ve kütüphane adı. Kodun ve sohbetin gitmez.

Context7 olmadan ve olunca

Context7 olmadanTemsili

Next.js'in son sürümünde bu dosyayı nasıl kurarım?

Eğitim verisindeki bilgiyle cevap verir. Kütüphane o tarihten sonra değiştiyse eski bir sürümün kodunu önerebilir.

Context7 ileTemsili

Next.js'in son sürümünde bu dosyayı nasıl kurarım? use context7

context7 · belge getiriliyorÖnce o sürümün belgesini ve örnek kodunu çeker, cevabı belgeye dayanarak yazar.

Context7 nasıl kurulur?

İki yol var: Context7'nin barındırdığı uzak sunucu (bilgisayarda Node.js gerekmez) ya da bilgisayarda çalışan yerel paket. Komutlar resmî belgelerden aynen alındı; YOUR_API_KEY yerine kendi anahtarını yazarsın.

Hızlı kurulum (Node.js 22.13 veya üstü)› npx ctx7 setup

Komut tarayıcıda giriş yaptırır, API anahtarı üretir ve uygun skill'i kurar; "CLI + Skills" ya da "MCP" modunu seçersin. Belirli bir ajan için --claude, --cursor ya da --opencode ekle. Geri almak için npx ctx7 remove.

Uzak sunucu

› claude mcp add --scope user --header "Authorization: Bearer YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp

Ya da tek komutla› npx ctx7 setup --claude

Context7'nin Claude Code eklentisi de var (/plugin marketplace add upstash/context7, sonra /plugin install context7@context7-marketplace); belge bu yolda API anahtarı gerekmediğini, girişin /mcp ile tarayıcıda yapıldığını yazıyor. Yerel sunucu için: claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY.

Uzak yol: Settings sonra Connectors sonra Add Custom Connector. Adı Context7, adresi https://mcp.context7.com/mcp yaz (Context7 belgesindeki yol). Claude'un kendi belgesi özel bağlayıcıyı Customize sonra Connectors altında anlatıyor; ücretsiz Claude kullanıcısı tek özel bağlayıcı ekleyebilir.
Yerel yol: geliştirici ayarlarındaki claude_desktop_config.json dosyasına mcpServers altında command: npx ve args: -y @upstash/context7-mcp --api-key YOUR_API_KEY girdisi ekle.

Cursor Settings sonra Tools & MCP › New MCP Server; ya da ~/.cursor/mcp.json içine url: https://mcp.context7.com/mcp ve Authorization başlığını yaz.
Yapılandırmayı değiştirince Cursor'u yeniden başlat.

Ya da tek komutla› npx ctx7 setup --cursor

Marketplace'ten "Context7 MCP Server" eklentisini kur (Upstash.context7-mcp, VS Code 1.101 veya üstü). Doğrulamak için MCP: List Servers komutunu çalıştır.
API anahtarı için ayarlardaki "Context7: Api Key" alanını ya da settings.json'daki context7.apiKey değerini kullan.
Elle kurulum: .vscode/mcp.json içine type: http, url: https://mcp.context7.com/mcp yaz.

Codex› npx ctx7 setup --codex

Gemini CLI için belge ~/.gemini/settings.json içine mcpServers girdisi eklemeyi (httpUrl ve Authorization başlığı), ChatGPT için Developer Mode (beta) ile uygulama oluşturmayı (adres https://mcp.context7.com/mcp/oauth) anlatıyor; ChatGPT yolu belgeye göre Pro, Plus, Team, Enterprise ve Edu planlarında.

Windows'ta yerel npx sunucusu için belge komutu cmd üzerinden çalıştırmayı öneriyor (command: cmd, args: /c npx -y @upstash/context7-mcp). Yerel paket Node.js 20.18.1 veya üstü ister.

API anahtarını context7.com/dashboard adresinden ücretsiz alırsın; anahtar "ctx7sk" ile başlar ve yalnız oluşturulurken bir kez gösterilir, hemen kaydet. Anahtarı paylaşılan bir yapılandırma dosyasına yazma.

Context7 nasıl kullanılır?

Kurduktan sonra isteğinin sonuna "use context7" yazarsın; asistan belgeyi çeker. Kütüphane kimliğini (örneğin /supabase/supabase) ya da sürümü yazarsan eşleme adımı atlanır ve istediğin sürümün belgesi gelir.

Güncel belge iste"Next.js 16'da proxy dosyasını nasıl kurarım? Örnek kodla anlat. use context7"

Kimlik ve sürüm belirt"Supabase ile e-posta girişi kur. use library /supabase/supabase for API and docs"

Terminalden belge sorgula (MCP kurmadan)› npx ctx7 library react "useEffect nasıl çalışır"

Kullandığın kütüphane dizinde yoksa context7.com/add-library adresinden public GitHub deposunu ekletebilirsin; hesap gerekir. Özel ya da dahili belge Pro ya da Enterprise plan ister.

Context7 hangi programlarda çalışır?

Claude CodeVar	Context7 belgesinde ayrı bölüm var (komut, eklenti ya da elle).
Claude DesktopVar	Uzak özel bağlayıcı, yerel yapılandırma dosyası ve .mcpb masaüstü eklentisi anlatılıyor.
claude.ai (web)Net değil	Context7 belgesinde ayrı bir web bölümü yok. Claude'un kendi belgesi özel bağlayıcıyı web'de de tanıyor; adres ve adımlar Claude Desktop ile aynı.
ChatGPTBeta	Developer Mode (beta) ile; Context7 belgesine göre Pro, Plus, Team, Enterprise ve Edu planlarında.
Codex, Cursor, VS Code, Gemini CLIVar	Belgede her biri için kurulum adımı var.
WindsurfNet değil	Belgede adı geçmiyor; genel MCP yönergesi geçerli olabilir ama resmî kaynakta net değil.

"Belgede yok" çalışmaz demek değildir. Liste Context7 belgelerindeki istemci sayfalarından derlendi.

Context7 neye erişir, hangi veri dışarı gider?

Dosyalarına erişir mi

Bilgisayarındaki dosyaları, kodunu ya da sohbet geçmişini okuyan bir araç belgede listelenmiyor. Yalnız iki araç var ve ikisi de belge getirir.

Dışarı giden veri

Asistanın oluşturduğu arama sorgusu ve kütüphane adı, API anahtarın (varsa), istemci adı ve sürümü gider; barındırılan sunucuda hız sınırı için şifreli bir IP bilgisi de eklenir. Tam isteminin, kaynak kodunun ve sohbet geçmişinin gitmediği yazıyor.

Saklama

Context7 kaynak dosyalarını saklamıyor; belge, kod örnekleri ve asistanın oluşturduğu sorguları saklıyor. API günlükleri 30 gün tutuluyor. Sorgular belgeleri sıralamak için OpenAI, Google Gemini ve Anthropic modellerine iletilebiliyor; Enterprise'da sorgu saklama kapatılabiliyor.

Belgeler topluluk katkılı

Dizindeki içerik topluluk katkılı; README doğruluk, bütünlük ya da güvenlik garantisi vermediğini yazıyor. Context7 şüpheli içerik için "Report" düğmesi sunuyor ve içerikte istem enjeksiyonu için sınıflandırıcı çalıştırdığını söylüyor.

Belge cevabı doğrudan asistanın bağlamına girer. Kullanıcıların bildirdiği GitHub'da Mayıs 2026'da bir cevaba belge dışı bir "sistem bildirimi" eklendiği bildirildi; geliştirici bunun giriş yönlendirmesi için resmî bir test olduğunu söyleyip kapattı (issue #2663). Asistanın getirdiği kurulum komutlarını çalıştırmadan önce oku. Bu bir güvenlik sertifikası değildir.

Context7 ücretsiz mi? Planlar ve API anahtarı

Evet, ücretsiz bir plan var. API anahtarı belgelerde "önerilir" diye geçiyor; zorunlu değil. Anahtarsız kullanımda hız sınırı daha düşük. Fiyatlar yalnız dolar olarak yayınlanıyor; TL fiyatı ve vergi bilgisi resmî sayfada yok.

Free0 $

Public depolar
Ayda 1.000 API çağrısı
Topluluk desteği
Özel depo
Takım işbirliği

Pro10 $ /koltuk/ay

Özel depolar, takım işbirliği
Koltuk başına ayda 2.000 çağrı dahil
Sonrası 1.000 çağrı için 5 $
SSO, kendi sunucuna kurma

EnterpriseÖzel

Pro'daki her şey
SSO, SOC-2, kendi sunucuna kurma
SLA'lı destek

Free planda aylık sınıra gelince çağrılar bloklanır; sayfa bloklu günlerde günde 20 bonus çağrı verildiğini yazıyor. Kullanımını context7.com/dashboard › Overview sekmesinde görürsün.

Yapabilirsin

MCP sunucusunun kaynak kodu MIT lisanslı: kullanmak, değiştirmek, dağıtmak serbest

Yasak

API arka ucu, ayrıştırma ve tarama motoru kapalı kaynak; hizmet kullanımı Context7'nin kullanım koşullarına bağlı

Kaynak: Context7 Plans sayfası ve README. Ticari kullanım için Context7'nin resmî kullanım koşullarını ve gizlilik metnini kendin oku. Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Hız sınırı hatası (429, "rate limit")	context7.com/dashboard adresinden ücretsiz API anahtarı al ve yapılandırmaya Authorization: Bearer başlığıyla ekle.
401 Unauthorized	Anahtarın "ctx7sk" ile başladığını ve başlığın "Authorization: Bearer …" biçiminde olduğunu kontrol et (yerel sunucuda `--api-key` argümanı).
Yerel npx sunucusu zaman aşımı ya da "module not found" veriyor	Resmî çözümler: uzak sunucuya geç (Node.js gerekmez), Windows'ta `cmd /c npx` kullan, komuta `@latest` ekle; Codex'te `startup_timeout_ms` değerini 40000 yap.
Kullanıcıların bildirdiği Claude Code eklentisi anahtarsız 401 veriyor	Geliştirici eklentinin eski sürümünde düzeltildiğini söyledi; eklentiyi güncelle. Eklenti anahtarı ortam değişkeninden okumaz, giriş `/mcp` ile tarayıcıda yapılır.
Kullanıcıların bildirdiği `npx ctx7 setup` "skill indirilemedi, GitHub API hatası" veriyor	Kullanıcılar ortamdaki GITHUB_TOKEN ya da GH_TOKEN değerinin süresinin dolmuş olduğunu bildirdi; yeni token ile geçti.

Context7 nasıl kaldırılır?

Hızlı kurulumu geri al: npx ctx7 remove (global kurduysan ayrıca npm uninstall -g ctx7).
Claude Code'da: claude mcp remove context7.
Claude Desktop'ta: Customize sonra Connectors altından bağlayıcıyı kaldır. ChatGPT'de oluşturduğun uygulamayı sil.
API anahtarını iptal et: context7.com/dashboard › API Keys kartından sil; anahtar anında etkisizleşir ve geri alınamaz.

Sık sorulan sorular

Context7 nedir, ne işe yarar?

Kod yazan yapay zekâ asistanına kullandığın kütüphanenin güncel ve sürüme özel belgesini ve kod örneğini getiren bir MCP sunucusu. Amacı asistanın eski bilgiyle yazdığı kodu azaltmak. Upstash geliştiriyor.

Context7 için API anahtarı almak zorunlu mu?

Hayır. README anahtarı "daha yüksek hız sınırları için önerilir" diye yazıyor. Anahtarsız kullanımda sınırlar daha düşük. Anahtarı context7.com/dashboard adresinden ücretsiz alırsın.

Context7 ücretsiz mi, limiti ne?

Ücretsiz plan var: ayda 1.000 API çağrısı. Sınıra gelince çağrılar bloklanır ve günde 20 bonus çağrı verilir. Pro koltuk başına ayda 10 dolar (2.000 çağrı dahil).

Context7 Claude Code'da nasıl kullanılır?

Kurduktan sonra isteğinin sonuna "use context7" yaz. Kurulum için claude mcp add komutuyla uzak sunucuyu ekle ya da npx ctx7 setup --claude komutunu çalıştır.

Context7 hangi veriyi dışarı gönderiyor, kodum gidiyor mu?

Asistanın oluşturduğu arama sorgusu ve kütüphane adı gider. Tam isteminin, kaynak kodunun ve sohbet geçmişinin gitmediği yazıyor. Sorgular belgeleri sıralamak için OpenAI, Google Gemini ve Anthropic modellerine iletilebiliyor.

Uzak mı yerel mi kurmalıyım?

Uzak sunucu bilgisayarda Node.js gerektirmez ve kurulumu kolaydır. Yerel paket (npx) Node.js 20.18.1 veya üstü ister ve Windows ile macOS'ta zaman aşımı sorunları bildirilmiş; belge sorun yaşarsan uzak sunucuya geçmeyi öneriyor.

Context7 hangi işlerde, hangi setlerde?

Claude Code ile başlangıç

İlgili rehberler

Supabase

Claude Plugins Official

21st MCP

ai-memory awwwards-animations

Brave Search MCP

Kaynaklar

Resmî kaynaklarda net olmayanlar: Anahtarsız kullanımın sayısal sınırı (resmî kaynak yazmıyor) · Context7 kullanım koşulları ve gizlilik metninin tam içeriği · TL fiyatı ve vergi · Windsurf'te çalıştığı · kayıtlı güvenlik uyarısı durumu. Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.