MCP sunucusu

Model Context Protocol (MCP — Model Bağlam Protokolü), Anthropic'in LLM ↔ araç birlikte çalışma standardıdır. Moonborn https://api.moonborn.co/v1/mcp adresinde bir MCP sunucusu gönderir; MCP uyumlu herhangi bir istemci (Claude Desktop, Cursor, JetBrains MCP eklentisi, LangChain, LlamaIndex) çalışma alanındaki persona'ları kaynak (resource) olarak listeleyebilir ve sohbet oturumlarını araç (tool) olarak çağırabilir.

Yani: IDE / agent içinde "bana Moonborn'daki Mert persona'sıyla konuşur musun?" diyebilirsin; agent MCP üzerinden Moonborn'a bağlanır, persona'yı çeker, sohbet aracını kullanır.

Bu sayfayı bitirdiğinde

• MCP sunucu URL'ini ve kimlik doğrulama desenini bileceksin.
• Açılan iki kaynak (personas/{id}, personas) ve bir aracı (moonborn.chat) ayırt edebileceksin.
• IDE / agent istemcisinin MCP yapılandırmasını doğru yetkili API anahtarı ile bağlayabileceksin.
• MCP'nin REST API'yle aynı çalışma zamanına vurduğunu ve denetim izinin nasıl birleştiğini göreceksin.

Ön koşul: API anahtarı + MCP uyumlu bir istemci (Claude Desktop ≥ Kasım 2024, Cursor, JetBrains MCP eklentisi).

Bağlantı yapılandırması

Sunucu URL'i + Bearer token kimlik doğrulaması — sözleşme sabittir, istemci başına biçim değişir:

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

Doğrulanmış istemciler:

• Claude Desktop (Kasım 2024+)
• Claude for VS Code
• Cursor
• JetBrains MCP eklentisi (IntelliJ, WebStorm, PyCharm, vb.)
• LangChain MCP entegrasyonu (@langchain/mcp)
• LlamaIndex (llama-index-tools-mcp)

İstemci başına kurulum adımları: MCP sunucu entegrasyonu eğitimi.

Açılan yüzeyler

Kaynak — moonborn:personas/{id}

Persona'nın tam dört katmanlı dokümanı (Soul / Self / Mask / Surface) + voice fingerprint kimliği + denetim kararı + son drift skoru. Salt okunur.

GET moonborn:personas/per_mert_01H...
→ {
    "id": "per_mert_01H...",
    "soul": { "desire": "...", "fear": "...", ... },
    "self": { "bigFive": {...}, "archetype": "..." },
    "mask": { "voice": {...}, "signaturePhrases": [...] },
    "surface": { "name": {...}, "age": 34, ... },
    "fingerprint": { "id": "fp_01H...", "computedAt": "..." },
    "audit": { "score": 4.3, "verdict": "pass" }
  }

Kaynak — moonborn:personas (liste)

Çalışma alanı persona'larını sıralayan listeleme kaynağı — agent "hangi persona'lar var?" diye sorabilir.

Araç — moonborn.chat

Bir persona'ya karşı oturum açar, mesaj gönderir, yanıt + drift zarfı döndürür:

{
  "tool": "moonborn.chat",
  "input": {
    "personaId": "per_mert_01H...",
    "message": "Beni tetikleyen şey ne?",
    "sessionId": "ses_01H... (isteğe bağlı — yoksa yeni oturum açılır)"
  }
}

Çıktı:

{
  "messageId": "msg_01H...",
  "sessionId": "ses_01H...",
  "content": "...",
  "driftScore": 0.12,
  "driftAlert": false
}

Gerekli yetkiler

MCP kimlik doğrulaması REST API ile aynı Bearer sistemini kullanır. Asgari yetkiler:

MCP'de olmayanlar

Telemetri ve denetim

Her MCP çağrısı standart denetim kaydına iner. moonborn.chat'in döndürdüğü sessionId, /v1/chat/sessions/{id} REST uç noktasıyla aynı kaynağı işaret eder — IDE'den başlatılan oturumu panelden görebilirsin.

Denetim olayları:

• mcp.resource.read — persona okundu
• mcp.tool.call — sohbet aracı çağrıldı

Sık karşılaşılan hatalar

"MCP server not responding"

Kimlik doğrulama başlığı eksik veya yanlış. İstemci yapılandırmasında Authorization: Bearer ${MOONBORN_API_KEY} doğru ortam değişkenine genişleme (expansion) yapıyor mu kontrol et — bazı IDE'ler ${} söz dizimini desteklemez, düz metin olarak yapıştırman gerekebilir.

"Resource not found: moonborn:personas/per_..."

Persona kimliği çalışma alanında yoktur veya API anahtarı yanlış çalışma alanına bağlıdır. GET /v1/personas (REST) ile çalışma alanındaki persona listesini doğrula.

Akış (streaming) araç çıktısı yok

MCP v0.1 belirtiminde araç çıktısı toplu (batch) — token-token akış yok. Uzun yanıtlar tek bir araç çıktısı olarak döner; arayüz tarafında yükleniyor (loading) durumu göster. v0.2'de akışlı araç çıktısı planlandı.

Plan gereksinimi

Team ve üzeri. Free + Pro planlarında MCP uç noktası kapalıdır; REST API + OpenAI uyum katmanı kullanılabilir kalır.

Dürüst kapsam

İlgili