Drop-in — OpenAI ve MCP

Halihazırda OpenAI SDK üzerinden çalışan bir uygulaman varsa, Moonborn'a geçiş tek satırlık değişikliktir. Claude Desktop, Cursor veya Model Context Protocol (MCP) konuşan agent çatılarıyla inşa ediyorsan, Moonborn persona'larını MCP kaynakları olarak aç.

İki yol da birinci sınıftır. Mevcut bağlantına uyanı seç.

Bu kullanım senaryosu sana uyar mı?

• Mevcut OpenAI SDK entegrasyonun var, kodu yeniden yazmadan persona getirmek istiyorsun
• IDE / agent çatısı (Claude Desktop, Cursor, LangChain MCP) entegrasyonu lazım
• Yerel REST API'ye geçmeden hızlıca Moonborn'u denemek istiyorsun

Yol 1 — OpenAI uyumlu (drop-in)

Moonborn OpenAI uyumlu bir chat/completions uç noktası barındırır. Model adı persona kimliğidir; geri kalan (akış, araç kullanımı, fonksiyon çağrısı) değişmeden geçer.

import OpenAI from 'openai';
 
const client = new OpenAI({
  apiKey: process.env.MOONBORN_API_KEY,           // ① ortam değişkeni değişir
  baseURL: 'https://api.moonborn.co/v1/openai',   // ② temel URL değişir
});
 
const response = await client.chat.completions.create({
  model: 'persona://per_mert_01H...',             // ③ model → persona kimliği
  messages: [{ role: 'user', content: 'Beni tetikleyen şey ne?' }],
});
 
console.log(response.choices[0].message.content);

Değişen 3 şey

• Ortam değişkeni — OPENAI_API_KEY → MOONBORN_API_KEY
• Temel URL — https://api.moonborn.co/v1/openai
• Model alanı — gpt-4 → persona://<persona_id>

Aynı kalanlar

• Akış + akışsız
• Araç çağrısı + fonksiyon çağrısı
• GET /v1/models (çalışma alanı persona'larını model olarak listeler)
• Hız limiti başlıkları, token sayımı, hata şekilleri OpenAI standardı

Moonborn'a özgü üstveri (drift skoru, katman atfı) x-moonborn-* yanıt başlıklarındadır — OpenAI istemcileri güvenle yok sayar; istersen ayrıştırabilirsin.

Uyumsuz olanlar

• Görsel üretimi, embeddings, ses (TTS / STT) — bunlar Moonborn'un alanı değildir. OpenAI istemcisini yan yana tut; persona-bağlı sohbet için Moonborn, görsel / vektör için OpenAI yerel.

Detay: OpenAI uyumlu.

Yol 2 — MCP sunucusu

Moonborn https://api.moonborn.co/v1/mcp adresinde bir Model Context Protocol sunucusu açar. Her persona bir MCP kaynağıdır; bir chat aracı (tool) persona kapsamlı oturum başlatır.

{
  "mcpServers": {
    "moonborn": {
      "transport": "https",
      "url": "https://api.moonborn.co/v1/mcp",
      "headers": { "Authorization": "Bearer ${MOONBORN_API_KEY}" }
    }
  }
}

MCP ne içindir

• IDE entegrasyonları — Claude Desktop, Cursor, JetBrains MCP eklentisi
• Agent çatı sahipleri (hosts) — MCP konuşan LangChain, LlamaIndex, Anthropic Managed Agents
• Okuma + sohbet yüzeyi — persona listeleme, persona detayı, sohbet çağrısı

MCP ne değildir

• Genel LLM yönlendiricisi (router) değildir
• Tam agent sahibi (host) değildir
• Sohbet tamamlama uç noktasının alternatifi değildir — MCP istemcilere persona sunar; sohbet akışı moonborn.chat aracından gelir

Detay: MCP sunucusu.

Hangisini ne zaman?

Geçiş anlatımı — OpenAI'dan Moonborn'a

1. OPENAI_API_KEY → MOONBORN_API_KEY yeniden adlandır
2. Temel URL güncelle → https://api.moonborn.co/v1/openai
3. Model kimliklerini persona kimliklerine eşle
   - Eşleme tablosunu uygulama yapılandırmasına koy
4. Sandbox çalışma alanında test et (sk_test_*)
5. Drift zarfını arayüze (isteğe bağlı) bağla
6. Üretime dağıt

Detay: OpenAI uyumlu geçiş.

Plan gereksinimi

OpenAI uyumlu her plan'da; MCP Team ve üzeri.

Dürüst kapsam

İlgili