MCP sunucusu

Model Context Protocol (MCP), bir yapay zekâ asistanının dış araçları çağırmasını sağlayan açık bir standarttır. Rixe bir MCP sunucusu çalıştırır; böylece Claude Desktop ya da Cursor gibi bir asistan "Perplexity'de hangi sorularda görünmüyoruz?" gibi soruları, panoyu açmanıza gerek kalmadan, zaten çalıştığınız yerde canlı Rixe verinizle yanıtlayabilir.

Sunucu, REST API ile aynı API anahtarlarını ve kapsamları kullanır. Her araç kendi kapsamını ister; böylece bir anahtarı asistanın tam olarak görmesi gerekenle sınırlayabilirsiniz.

#Nerede bulunur

Kenar çubuğunun altındaki kullanıcı menüsünü açıp Ayarlar › Geliştirici bölümüne gidin. MCP sunucusu kartında Sunucu adresi, bir İstemci yapılandırması (Claude Desktop / Cursor) örneği, bir Hızlı deneme komutu ve araç listesi bulunur; her birinin yanında Kopyala düğmesi vardır.

MCP erişimi "REST API + MCP" özelliğiyle gelir: API anahtarı oluşturabilen bir paket gerekir. Ayrıntılar: Paketler ve limitler.

#Kurulum

1. Ayarlar › Geliştirici › API anahtarları bölümünde API anahtarı ekle'ye tıklayın, bir ad verin (örneğin "Claude Desktop") ve kullanmak istediğiniz araçların kapsamlarını işaretleyin (aşağıdaki tabloya bakın). Anahtar üret'e tıklayıp anahtarı kopyalayın; yalnızca bir kez gösterilir.
2. MCP sunucusu kartındaki İstemci yapılandırması örneğini istemcinizin MCP yapılandırmasına kopyalayın. Claude Desktop için bu dosya claude_desktop_config.json, Cursor için MCP ayar dosyasıdır.
3. rixe_… yerine kendi anahtarınızı yazın ve istemciyi yeniden başlatın.

Örnek, npx ile çalışan mcp-remote köprüsünü kullanır (bilgisayarınızda Node.js kurulu olmalıdır):

{
  "mcpServers": {
    "rixe": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.rixe.ai/mcp",
        "--header",
        "Authorization: Bearer ${RIXE_API_KEY}"
      ],
      "env": { "RIXE_API_KEY": "rixe_ANAHTARINIZ" }
    }
  }
}

4. Asistana "Rixe'yi kullanarak çalışma alanlarımı listele ve ilkinin görünürlüğünü özetle." gibi bir şey sorun. Önce calisma_alanlari, sonra gorunurluk_ozeti aracını çağırması gerekir.

#Komut satırından hızlı deneme

curl -s https://api.rixe.ai/mcp \
  -H 'Authorization: Bearer rixe_ANAHTARINIZ' -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Çalışan bir anahtar {"jsonrpc":"2.0","id":1,"result":{"tools":[…]}} döner.

#Araçlar

Araç adları sabit kimliklerdir. Asistan her aracın İngilizce açıklamasını okuyup doğru olanı kendisi seçer. calisma_alanlari dışındaki her araç bir workspaceId ister. days alan araçlarda varsayılan pencere 30 gün, en fazlası 180 gündür.

#Bir aracı doğrudan çağırmak

Sunucu initialize, ping, tools/list ve tools/call MCP yöntemlerine cevap verir. Bir aracın sonucu, içinde JSON bulunan tek bir metin bloğudur:

curl -s https://api.rixe.ai/mcp \
  -H 'Authorization: Bearer rixe_ANAHTARINIZ' -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"calisma_alanlari","arguments":{}}}'

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[\n  {\n    \"id\": \"9b1f6c2e-4d1a-4f0e-8a51-2f3c7d9e1a10\",\n    \"name\": \"FlowCRM – US\"\n  }\n]"
      }
    ]
  }
}

#Hatalar

• Anahtar yok ya da iptal edilmiş: HTTP isteğinin kendisi, JSON-RPC cevabından önce 401 ile başarısız olur.
• Eksik kapsam, bilinmeyen araç ya da eksik argüman: HTTP durumu 200 olur ve cevapta -32603 kodlu bir JSON-RPC hatası bulunur; örneğin This API key is missing the "read:actions" scope ya da query is required. Anahtarın kullanabildiği araçlar çalışmaya devam eder; yalnızca o çağrı başarısız olur.

#Sınırlar ve bilinmesi gerekenler

• Sunucu durumsuzdur: oturum, akış (streaming) ya da sunucunun başlattığı mesaj yoktur. Her çağrı tek bir istek ve cevaptır.
• API ile aynı istek sınırını paylaşır: dakikada 1.200 istek.
• Veri uygulamadakiyle aynıdır: skorlar günlük ölçümü izler ve 4'ten az ölçüme dayanan bir oran sayı olarak değil, yetersiz veri olarak işaretlenir.
• MCP, asistan dışında salt okunurdur; asistan da para harcar ama verinizi değiştirmez.

#İlgili sayfalar

• REST API: anahtarlar, kapsamlar ve istek sınırı ayrıntılarıyla.
• Asistan
• Marka kiti ve bilgi tabanı
• Aksiyon planı