🧩 Onysoft MCP Sunucusu

Claude Code, Claude Desktop ve Cursor gibi MCP host'larından katalog, fiyat, bakiye ve OnyRouter araçlarına erişin.

Onysoft, uzak (streamable HTTP) bir MCP sunucusu yayınlar. sk-ony API anahtarınızla bağlanan her MCP uyumlu uygulama; model kataloğunu güncel TL fiyatlarıyla sorgulayabilir, token maliyeti hesaplayabilir, bakiye ve kullanım özetinizi görebilir ve OnyRouter'dan model önerisi alabilir. Model çağrılarının kendisi /v1 ucundan yapılmaya devam eder — MCP araç katmanı, /v1 model katmanıdır.

Nasıl Çalışır?

MCP host'unuz (Claude Code, Claude Desktop, Cursor...) sunucuya üç adımda bağlanır: önce initialize ile protokol sürümü ve yetenekler el sıkışılır, ardından tools/list ile araç kataloğu çekilir, sonrasında model gerektiğinde tools/call ile aracı çağırır. Tüm bunlar sizin için otomatiktir — sunucuyu bir kez ekledikten sonra araçlar asistanınızın doğal yetenekleri gibi görünür.

Sunucu durumsuz (stateless) çalışır: oturum kimliği tutulmaz, her istek Authorization başlığıyla kendi başına doğrulanır. Her araç kendini ad + açıklama + JSON şema üçlüsüyle tanıttığı için model, hangi aracı hangi parametrelerle çağıracağına kendisi karar verir.

Kurulum

Claude Code (tek komut):

claude mcp add --transport http onysoft https://api.onysoft.com/mcp \
  --header "Authorization: Bearer sk-ony-your-api-key"

Claude Desktop / Cursor (JSON yapılandırma):

{
  "mcpServers": {
    "onysoft": {
      "type": "http",
      "url": "https://api.onysoft.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-ony-your-api-key"
      }
    }
  }
}

Araçlar

Claude Desktop yapılandırma dosyası: macOS'te ~/Library/Application Support/Claude/claude_desktop_config.json, Windows'ta %APPDATA%\Claude\claude_desktop_config.json. Cursor'da: Settings → MCP → Add Server. Anahtarınızı sadece kendi cihazınızdaki yapılandırmaya yazın; paylaşılan makinelerde ayrı bir sk-ony anahtarı oluşturmanız önerilir.

Örnek: Token Maliyeti Hesabı

Asistanınıza "10 bin girdi, 2 bin çıktı tokenlık bir iş GPT-5.6 Luna'da kaça mal olur?" diye sorduğunuzda host, calculate_cost aracını şu parametrelerle çağırır ve yapılandırılmış yanıtı alır:

// istek (host otomatik gönderir)
{ "name": "calculate_cost",
  "arguments": { "model": "openai/gpt-5.6-luna", "input_tokens": 10000, "output_tokens": 2000 } }

// structuredContent yanıtı
{
  "model": "openai/gpt-5.6-luna",
  "girdi_token": 10000,
  "cikti_token": 2000,
  "maliyet_usd": 0.00264,
  "maliyet_tl": 0.1256,
  "tcmb_usd_try": 47.5736,
  "olcum": "2026-08-06T03:24:03+03:00",
  "kaynak": "api.onysoft.com canlı katalog"
}

Örnek: OnyRouter ile Model Önerisi

"Bu Python kodundaki hatayı bulacağım, hangi modeli kullanmalıyım?" tarzı bir soruda onyrouter_route aracı görev metnini sınıflandırıp öneri döndürür:

{
  "onerilen_model": "anthropic/claude-sonnet-5",
  "kategori": "kod",
  "kaynak_katman": "classifier",
  "not": "Bu modeli /v1/chat/completions çağrısında model alanında kullanın..."
}

Ham JSON-RPC ile Test (curl)

Sunucuyu bir MCP host'u olmadan, doğrudan curl ile de deneyebilirsiniz — tek uç, standart JSON-RPC 2.0:

curl https://api.onysoft.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-ony-your-api-key" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "calculate_cost",
      "arguments": { "model": "openai/gpt-5.6-luna", "input_tokens": 10000, "output_tokens": 2000 }
    }
  }'

Asistanınıza Ne Sorabilirsiniz?

Sunucu ekliyken şu tür sorular otomatik olarak Onysoft araçlarına yönlenir:

• "Onysoft'ta bakiyem ne kadar?" → get_balance
• "Claude Sonnet 5'in güncel TL fiyatı ne?" → get_model_price
• "Günde 1.000 istek atan chatbot Luna ile ayda kaça mal olur?" → calculate_cost
• "Son 30 günde hangi modelleri ne kadar kullanmışım?" → get_usage_summary
• "Uzun doküman analizi için hangi modeli seçmeliyim?" → onyrouter_route

Hata Kodları

Limitler ve Notlar

• Hız limiti: anahtar başına dakikada 60 MCP çağrısı.
• Tüm araçlar okuma amaçlıdır; bakiyenizden harcama yapmazlar. Fiyat çıktılarında ölçüm zamanı döner.
• Model üretimi (chat/completions) MCP aracı DEĞİLDİR — modele gidecek istekleri /v1 ucundan atarsınız.

MCP kavramını baştan öğrenmek için rehberimiz: MCP Nedir?