İçeriğe geç

Tüm geliştirici belgeleri

Changeloop MCP sunucusu

Bir ajanın editörden changelog'un üzerinde çalışmasını sağlayan MCP sunucusu: bekleyen, zamanlanmış ve yayınlanmış kayıtları okur, düzenler, hemen ya da belirlediğin bir zamanda yayınlar veya atar. Aşağıda: Claude Code'u bağlama, on araç ve bir ajanın yapamadıkları.

MCP sunucusu

POST https://api.changeloop.dev/mcp

Claude Code, ChatGPT veya Model Context Protocol konuşan başka bir ajanla çalışıyorsan onu doğrudan changelog'una bağlayabilirsin. Ajan böylece incelemeyi bekleyeni görebilir, metni düzenleyebilir ve editörden çıkmadan yayımlayabilir. Bu, web uygulamasıyla aynı inceleme kapısıdır: bir şey onaylamadan hiçbir şey herkese açık olmaz.

Claude Code'u bağlamak

Önce bir API anahtarı oluştur (Ayarlar, API anahtarları), sonra sunucuyu başlıkta anahtarınla ekle:

claude mcp add --transport http changeloop \
  https://api.changeloop.dev/mcp \
  --header "Authorization: Bearer clapi_YOUR_KEY"

Bunun yerine bir JSON yapılandırması okuyan bir istemci için aynı şey şöyle görünür:

{
  "mcpServers": {
    "changeloop": {
      "type": "http",
      "url": "https://api.changeloop.dev/mcp",
      "headers": { "Authorization": "Bearer clapi_YOUR_KEY" }
    }
  }
}

Henüz bir OAuth akışı yok. Kimlik doğrulama, yukarıdaki iki komutun yaptığı gibi başlıktaki API anahtarıdır. Ayarlar'da o anahtarı iptal etmek, ajanı bir sonraki isteğinde bağlantısını keser.

Ajanın yapabilecekleri

On araç, ve liste kasıtlı olarak kısa. Bu ürünün yapabileceği başka her şeye aynı anahtarla REST API üzerinden ulaşılabilir; bir ajana açılan her araç, onu yapmaya ikna edilebileceği bir şey daha demektir.

  • list_pending_entries, list_published_entries, get_entry - kayıtlarını okur. Bekleyenler herkese açık değildir.
  • update_entry - bir kaydın başlığını veya markdown gövdesini değiştirir. Akışın sunduğu HTML, markdown'ından arındırıcımız tarafından yeniden renderlanır; bir ajan HTML sağlayamaz.
  • approve_entry - yayımla. Bu herkese açık ve anlıktır ve GitHub'daki bağlı geri bildirimi bilgilendirir. Yalnızca bekleyen bir kayıt onaylanabilir, ya da publish_now: true verdiğinde zamanlanmış bir kayıt. Bu durumda kayıt kendi zamanını beklemeden hemen yayımlanır.
  • discard_entry - bir kaydı changelog dışında tut. Web uygulamasından geri alınabilir.
  • get_changelog_info - akış kimliğin ve changelog'unun sunulduğu adresler.
  • list_scheduled_entries, schedule_entry, unschedule_entry - zamanlanmış kayıtları en yakını başta olacak şekilde listeler. Bekleyen bir kaydı saat dilimiyle birlikte verilen bir zamanda, bir dakika ile 90 gün sonrası arasında yayımlanmak üzere zamanlar ya da yeni bir zamana taşır. Bir zamanlamayı iptal de edebilir, bu durumda kayıt bekleyenlere geri döner. Bir özet zamanlanamaz.

Yapamayacakları

Her araç, anahtarın ait olduğu ekiple kapsamlandırılmıştır ve hiçbiri argüman olarak bir ekip almaz, bu yüzden bir şey denese bile başka bir ekibe işaret edecek bir şey yoktur. Sunucu bir tarayıcı oturumunu kabul etmez, yalnızca bir anahtarı: bir isteğin kimlik bilgisini kasıtlı olarak eklemesi gerekir. Ve bir anahtar anahtarları yönetemez veya veri dışa aktarımını indiremez, bu yüzden bu şekilde bağlanan bir ajan kendine ikinci bir kimlik bilgisi basamaz veya verini tek bir çağrıda dışarı çekemez.

API anahtarları

Yukarıdakilerin hepsi anonimdir ve bir kimlik bilgisi gerektirmez. Kimlik doğrulamalı API -- ayarların, inceleme kutun -- farklı bir yüzeydir ve ya giriş yapılmış bir tarayıcı oturumunu ya da bir API anahtarını kabul eder. Anahtarlar betikler ve ajanlar içindir: klavyede bir kişi olmadan changelog'una ulaşması gereken her şey.

Uygulamada Ayarlar altında, API anahtarları sekmesinde bir tane oluştur. Anahtar, oluşturduğun anda bir kez gösterilir ve bir daha asla: yalnızca bir hash'ini saklıyoruz, bu yüzden onu sana ikinci kez gösterebilecek hiçbir ekran yoktur. Kaybedersen iptal et ve bir tane daha oluştur.

Changelog'unu editörden incele

Changeloop her kaydı birleştirilmiş bir pull request'ten yazar ve web uygulamasında ya da bu MCP sunucusu üzerinden inceleme için bekletir. Tek depo için ücretsiz, kart gerekmez.

Ücretsiz başla

Geliştirici dokümantasyonunu oku