MCP sunucusu
Claude'a ya da başka bir MCP istemcisine sizin yerinize isim kontrol etme yeteneği verin. Sunucu sizin makinenizde çalışır, Namesight API'sine sizin anahtarınızla gider ve beş araç sunar.
Son güncelleme: 6 Eylül 2026
Nedir
Model Context Protocol, bir yapay zekâ asistanının kendi dışındaki araçlara ulaşma biçimidir. Namesight 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": {
"namesight": {
"command": "node",
"args": ["/path/to/namesight/apps/mcp/dist/main.js"],
"env": {
"NAMESIGHT_API_KEY": "ns_live_...",
"NAMESIGHT_API_URL": "https://api.namesight.app"
}
}
}
}Claude Code — tek komut:
claude mcp add namesight \
--env NAMESIGHT_API_KEY=ns_live_... \
--env NAMESIGHT_API_URL=https://api.namesight.app \
-- node ./apps/mcp/dist/main.jsAraçlar
| Araç | Ne yapar | Ücret |
|---|---|---|
| namesight_scan_name | Adı marka, domain, sosyal medya, geliştirici platformu ve uygulama mağazalarında kontrol eder | modüle göre 100 krediye kadar |
| namesight_get_scan | Taramayı id ile okur, istenirse bitmesini bekler | ücretsiz |
| namesight_list_scans | Çalışma alanının son taramalarını listeler | ücretsiz |
| namesight_usage | Plan, kredi bakiyesi, limitler ve anahtarın kapsamları | ücretsiz |
| namesight_reference | Nice sınıfları, ofisler, TLD katmanları ya da adapter listesi | ücretsiz |
| namesight_rescan | Taramayı aynı ayarlarla yeniden çalıştırır | tarama gibi fiyatlanır |
| namesight_retry_unknowns | Yalnız doğrulanamayan kontrolleri yeniden dener | ücretsiz |
| namesight_delete_scan | Taramayı siler; yıkıcı işaretli, istemci önce onay ister | ücretsiz |
| namesight_share_report | Rapor için herkese açık link üretir (reports:write) | ücretsiz |
| namesight_list_projects | Çalışma alanının projelerini listeler (projects:read) | ücretsiz |
| namesight_generate_names | Brief, tohum ya da temadan isim fikri önerir (ideas:write) | ücretsiz |
Yalnız namesight_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.
Kaynaklar ve prompt
Referans listeleri kaynak olarak da sunulur — namesight://reference/nice-classes, regions, tlds ve adapters — böylece istemci her seferinde araç çağrısı harcamak yerine bunları konuşmaya bir kez ekler. check_brand_name prompt'u hazır bir brief'tir: ismi tara, doğrulanamayanları yeniden dene, sonucu açıkla ve isim doluysa alternatif öner.
Her araç bir çıktı şeması bildirir; list_scans cursor ve status ile sayfalar. Bağlantı koptuktan sonra yeniden denemek güvenlidir: sunucu iki kez ücret almak yerine ilk cevabı yineler.
Sonucu bekleme
Tarama zaman alır, araç çağrısı ise bir kez döner. namesight_scan_name varsayılan olarak scanId'yi hemen döndürür; asistan sonucu namesight_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ı |
|---|---|---|
| NAMESIGHT_API_KEY | — | Zorunlu. API anahtarınız |
| NAMESIGHT_API_URL | http://localhost:4000 | API kökü |
| NAMESIGHT_MCP_MAX_WAIT_MS | 120000 | waitMs için üst sınır |
| NAMESIGHT_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.
"Lumina Labs" 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ı namesight_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ı