İki HuMetric MCP Sunucusu: Hangisi Neyi Yapar, Nasıl Kurulur

Bir bayi ziyaret notunu okurken aklınıza "bu bayinin ödeme disiplini son üç ayda nereye gitti?" sorusu geliyor. Cevap HuMetric'te duruyor, ama araya tarayıcı, sekme, panel, filtre giriyor. Soruyu sorduğunuz yerle cevabın durduğu yer arasındaki mesafe, çoğu zaman sorunun kendisinden büyük.

MCP tam olarak bu mesafeyi kapatıyor.

MCP ne yapıyor

MCP, bir asistana — Claude, Cursor, ya da MCP konuşan başka bir araca — "şu işleri yapabilirsin" demenin standart yolu. Kurduktan sonra komut ezberlemiyorsunuz; düz cümleyle yazıyorsunuz, hangi aracın çağrılacağına asistan kendi karar veriyor.

"Bu ziyaret notunu sinyal olarak gönder, sonra bayinin ödeme disiplinini söyle" dediğinizde arka planda birkaç araç sırayla çalışıyor: not motora gidiyor, işleme arka planda devam ediyor, bitince metrik okunuyor. Siz bu sıralamayı bilmek zorunda değilsiniz.

İki sunucu, iki iş

HuMetric'in iki ayrı MCP sunucusu var ve karıştırılmaları en sık yapılan hata. Ayrım şu tek cümlede duruyor: site üretir, motor çalıştırır.

Motor MCP'si ince bir istemci: HuMetric API'sinin önünde durur, okur ve yazar. Site MCP'si ajanları açar — bir açıklamadan Metrik Paketi tasarlayan ajanı ve yapıştırdığınız metni bir sinyal yükleme planına çeviren ajanı.

İkisi birbirini tamamlıyor: paketi site tarafında ürettirir, çıkan YAML'ı motor tarafında yayınlarsınız.

Anahtarları nereden alırsınız

İki anahtar farklı yerlerden gelir ve birbirinin yerine geçmez. Yanlış olanı verirseniz sunucu sizi tanımaz.

Motor anahtarı (hm_live_…) — panelde Ayarlar → API Anahtarları. Yeni bir anahtar oluşturun, adını verin. Anahtar yalnızca oluşturulduğu anda bir kez gösterilir; kaybederseniz yenisini üretmek gerekir.

Motor tarafı için gereken tek şey bu. Kaydolduğunuzda motor hesabınız zaten açılıyor, modeli platform karşılıyor: kendi sağlayıcı anahtarınızı girmeden paket yayınlayabilir, sinyal gönderebilir, metrik ve kanıt okuyabilirsiniz. Ücretsiz kullanım sınırı 10.000 sinyal, 50 varlık ve 3 pack.

Site anahtarı (hms_live_…) — panelde MCP sunucusu bölümü, oradaki MCP anahtarları kutusunda Yeni anahtar. Bu da bir kez gösterilir, ama küçük bir kolaylık var: anahtarı ürettiğiniz anda hemen altındaki "Bir istemci bağla" kutusuna otomatik yerleşiyor — bağlanma komutunu anahtar dolu hâlde kopyalayabiliyorsunuz.

Site MCP'sinin bir farkı daha var: ajanları sizin kendi sağlayıcı anahtarınız çalıştırıyor. Pack Wizard ve Sinyal Agent, HuMetric'in işlettiği bir modelde değil, panelde tanımladığınız sağlayıcıda koşuyor. Anahtar tanımlı değilse bu iki araç çalışmaz — panel de sizi bu konuda uyarır. Motor tarafı için böyle bir şart yok.

Şu an ödeme yok. Panelde bir kredi bakiyesi göreceksiniz; kayıt olduğunuzda otomatik yükleniyor ve her işlem oradan düşüyor. Ödeme altyapısını henüz açmadık, yani bakiyeniz bittiğinde bize yazmanız yeterli — ücretsiz yüklüyoruz. Bu kredi zaten model maliyeti değil (o kendi sağlayıcı faturanıza gidiyor), işlem başına sabit bir platform ücreti; ileride ücretlendirilecek, bugün değil.

Nasıl bağlanır

Motor sunucusu, kendi makinenizde çalışır:

claude mcp add humetric --scope user \
  --env HUMETRIC_MCP_API_KEY=hm_live_anahtariniz \
  --env HUMETRIC_BASE_URL=https://api.gethumetric.com \
  -- uvx --from git+https://github.com/bestekarx/humetric.git humetric-mcp

--scope user sunucuyu bütün projelerde açık hâle getirir ve anahtarınızı hiçbir depoya sokmaz. Kurulum yok, klonlama yok — uvx sunucuyu izole bir ortamda kendisi kurup çalıştırıyor.

