MCP sunucusu

Claude'a ya da başka bir MCP istemcisine sizin yerinize isim kontrol etme yeteneği verin. Sunucu sizin makinenizde çalışır, Namescope API'sine sizin anahtarınızla gider ve beş araç sunar.

Son güncelleme: 4 Eylül 2026

Nedir

Model Context Protocol, bir yapay zekâ asistanının kendi dışındaki araçlara ulaşma biçimidir. Namescope MCP sunucusu bunu konuşan küçük bir programdır: asistan isim kontrolü ister, sunucu sizin de çağıracağınız genel API'yi çağırır ve sonucu geri verir.

Kendine ait veri tutmaz. Kapsam, kredi ve hız limiti, doğrudan istekte olduğu gibi API tarafında uygulanır; yani sunucu, anahtarınızın yapamayacağı hiçbir şeyi yapamaz.

Kurulum

scans:read, scans:write ve reference:read kapsamlarına sahip bir API anahtarı gerekir. Ayarlar → API anahtarları altından oluşturun.

Claude Desktop — sunucuyu claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "namescope": {
      "command": "node",
      "args": ["/path/to/namescope/apps/mcp/dist/main.js"],
      "env": {
        "NAMESCOPE_API_KEY": "ns_live_...",
        "NAMESCOPE_API_URL": "https://api.namescope.dev"
      }
    }
  }
}

Claude Code — tek komut:

claude mcp add namescope \
  --env NAMESCOPE_API_KEY=ns_live_... \
  --env NAMESCOPE_API_URL=https://api.namescope.dev \
  -- node ./apps/mcp/dist/main.js

Araçlar

Araç	Ne yapar	Ücret
namescope_scan_name	Adı marka, domain, sosyal medya, geliştirici platformu ve uygulama mağazalarında kontrol eder	100 kredi
namescope_get_scan	Taramayı id ile okur, istenirse bitmesini bekler	ücretsiz
namescope_list_scans	Çalışma alanının son taramalarını listeler	ücretsiz
namescope_usage	Plan, kredi bakiyesi, limitler ve anahtarın kapsamları	ücretsiz
namescope_reference	Nice sınıfları, ofisler, TLD katmanları ya da adapter listesi	ücretsiz

Yalnız namescope_scan_name bir şey harcar ve yazma olarak işaretli tek araçtır; yazma işlemlerinden önce onay soran bir istemci, taramadan önce sorar.

Sonucu bekleme

Tarama zaman alır, araç çağrısı ise bir kez döner. namescope_scan_name varsayılan olarak scanId'yi hemen döndürür; asistan sonucu namescope_get_scan ile okur.

Sunucunun beklemesini istiyorsanız waitMs geçin: tarama bitene kadar yoklar — saniyede bir başlayıp beş saniyeye kadar genişleterek — ve sonucu satır içi döndürür. Süre dolarsa hata değil, kısmi tarama alırsınız; biten kontroller yine okumaya değer.

Değişken	Varsayılan	Anlamı
NAMESCOPE_API_KEY	—	Zorunlu. API anahtarınız
NAMESCOPE_API_URL	http://localhost:4000	API kökü
NAMESCOPE_MCP_MAX_WAIT_MS	120000	waitMs için üst sınır
NAMESCOPE_MCP_TIMEOUT_MS	30000	Tek HTTP isteği zaman aşımı

Kontrol isteme

Sunucu bağlandıktan sonra gündelik dille istersiniz; araçları asistan seçer. İyi bir istek sınıfları ya da pazarları adlandırır, çünkü gerçek bir çakışmayı ilgisiz bir markadan ayıran şey budur.

"Tion Studios" Türkiye ve AB'de bir oyun stüdyosu için
müsait mi — Nice sınıfları 9 ve 41.

Asistan tipik olarak sınıfları namescope_reference ile bakar, taramayı başlatır, bitmesini bekler ve adı neyin engellediğini, neyin engellemediğini özetler.

Bir şey ters gidince

API hataları çökme olarak değil, okunabilir araç hatası olarak döner; böylece asistan sorunu açıklayabilir ve elinden geliyorsa düzeltip yeniden deneyebilir.

401 — anahtar yok, tanınmıyor, iptal edilmiş ya da süresi dolmuş
402 — çalışma alanının planı API'yi içermiyor
403 — anahtarda kapsam eksik ya da kredi harcaması kapalı
429 — hız limiti ya da kredi bakiyesi aşıldı