Yapay zekâ asistanları ve geliştiriciler için

Yapay zekâ asistanınızla 50heads kullanın.

Uyumlu bir yapay zekâ asistanını 50heads ile bağlayın; asistan gerçek kişilere soru sorsun ve sonucu alsın. Kurulumu yaklaşık on dakika sürer ve yanıt başına $0,25 ile başlar. MCP üzerinden çalışır; MCP, bir asistanın dış araçları kullanmasını sağlayan standarttır. Bu yüzden Claude, Cursor, ChatGPT ve MCP destekleyen her uygulamada çalışır.

Uygulamanıza ekleyin

Claude

Claude içinde Ayarlar bölümünü, sonra Bağlayıcılar bölümünü açın ve bu URL ile özel bir bağlayıcı ekleyin. Giriş yapıp günlük harcama limiti belirleyeceksiniz.

https://mcp.50heads.com/mcp

Claude Code

Bunu bir terminalde çalıştırın. Claude Code, giriş yapmanız ve günlük harcama limiti belirlemeniz için bir tarayıcı açar.

claude mcp add --transport http 50heads https://mcp.50heads.com/mcp

Cursor

Bunu ~/.cursor/mcp.json dosyasına ekleyin, ardından Cursor isteyince giriş yapın.

{
  "mcpServers": {
    "50heads": {
      "url": "https://mcp.50heads.com/mcp"
    }
  }
}

ChatGPT

ChatGPT içinde Ayarlar, sonra Uygulamalar ve bağlayıcılar, sonra Gelişmiş ayarlar bölümünü açın ve Geliştirici modunu açın. Oluştur seçeneğini seçin, bu URL adresini yapıştırın ve kimlik doğrulama olarak OAuth seçin.

https://mcp.50heads.com/mcp

VS Code

Bunu çalışma alanınızdaki .vscode/mcp.json dosyasına ekleyin ya da MCP: Add Server komutunu çalıştırın. VS Code giriş sayfasını açar.

{
  "servers": {
    "50heads": {
      "type": "http",
      "url": "https://mcp.50heads.com/mcp"
    }
  }
}

Windsurf

Bunu ~/.codeium/windsurf/mcp_config.json dosyasına ekleyin; portaldan aldığınız bir API anahtarı da gerekir.

{
  "mcpServers": {
    "50heads": {
      "command": "npx",
      "args": [
        "-y",
        "@50heads/mcp"
      ],
      "env": {
        "FIFTYHEADS_API_KEY": "fh_live_…"
      }
    }
  }
}

Diğer (npx)

Yerel bir komut başlatan uygulamalar için. Node 20 veya üstü ve portaldan alınmış bir API anahtarı gerekir.

FIFTYHEADS_API_KEY=fh_live_… npx -y @50heads/mcp

Temel akış üç adımdır

Tahmin ücretsizdir ve hiçbir zaman harcama yapmaz. Sorma, kredileri ayırır. Sonuçları bekleme: bekleme işini 50heads üstlenir, böylece asistanınız tekrar tekrar kontrol etmek yerine tek bir çağrı yapar.

> estimate({ type: "single_choice", text: "Which menu would you order from tonight?",
             options: [{ label: "Menu A" }, { label: "Menu B" }], n: 50, tier: 1 })
  20 credits × 50 = 1000 credits · eta 10 min

> ask({ ...same question, idempotency_key: "4f9c…" })
  task q_8k2f · working · 0 of 50 answered

> get_results("q_8k2f")        # or wait_for_results on older hosts
  complete · winner "Menu B" · margin 36 points · confidence high

Kullanılabilir araçlar

estimate
Bir soru için fiyat, süre ve doğrulama. Hiçbir zaman harcama yapmaz.
ask
Bir soru yayınlar. Bir idempotency anahtarı gerekir: aynı anahtarla yeniden denemek ikinci bir soru ya da ikinci bir ücret oluşturamaz.
get_results
Şu ana kadarki sonuçlar, beklemeden.
wait_for_results
Soru yanıtlanana kadar bizim tarafımızda bekler; istemcinin sürekli kontrol etmesi gerekmez.
list_questions
Son sorular; bir ajan yeniden sormadan önce bir sonucu yeniden kullanabilsin diye.
cancel
Yayındaki bir soruyu durdurur ve verilmeyen yanıtların ücretini iade eder.
templates
Sabit fiyatlı soru şablonları.
balance
Krediler ve bağlantının günlük limitinden kalan tutar.

Gözetimsiz kullanım için kontroller

  • Her bağlantının günlük bir harcama limiti vardır; siz değiştirmedikçe 5.000 kredi. Sunucu, bu limiti aşacak bir soruyu reddeder.
  • Sorma işlemi bir idempotency anahtarı gerektirir. Aynı anahtarla yeniden denemek ikinci bir soru ya da ikinci bir ücret oluşturamaz.
  • Sorular, herkesin soruları gibi aynı içerik kurallarından geçer. Reddedilen bir soru size hiçbir şeye mal olmaz.
  • Sonuçlar hiçbir zaman bir head'i tanımlamaz.

Ya da API'yi çağırın

MCP sunucusunun yaptığı her şey düz bir HTTPS çağrısıdır. Anahtarlar fh_live_ ile başlar ve bir kez gösterilir.

curl https://api.50heads.com/v1/billing/estimate \
  -H "Content-Type: application/json" \
  -d '{"draft":{"type":"single_choice","text":"Which menu would you order from tonight?",
       "options":[{"label":"Menu A"},{"label":"Menu B"}],"n":50,"tier":1}}'

curl https://api.50heads.com/v2/questions \
  -H "Authorization: Bearer $FIFTYHEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"draft":{"type":"single_choice","text":"Which menu would you order from tonight?",
       "options":[{"label":"Menu A"},{"label":"Menu B"}],"n":50,"tier":1,"language":"en"}}'

curl "https://api.50heads.com/v2/questions/q_8k2f/wait?seconds=25" \
  -H "Authorization: Bearer $FIFTYHEADS_API_KEY"

Yapay zekâ asistanınız gerçek kişilere sorsun.

Klavye kısayolları

Bunları görmek için herhangi bir sayfada ? tuşuna basın. Bir kutuya yazarken kapalıdırlar.

Genel

Klavye kısayollarını göster
?
Yardımda ara
/
Soru sorun
n
Menüleri kapat
Esc

Git

Ana sayfa
gsonrah
Fiyatlar
gsonrap
Nasıl çalışır
gsonraw
Nasıl doğruluyoruz
gsonrav
Yapay zekâ ajanları için
gsonraa
Ekipler için
gsonrat
Kazanın
gsonrae
Blog
gsonrab
API belgeleri
gsonrad
Hesabınız
gsonrao