Drop in — OpenAI ve MCP

İki giriş yolu

Halihazırda OpenAI-tabanlı bir uygulaman varsa, Moonborn'a geçmek tek satırlık bir değişiklik. Claude ya da Model Context Protocol konuşan agent framework'leriyle inşa ediyorsan, Moonborn personalarını MCP kaynakları olarak aç.

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

Drop in — OpenAI-uyumlu

Moonborn OpenAI-uyumlu bir chat/completions endpoint'i barındırır. Model adı persona ID'sidir; her şey (streaming, tool use, function calling) değişmeden geçer.

import OpenAI from 'openai';
 
const client = new OpenAI({
 apiKey: process.env.MOONBORN_API_KEY,
 baseURL: 'https://api.moonborn.co/v1/openai',
});
 
const response = await client.chat.completions.create({
 model: 'persona://persona_mert_abc123',
 messages: [{ role: 'user', content: 'What drives you?' }],
});
 
console.log(response.choices[0].message.content);

Değişen:

• Base URL — https://api.moonborn.co/v1/openai.
• API anahtar env var'ı — MOONBORN_API_KEY.
• Model alanı — gpt-4 yerine persona://<persona_id>.

Aynı kalan:

• Streaming ve non-streaming ikisi de destekli.
• Tool calling ve function calling değişmeden geçer.
• GET /v1/models workspace personalarını model olarak listeler.
• Rate-limit header'ları, token sayımları ve hata şekilleri OpenAI konvansiyonlarına uyar.

Moonborn'a özgü metadata (drift skoru, katman atfı) x-moonborn-* yanıt header'larında gelir — OpenAI client'ları tarafından güvenle yok sayılır.

Uyumlu olmayan: görsel üretimi, embedding'ler, ses. Bunlar Moonborn'un alanı değil — bu işler için OpenAI client'ını yan yana tut. Daha fazla OpenAI-uyumlu sayfasında.

MCP — kaynak olarak personalar

Moonborn https://api.moonborn.co/v1/mcp adresinde bir Model Context Protocol server'ı açar. Her persona bir MCP resource'tur (sistem prompt'u, voice fingerprint, DNA client'a açıktır). Bir chat tool'u persona-kapsamlı bir sohbet oturumu başlatır.

Tipik client config'i (VS Code için Claude, Cursor, JetBrains veya MCP-uyumlu bir agent host):

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

MCP server ne içindir:

• IDE entegrasyonları — VS Code, Cursor veya JetBrains'teki Claude'un kod inceleme, marka-sesi yazımı veya kurgusal karakter roleplay'i için persona bağlamı çekmesi.
• Agent framework host'ları — MCP konuşan ve persona kaynak havuzu isteyen LangChain, LlamaIndex, Anthropic Managed Agents.

MCP server'ın olmadığı şey: genel bir LLM router, tam bir agent host veya chat completions endpoint'inin yerine geçen bir alternatif. MCP client'lara persona sunar. Kapsam bu.

Hangisini ne zaman kullan

Tier

OpenAI-uyumlu: Free tier ve üzeri. MCP server: Team tier ve üzeri.

Sonraki

• Tam entegrasyon sayfası için OpenAI-uyumlu sayfasını oku.
• SDK'lar sayfasından SDK'lara göz at.
• API reference üzerinde referans dökümanlar.