Uygulamayı aç
Moonborn — Developers

MCP server entegrasyonu

Claude / Cursor / agent framework'leri Model Context Protocol server üzerinden Moonborn'a bağla. Personalar resource olarak görünür, chat tool olarak.

Moonborn https://api.moonborn.co/v1/mcp'de bir Model Context Protocol (MCP) server açar. Herhangi bir MCP uyumlu client — Claude for VS Code, Cursor, JetBrains, protokolü konuşan bir agent framework — workspace personalarını resource olarak listeleyebilir ve chat oturumlarını tool olarak çağırabilir.

1. MCP client'ını konfigüre et

Çoğu client ayarlarında MCP server girişi kabul eder. Şekil client'a göre değişir; bağlantı detayları değişmez:

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

Claude for VS Code için ~/.config/claude/mcp.json (macOS) ya da OS'undaki eşdeğer dosyaya ekle. Cursor için ayarlar panelinde "MCP Servers" bölümü var.

2. Resource'ları listele

Bağlandıktan sonra, client Moonborn'un resource'larını sıralayabilir:

mcp> list resources
moonborn:personas/persona_01H...  — "Mert Aksoy"
moonborn:personas/persona_02H...  — "Leyla Demir"
moonborn:personas/persona_03H...  — "Brand voice — canonical"

Her resource şunu açar:

  • Personanın tam dört katmanlı dokümanı (MCP'den read-only).
  • Voice fingerprint ID.
  • Güncel audit verdict + skor.

3. Bir resource oku

mcp> read moonborn:personas/persona_01H...

Client tam persona dokümanını MCP resource içeriği olarak alır. Claude artık "bu personanın growth arc'i ne?" gibi soruları resource'u doğrudan okuyarak cevaplayabilir.

4. Chat tool'unu çağır

MCP server bir chat tool açar, tek çağrıda oturum açar ve mesaj gönderir:

mcp> call moonborn.chat
  persona: moonborn:personas/persona_01H...
  message: "Geçen çeyreğin hakkında anlat."

Tool yanıtı, drift envelope'u ve oturum ID'sini (turlar arası devamlılık için yararlı) döner.

5. Limitler

MCP server read-only resource erişimi + chat tool'una scope'lanmış. Yapamazsın:

  • MCP üzerinden persona yaratma ya da silme — REST API'yi kullan.
  • MCP'den workspace config'i değiştirme.
  • MCP'den audit log'larına ya da webhook delivery'lerine erişme.

Tam read/write için REST yüzeyine doğrudan vur. MCP dar, IDE-dostu giriş noktası.

6. Authentication scope'ları

Bearer token en az şunlara sahip olmalı:

  • read:personas — resource'ları listelemek ve okumak için.
  • write:chat — chat tool'unu çağırmak için.

Bir MCP client'a en-az-yetki credential vermek istersen Settings → API keys → New key üzerinden scope'lu bir API key çıkar.

Tarif

Team ve üstü.

Dürüst kapsam

MCP server MCP client'larına persona servis eder. Genel bir agent host değil, tam bir LLM router değil, chat completions endpoint'ine alternatif değil. IDE + agent framework kullanıcıları için dar bir protokol köprüsü.

Sonraki