Przejdź do treści

Cała dokumentacja dla deweloperów

Serwer MCP Changeloop

Serwer MCP, dzięki któremu agent pracuje nad twoim changelogiem z edytora: czyta oczekujące, zaplanowane i opublikowane wpisy, edytuje je, publikuje od razu lub o wybranej porze albo je odrzuca. Niżej: jak podłączyć Claude Code, dziesięć narzędzi i czego agent nie może.

Serwer MCP

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

Jeśli pracujesz w Claude Code, ChatGPT lub innym agencie mówiącym Model Context Protocol, możesz połączyć go bezpośrednio z Twoim changelogiem. Agent może wtedy zobaczyć, co czeka na recenzję, edytować tekst i publikować, bez opuszczania edytora. To ta sama brama recenzji co w aplikacji webowej: nic nie staje się publiczne, dopóki coś tego nie zatwierdzi.

Łączenie Claude Code

Najpierw utwórz klucz API (Ustawienia, Klucze API), a potem dodaj serwer ze swoim kluczem w nagłówku:

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

Dla klienta, który zamiast tego czyta konfigurację JSON, to samo wygląda tak:

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

Nie ma jeszcze przepływu OAuth. Uwierzytelnianiem jest klucz API w nagłówku, co robią dwie powyższe komendy. Odwołanie tego klucza w Ustawieniach odłącza agenta przy jego następnym żądaniu.

Co może zrobić agent

Dziesięć narzędzi, i lista jest celowo krótka. Wszystko inne, co może zrobić ten produkt, jest osiągalne przez REST API tym samym kluczem; każde narzędzie ujawnione agentowi to jedna rzecz więcej, do której wywołania można go namówić.

  • list_pending_entries, list_published_entries, get_entry - czytają Twoje wpisy. Oczekujące nie są publiczne.
  • update_entry - zmienia tytuł lub treść markdown wpisu. HTML serwowany przez feed jest ponownie renderowany z Twojego markdownu przez nasz sanitizer; agent nie może dostarczyć HTML.
  • approve_entry - publikuje. To publiczne i natychmiastowe, i powiadamia wszelkie powiązane opinie na GitHubie. Zatwierdzić można tylko oczekujący wpis albo zaplanowany, gdy przekażesz publish_now: true, co wysyła go od razu zamiast o wyznaczonej porze.
  • discard_entry - trzyma wpis poza changelogiem. Odwracalne z aplikacji webowej.
  • get_changelog_info - identyfikator Twojego feedu i adresy, pod którymi serwowany jest Twój changelog.
  • list_scheduled_entries, schedule_entry, unschedule_entry - pokazują zaplanowane wpisy, od najbliższego. Planują publikację oczekującego wpisu na wybraną porę, podaną wraz ze strefą czasową, od minuty do 90 dni naprzód, albo przenoszą ją na inną porę. Anulują też plan, a wtedy wpis wraca do oczekujących. Podsumowania nie można zaplanować.

Czego nie może zrobić

Każde narzędzie jest ograniczone do zespołu, do którego należy klucz, i żadne nie przyjmuje zespołu jako argumentu, więc nie ma niczego, co wskazywałoby na inny zespół, nawet gdyby coś próbowało. Serwer nie akceptuje sesji przeglądarki, tylko klucz: żądanie musi celowo dołączyć poświadczenie. A klucz nie może zarządzać kluczami ani pobrać eksportu Twoich danych, więc agent połączony w ten sposób nie może wybić sobie drugiego poświadczenia ani wyciągnąć Twoich danych w jednym wywołaniu.

Klucze API

Wszystko powyżej jest anonimowe i nie wymaga poświadczenia. Uwierzytelnione API - Twoje ustawienia, Twoja skrzynka recenzji - to inna powierzchnia i akceptuje albo zalogowaną sesję przeglądarki, albo klucz API. Klucze są dla skryptów i agentów: wszystkiego, co musi dotrzeć do Twojego changeloga bez osoby przy klawiaturze.

Utwórz jeden w aplikacji w Ustawieniach, na zakładce Klucze API. Klucz jest pokazywany raz, w momencie utworzenia, i nigdy więcej: przechowujemy tylko jego hash, więc nie ma żadnego ekranu, który mógłby go pokazać po raz drugi. Jeśli go zgubisz, odwołaj go i utwórz kolejny.

Przeglądaj changelog z edytora

Changeloop tworzy każdy wpis z połączonego pull requesta i zatrzymuje go do przeglądu, w aplikacji webowej albo przez ten serwer MCP. Za darmo dla jednego repozytorium, bez karty.

Zacznij za darmo

Przeczytaj dokumentację dla deweloperów