콘텐츠로 건너뛰기

전체 개발자 문서

Changeloop MCP 서버

에이전트가 편집기에서 changelog를 다룰 수 있게 하는 MCP 서버입니다. 대기 중이거나 예약되었거나 게시된 항목을 읽고, 편집하고, 지금 바로 또는 정한 시각에 게시하거나, 버릴 수 있습니다. 아래에서 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 - 예약된 항목을 가장 가까운 시각부터 확인합니다. 대기 중인 항목을 정한 시각에 게시되도록 예약하거나 새 시각으로 옮길 수 있으며, 시각은 시간대와 함께 지정하고 1분 후부터 90일 후까지 가능합니다. 예약을 취소하면 항목은 다시 대기 중 상태로 돌아갑니다. 라운드업은 예약할 수 없습니다.

할 수 없는 것

모든 도구는 키가 속한 팀으로 범위가 제한되며, 어떤 도구도 팀을 인자로 받지 않으므로 무언가가 시도해도 다른 팀을 가리킬 방법이 전혀 없습니다. 서버는 브라우저 세션을 받아들이지 않고 키만 받아들입니다: 요청은 의도적으로 자격증명을 첨부해야 합니다. 또한 키는 키를 관리하거나 데이터 내보내기를 다운로드할 수 없으므로, 이 방식으로 연결된 에이전트는 자신을 위한 두 번째 자격증명을 발급하거나 한 번의 호출로 여러분의 데이터를 빼낼 수 없습니다.

API 키

위의 모든 것은 익명이며 자격증명이 필요 없습니다. 인증된 API - 여러분의 설정, 여러분의 검토함 - 은 다른 표면이며 로그인된 브라우저 세션이나 API 키 중 하나를 받아들입니다. 키는 스크립트와 에이전트를 위한 것입니다: 키보드 앞에 사람이 없는 상태로 여러분의 changelog에 도달해야 하는 모든 것.

앱의 설정 아래 API 키 탭에서 하나를 만드세요. 키는 만든 순간에 한 번만 표시되고 다시는 표시되지 않습니다: 당사는 그 해시만 저장하므로 두 번째로 그것을 보여줄 화면이 어디에도 없습니다. 분실했다면 그것을 취소하고 다른 것을 만드세요.

편집기에서 changelog 검토하기

Changeloop은 병합된 풀 리퀘스트마다 항목 초안을 만들고, 웹 앱이나 이 MCP 서버에서 검토할 때까지 보류합니다. 저장소 하나까지 무료, 카드 불필요.

무료로 시작하기

개발자 문서 읽기