changologs-mcp

changologs-mcp

Changologs 用の MCP サーバーです。Claude やその他の MCP クライアントを使って、ログの作成、検索、編集や、タスクの管理ができます。

ホスト型のリモートサーバーです。インストールは不要です。以下の URL にクライアントを接続し、Changologs アカウントでサインインしてください。

https://mcp.changologs.com/mcp

MCP Registry に io.github.altyaper/changologs-mcp として登録されています。

接続

Claude Code

claude mcp add --transport http changologs https://mcp.changologs.com/mcp

次に、Claude Code 内で /mcp を実行し、changologs を選んでサインインしてください。

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector を開き、URL として https://mcp.changologs.com/mcp を入力してください。

その他のクライアント

ストリーミング可能な HTTP トランスポートと OAuth に対応しているクライアントであれば、同じ URL に接続できます。

認証

このサーバーは PKCE を使用した OAuth 2.0 を採用しており、Changologs が認可サーバーです。クライアントは /.well-known/oauth-authorization-server で認可サーバーのエンドポイントを見つけ、自動的に自身を登録します（RFC 7591 に基づく動的クライアント登録）。その後、ブラウザーで Changologs のサインインページが開きます。承認すると、すべてのリクエストにアクセストークンが付与されるため、サーバーが参照できるのはご自身のワークスペース、ログ、タスクのみです。

サーバーには何も保存されません。各リクエストは、トークンを使って Changologs API に直接送信されます。

ツール

ログ

ツール	機能
create_log	新しいログを作成します（new_log: true を指定するか、title を指定した場合）。または、今日の日次ノートに追記します（タイトルなしのクイックノートではこれが既定です）。
list_workspaces	create_log で使用するワークスペースとその ID を一覧表示します。
list_recent_logs	最近更新されたログを一覧表示します。
search_logs	タイトルまたは内容でログを検索します。
get_log	タイトルを指定して、ログの全内容を取得します。
update_log	タイトルを指定して、ログの内容に追記するか、置き換えます。
set_log_icon	ログのタイトルの横に表示する絵文字を設定または削除します。
delete_log	タイトルを指定して、ログを削除します。

リッチコンテンツブロック

これらのツールは、changologs エディターの書式と完全に一致する HTML フラグメントを生成します。 API は呼び出しません。フラグメントを順番につなげ、その結果を create_log／update_log の text に渡すと、リッチな書式のログを作成できます。

ツール	機能
add_paragraph	段落です。**太字**、_斜体_、`コード`、[テキスト](url) に対応しています。
add_heading	見出しです。レベル 1～3 を指定できます。
add_bullet_list / add_numbered_list	箇条書きまたは番号付きリストです。
add_task_list	チェックボックス付きリストです（インラインコンテンツであり、create_task_list のタスクリストではありません）。
add_blockquote	引用です。
add_code_block	コードブロックです。言語ラベルを任意で指定できます。
add_divider	水平線です。
add_toggle	要約と非表示の内容を含む折りたたみ可能なセクションです。
add_callout	アイコン付きの強調表示されたコールアウトボックスです。
add_table	テーブルです。このエディターにはヘッダー行の書式設定がないため、header_row: true を指定すると、代わりに先頭行のテキストが太字になります。
add_image	画像です。ホスト済みの URL を使用します（ファイルのアップロードはできません）。

タスク

ツール	機能
list_task_lists	create_task で使用するタスクリストとその ID を一覧表示します。
create_task_list	タスクリストを作成します。ワークスペースを任意で指定できます。
list_tasks	リスト内のタスクを表示順に一覧表示します。完了済みタスクを含めるかどうかは任意です。
create_task	詳細、日付、期限を任意で指定してタスクを作成します。
get_task	タイトルを指定して、タスクの詳細を取得します。
update_task	タスク名を変更するか、詳細、日付、期限を変更します。
complete_task	タスクを完了にするか、未完了に戻します。繰り返しタスクを完了にすると、次回分に移動します。

データベース

データベースは、サブログがテーブルの行になっているログです。各行のタイトルが Name で、 その他の列は型付きです（テキスト、数値、日付、選択、複数選択、チェックボックス、 URL、メール、電話番号、担当者）。データベースはワークスペース内でタイトルから検索し、 行はタイトルまたは query_database_rows が表示する row_id から検索します。

行の絵文字は、changologs がタイトルの横に表示する行ログのアイコンです。これは icon パラメーターで設定し、タイトルに絵文字を書き込んで設定するものではありません。タイトルの 先頭に絵文字がある場合はアイコンに移動されるため、行に絵文字が重複して表示されることはありません。

ツール	機能
list_databases	ワークスペース内のデータベースを一覧表示します。
get_database	データベースの列（選択肢を含む）とビュー（フィルターと並べ替えを含む）を表示します。
query_database_rows	ビューでフィルターや並べ替えを行い、1ページあたり100件の行をテーブル形式で一覧表示します。
create_database	オプションで列を指定してデータベースを作成します。
convert_log_to_database	ログをデータベースに変換します。サブログは行になり、そのプロパティから列が作成されます。
add_database_column / update_database_column / delete_database_column	列の追加、名前変更、型変更、選択肢の変更、削除を行います。
add_database_row	タイトル、任意の絵文字アイコン、列名をキーにしたセルの値を指定して行を追加します。
update_database_row	行のタイトル、アイコン、または一部のセルを変更します。
delete_database_row	行をゴミ箱に移動します。
update_database_view	ビューのフィルターと並べ替えを置き換えます。changologs に保存されたビューが全員に対して変更されます。

プロンプトの例

• 「このセッションで行ったことを Changologs に記録して。」
• 「これらのデータをすべて含む新しいログをテーブル形式で作成し、適切な箇所にコールアウトを追加して、h1/h2/h3 の見出しと段落を使って。」
• 「Postgres の移行に関するメモをログから検索して。」
• 「金曜日までにリリースノートを仕上げるタスクを追加して。」
• 「Work タスクリストには何が残っている？」
• 「Reading リストデータベースに、ステータスを Reading にした Dune の行を追加して。」
• 「Bugs データベースで Done ではない行をすべて表示して。」

開発

ホストされているサーバーは Cloudflare Worker（worker.ts）です。server.ts は、ローカル開発用の同じサーバーのスタンドアロン Node 版です。

npm install

# Worker, locally
npm run dev:worker

# Node server on http://localhost:3001/mcp, pointing at a local Changologs app
CHANGOLOGS_BASE_URL=http://localhost:3000 npm start

# Type-check
npm run build

# Run tests
npm test

Worker は wrangler.json から CHANGOLOGS_BASE_URL（https://changologs.com に設定）を読み込みます。npm run deploy で Wrangler を使ってデプロイします。

レジストリの掲載情報を更新するには、server.json の version を上げて、mcp-publisher publish を実行します。