MCP sunucusu üzerinden bağlan

Bir IDE'de (Claude for VS Code, Cursor, JetBrains) ya da bir agent (etmen) çatısında çalışıyorsan, Moonborn'a en doğal bağlanma yolu Model Context Protocol (MCP — Model Bağlam Protokolü) üzerindendir. Bir kez yapılandırırsın, sonra çalışma alanındaki persona'ları kaynak (resource) olarak görürsün ve sohbet oturumunu araç (tool) olarak çağırırsın — kod yazarken bile karakter sesinden cevap almak için.

https://api.moonborn.co/v1/mcp adresi, herhangi bir MCP uyumlu istemci tarafından konuşulabilen bir MCP sunucusudur. Bu rehber bağlantıyı kurar, kaynak ve araç yüzeyini gezdirir, MCP üzerinden neyin yapılabildiğini ve neyin yapılamadığını netleştirir.

Bu rehberi bitirdiğinde

• MCP istemcisini (Claude for VS Code, Cursor, vb.) Moonborn'a bağlayabileceksin.
• Çalışma alanındaki persona'ları MCP kaynağı olarak listeleyip okuyabileceksin.
• moonborn.chat aracını IDE içinden çağırıp persona yanıtı alabileceksin.
• MCP'nin dar olduğunu, salt okunur persona + yazılabilir sohbet ile sınırlandığını bileceksin.
• Bir IDE'ye en az yetki (least privilege) ilkesiyle API anahtarı vermek istediğinde gereken yetkileri (scope) seçebileceksin.

Ön koşul: Moonborn API anahtarı, çalışma alanında en az bir persona, MCP'yi destekleyen bir istemci. Persona'n yoksa önce İlk persona'yı baştan sona üret.

1. MCP istemcisini yapılandır

Her istemcinin yapılandırma biçimi biraz farklıdır, ama bağlantı şekli aynıdır: HTTPS taşıyıcı (transport), temel URL ve Authorization: Bearer başlığı.

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

2. Persona'ları kaynak olarak listele

Bağlandıktan sonra istemci Moonborn kaynaklarını sıralayabilir:

mcp> list resources
moonborn:personas/per_01H...  — "Mert Aksoy"
moonborn:personas/per_02H...  — "Leyla Demir"
moonborn:personas/per_03H...  — "Brand voice — canonical"

Her kaynak şunları taşır:

• Persona'nın tam dört katmanlı dokümanı (Soul, Self, Mask, Surface)
• Voice fingerprint kimliği
• Güncel denetim kararı + skor

3. Bir kaynağı oku

mcp> read moonborn:personas/per_01H...

İstemci, persona dokümanının tamamını MCP kaynağı içeriği olarak alır. IDE'deki LLM artık "bu persona'nın gelişim yayı (growth arc) nedir?" gibi soruları kaynağı doğrudan okuyarak yanıtlayabilir — başka bir LLM çağrısı yapmadan.

4. moonborn.chat aracını çağır

MCP sunucusu bir chat aracı açar — tek çağrıda oturum açar, mesajı gönderir, yanıtı drift zarfıyla birlikte döner.

mcp> call moonborn.chat
  persona: moonborn:personas/per_01H...
  message: "Geçen çeyrekte ne oldu? Bana bir cümle ile özetle."

Beklenen yanıt:

{
  "content": "Beklediğimizden hızlıydı. Kahve sayısını saymaya yetişemedim.",
  "sessionId": "ses_01H...",
  "driftScore": 0.11,
  "driftAlert": false
}

5. MCP sunucusu neyi yapar, neyi yapmaz

- Çalışma alanındaki persona'ları kaynak olarak
  listele
- Kaynak detayını salt okunur biçimde getir
- moonborn.chat aracıyla yanıt al
- Drift zarfını araç yanıtında dön
- Oturum kimliğiyle turlar arası devamlılık

6. MCP istemcisine en az yetkili anahtar ver

Bearer token'ın en az şu yetkilere sahip olmalı:

Bir IDE'ye geniş yetkili üretim anahtarı vermek yerine Settings → API Keys → New key ile sadece bu iki yetkiye sahip ayrı bir anahtar üret. Tam yetki kataloğu: API anahtarı yetkileri başvurusu.

Plan gereksinimi

Team ve üzeri.

Başardın

MCP istemcisinde moonborn sunucusu bağlanmış olarak görünüyorsa, persona'larını kaynak olarak listeleyebiliyorsan ve moonborn.chat aracıyla karakter sesinde bir yanıt aldıysan rehber bitti.

Sonraki adım