Site sunucusu uzakta çalıştığı için kurulum yerine tek bir adres ve başlık yetiyor:

claude mcp add --transport http humetric-site https://gethumetric.com/mcp \
  --scope user \
  --header "Authorization: Bearer hms_live_anahtariniz"

İkisini de ekledikten sonra claude mcp list çalıştırın; iki satırın da ✔ Connected demesi gerekiyor. Yeni sunucular yalnızca yeni bir oturumda görünür — açık oturum eskisini görmeye devam eder.

Claude Desktop, Cursor ve VS Code için yapılandırma blokları dokümanların MCP bölümünde. Orada en sık karşılaşılan sorun da yazılı: masaüstü uygulamaları sunucuyu kabuğunuzun PATH'i olmadan başlattığı için uvx bulunamayabiliyor; which uvx çıktısındaki tam yolu yazmak çözüyor.

Ne yapabilirsiniz

Bağlandıktan sonra iş, cümle kurmaya dönüyor:

Hangi metrik paketleri var?
D-1042 bayisinin metriklerini göster.
odeme_disiplini neden -0.55? Hangi notlar bunu etkiledi?
Bayileri ödeme disiplinine göre sırala.
Şu ziyaret notunu D-1042'ye sinyal olarak gönder: <metin>
Bu ay ne kadar kullanmışım?

Bilmeniz gereken tek mekanik ayrıntı: sinyal gönderdiğinizde metrik hemen hazır olmaz. Not sıraya girer, işleme arka planda devam eder, birkaç saniye sonra biter. Sunucu asistana bunu söylüyor: metrikleri okumadan önce işin bittiğini doğrula. "Gönder ve sonra metrikleri göster" derseniz bu bekleme kendiliğinden oluyor.

Uçtan uca tipik akış iki sunucuyu da kullanıyor:

1. Site MCP — "Otel yorumları için bir paket hazırlamak istiyorum." Sihirbaz sorular sorar, siz cevaplarsınız, elinize geçerli bir paket YAML'ı geçer.
2. Motor MCP — "Bu paketi yayınla."
3. Motor MCP — "Şu 20 yorumu sinyal olarak gönder."
4. Motor MCP — "En güvenilir yorumcu kim?"
5. Motor MCP — "Neden o? Kanıtı göster."

Son adım yazının asıl noktası: HuMetric size sayıyı verirken sayının dayandığı cümleyi de veriyor. "−0.55" tek başına tartışılabilir bir şey değil; "Son iki faturayı da vadesinden sonra ödedi" cümlesiyle birlikte gelince tartışılacak bir şey kalmıyor.

Karıştırmayın

İki anahtar farklı. hm_live_ motorun, hms_live_ sitenin. Birini diğerinin yerine koyarsanız sunucu sizi tanımaz.

Araç adları benziyor, sunucular ayrı. İkisinin de araçları humetric_ ile başlıyor ama istemci onları sunucu adıyla ayırıyor — çakışma olmuyor.

Hassas metrikler rıza olmadan üretilmiyor. Pakette hassas olarak işaretlenmiş bir metrik, o varlık için açık rıza yoksa hiç var olmuyor: üstü çizili bir değer, gizlenmiş bir kayıt değil — o metrik hiç yazılmıyor. Gönderdiğiniz ham sinyal metni saklanıyor, ama rızasız hassas metrik üretilmiyor. Asistan sizin adınıza rıza da vermiyor; rıza veri sahibinin beyanıdır, asistanın varsayımı değil.

Neden buna değiyor

Panel, veriye bakmak için iyi bir yer. Ama bir soru genellikle bir başkasını doğuruyor — "neden düştü", "hangi not", "diğer bayilerde de var mı" — ve her biri için tarayıcıya dönmek düşünceyi kesiyor.

MCP ile tanımdan kanıta kadar bütün zincir yazdığınız yerde kalıyor: paketi bir cümleyle ürettiriyor, sinyali oradan gönderiyor, sayıyı oradan okuyor, "neden" sorusunu da orada soruyorsunuz. Değişen şey HuMetric'in ne yaptığı değil; ona ulaşmak için ödediğiniz bedel.

# özet: iki komut
claude mcp add humetric --scope user \
  --env HUMETRIC_MCP_API_KEY=hm_live_anahtariniz \
  --env HUMETRIC_BASE_URL=https://api.gethumetric.com \
  -- uvx --from git+https://github.com/bestekarx/humetric.git humetric-mcp

claude mcp add --transport http humetric-site https://gethumetric.com/mcp \
  --scope user \
  --header "Authorization: Bearer hms_live_anahtariniz"

claude mcp list   # ikisi de ✔ Connected demeli