コンテンツへスキップ

開発者向けドキュメント一覧

Changeloop MCPサーバー

エージェントがエディターからchangelogを扱えるMCPサーバーです。保留中、予約済み、公開済みのエントリーを読み、編集し、今すぐまたは指定した時刻に公開するか、破棄できます。以下では、Claude Codeの接続方法、10個のツール、エージェントにできないことを説明します。

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キーであり、上記の2つのコマンドが行っていることです。設定でそのキーを取り消すと、次のリクエストでエージェントが切断されます。

エージェントができること

10個のツールがあり、リストは意図的に短くしています。この製品ができる他のことはすべて、同じキーでREST API経由で利用できます。エージェントに公開される各ツールは、それを呼び出すよう説得され得るもう1つの手段です。

  • 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日後までの範囲です。予約を取り消すと、エントリは保留中に戻ります。まとめ投稿は予約できません。

できないこと

すべてのツールはキーが属するチームに限定されており、どれも引数としてチームを受け取らないため、何かが試みても他のチームを指すものは何もありません。サーバーはブラウザセッションを受け付けず、キーのみを受け付けます。リクエストは意図的に認証情報を添付する必要があります。また、キーはキーを管理することも、データエクスポートをダウンロードすることもできないため、この方法で接続されたエージェントは、自分自身に2つ目の認証情報を発行することも、1回の呼び出しであなたのデータを引き出すこともできません。

APIキー

上記はすべて匿名であり、認証情報を必要としません。認証されたAPI - あなたの設定、あなたのレビューボックス - は別の表面であり、サインイン済みのブラウザセッションまたはAPIキーのいずれかを受け付けます。キーはスクリプトとエージェントのためのものです:キーボードに人がいない状態であなたのchangelogに到達する必要のあるものすべて。

アプリの「設定」の「APIキー」タブで作成します。キーは作成した瞬間に一度だけ表示され、二度と表示されません。当社はそのハッシュのみを保存するため、二度目にそれをあなたに表示できる画面はどこにもありません。紛失した場合は、それを取り消して別のキーを作成してください。

エディターからchangelogをレビュー

Changeloopはマージされたプルリクエストから各エントリーを下書きし、ウェブアプリまたはこのMCPサーバーでのレビューまで保留します。1リポジトリまで無料、カード不要。

無料で始める

開発者向けドキュメントを読む