Перейти к содержимому

Вся документация для разработчиков

MCP-сервер Changeloop

MCP-сервер, через который агент работает с вашим changelog прямо из редактора: читает ожидающие, запланированные и опубликованные записи, правит их, публикует сразу или в заданное время либо отклоняет. Ниже: как подключить Claude Code, десять инструментов и чего агент делать не может.

Сервер MCP

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

Если вы работаете в Claude Code, ChatGPT или другом агенте, говорящем на Model Context Protocol, вы можете подключить его напрямую к своему changelog. Тогда агент сможет видеть, что ожидает проверки, редактировать текст и публиковать, не выходя из редактора. Это тот же барьер проверки, что и в веб-приложении: ничего не становится публичным, пока что-то не одобрит это.

Подключение Claude Code

Сначала создайте API-ключ (Настройки, API-ключи), затем добавьте сервер со своим ключом в заголовке:

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

Для клиента, который вместо этого читает JSON-конфигурацию, то же самое выглядит так:

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

Пока нет потока OAuth. Аутентификация — это API-ключ в заголовке, что и делают две команды выше. Отзыв этого ключа в Настройках отключает агента при его следующем запросе.

Что может делать агент

Десять инструментов, и список намеренно короткий. Всё остальное, что может делать этот продукт, доступно через REST API с тем же ключом, а каждый инструмент, открытый агенту, становится ещё одной вещью, к вызову которой его можно склонить.

  • list_pending_entries, list_published_entries, get_entry - читают ваши записи. Ожидающие не являются публичными.
  • update_entry - меняет заголовок или markdown-содержимое записи. HTML, который подаёт фид, повторно рендерится из вашего markdown нашим санитайзером; агент не может предоставить HTML.
  • approve_entry - публикует. Это публично и немедленно, и уведомляет любую связанную обратную связь на GitHub. Одобрить можно только ожидающую запись или запланированную, если передать publish_now: true, и тогда она выйдет сразу, а не в назначенное время.
  • discard_entry - оставляет запись вне changelog. Обратимо из веб-приложения.
  • get_changelog_info - ID вашего фида и адреса, по которым подаётся ваш changelog.
  • list_scheduled_entries, schedule_entry, unschedule_entry - первый показывает, что запланировано, начиная с ближайшего. Второй назначает ожидающей записи время выхода, от минуты до 90 дней вперёд и с указанием часового пояса, или переносит её на новое время. Третий отменяет расписание, и запись возвращается в ожидающие. Сводку запланировать нельзя.

Чего он не может

Каждый инструмент ограничен командой, которой принадлежит ключ, и ни один не принимает команду в качестве аргумента, так что нет ничего, что могло бы указать на другую команду, даже если бы что-то попыталось. Сервер не принимает сессию браузера, только ключ: запрос должен намеренно прикрепить учётные данные. И ключ не может управлять ключами или скачивать экспорт ваших данных, так что агент, подключённый таким образом, не может создать себе вторую учётную запись или извлечь ваши данные за один вызов.

API-ключи

Всё вышеперечисленное анонимно и не требует учётных данных. Аутентифицированный API - ваши настройки, ваша папка проверки - это другая поверхность, и он принимает либо вошедшую сессию браузера, либо API-ключ. Ключи предназначены для скриптов и агентов: всего, что должно достучаться до вашего changelog без человека за клавиатурой.

Создайте его в приложении в разделе Настройки, на вкладке API-ключи. Ключ показывается один раз, в момент создания, и никогда больше: мы храним только его хеш, поэтому нет ни одного экрана, который мог бы показать его вам во второй раз. Если вы его потеряли, отзовите его и создайте другой.

Проверяйте changelog из редактора

Changeloop составляет каждую запись из слитого pull request и держит её до проверки, в веб-приложении или через этот MCP-сервер. Бесплатно для одного репозитория, без карты.

Начать бесплатно

Читать документацию для разработчиков