MCP sunucusu

KolayMarketing MCP sunucusu, Claude gibi Model Context Protocol destekleyen yapay zekâ araçlarının bir workspace ile konuşmasını sağlar. Sunucu bir partner anahtarıyla çalışır ve bir partner uygulamasının gördüğünden fazlasını görmez: tek workspace, onay ya da yayın yok.

Sunucu şu an herkese açık bir paket olarak yayımlanmıyor. Kurulum için KolayMarketing ekibinden isteyin; aşağıdaki ayarlar kurulumdan sonra geçerlidir.

Ayar

Sunucu stdio üzerinden çalışır ve iki ortam değişkeni okur:

Değişken	Kural
`KOLAYMARKETING_API_KEY`	zorunlu, `km_pk_` ile başlayan partner anahtarı
`KOLAYMARKETING_API_URL`	isteğe bağlı, varsayılan `https://api.kolaymarketing.com/v1`

Claude Code örneği:

{
  "mcpServers": {
    "kolaymarketing": {
      "command": "node",
      "args": ["/kurulum/yeri/src/main.ts"],
      "env": { "KOLAYMARKETING_API_KEY": "km_pk_…" }
    }
  }
}

Anahtar hiçbir çıktıya yazılmaz.

Araçlar

Araç	Ne yapar	Gereken scope
`get_workspace`	kanallar, durumlara göre içerik sayıları, son yayınlar, yayın kapıları, ihtiyaç listesi özeti	`partner`
`list_intake`	pazarlama ekibinin beklediği kalemler ve durumları; gizli kalemlerin değeri dönmez	`partner`
`submit_intake`	bir ihtiyaç kalemine düz değer (metin, URL, seçenek) gönderir	`partner`
`submit_idea`	içerik fikri bırakır; onaylamaz, yayınlamaz	`partner`
`ingest_signals`	ürün ve kampanya olaylarını Sinyaller’e gönderir (en fazla 200)	`signals_ingest`

Şifre ve erişim bilgisi isteyen kalemler MCP ile gönderilmez. Gizli bilgi sohbete girmesin diye bunlar yalnız partner formundan ya da API üzerinden doldurulur.
Araçların gövdeleri ve kuralları API ile aynıdır: Workspace ve ihtiyaç listesi, Sinyal gönderme.
Hata olduğunda araç, API’nin sade Türkçe mesajını, HTTP durumunu ve code değerini döner.