Clean Notes

Clean Notes MCP サーバー

OAuth とプロジェクトごとの読み取り／書き込み権限を備えた、AI クライアント向けのカンバンタスクとプロジェクトノートです。

Clean Notes は、小規模チーム向けのプロジェクトワークスペースです。リスト表示とタイムライン表示を備えたカンバンボード、タスクの説明に役立つプロジェクトノート、リアルタイム更新を利用できます。MCP サーバーを使うと、GitHub Copilot、ChatGPT、Claude などの MCP クライアントから、許可したプロジェクトだけを読み取ったり更新したりできます。

このリポジトリでは、ホスト型サーバーについて説明します。ローカルにインストールしたり実行したりする必要はありません。クライアントからエンドポイントに接続し、サインインするだけです。

エンドポイント	https://cleannotes.app/mcp
トランスポート	Streamable HTTP、ステートレス
認証	動的クライアント登録と PKCE に対応した OAuth 2.1。貼り付けが必要な API キーやトークンはありません。
ツール	11 個：読み取りが 6 個、書き込みが 5 個、削除はありません
レジストリ名	app.cleannotes/clean-notes

Clean Notes アカウントが必要です。無料プランには AI アクセスが含まれます。

設定

GitHub Copilot を使用する VS Code

上のインストールボタンを使うか、ワークスペース内の .vscode/mcp.json（またはユーザーの mcp.json）にサーバーを追加します。

{
  "servers": {
    "clean-notes": {
      "type": "http",
      "url": "https://cleannotes.app/mcp"
    }
  }
}

サーバーを起動します。VS Code から Clean Notes へのサインインを求められたら許可してください。ブラウザーで Clean Notes が開くので、サインインして共有するプロジェクトを選択します。その後、エージェントモードの Copilot Chat にツールが表示されます。

Claude Code

claude mcp add --transport http clean-notes --scope user https://cleannotes.app/mcp

次に、Claude Code で /mcp を実行し、Clean Notes の横にある 認証 を選択します。

Claude（アプリとウェブ）

設定 → コネクター → カスタムコネクターを追加を開き、https://cleannotes.app/mcp を貼り付けて認証します。

ChatGPT

Clean Notes プラグインを開き、アカウントを接続してプロジェクトを承認します。

その他の MCP クライアント

https://cleannotes.app/mcp を Streamable HTTP サーバーとして登録し、ブラウザーで OAuth サインインを完了します。クライアントは、残りの情報を https://cleannotes.app/.well-known/oauth-protected-resource から自動的に取得します。

アシスタントがアクセスできる範囲を選ぶ

サインインによって本人確認は行われますが、ワークスペースへのアクセスが許可されるわけではありません。サインイン直後に、Clean Notes からこの接続にアクセスを許可するプロジェクトと、それぞれについて読み取りのみを許可するか、変更も許可するかを尋ねられます。プロジェクトへの権限が付与されていない接続では、何も読み取れません。

• 権限の付与と取り消しは、各プロジェクトの AI ツール パネルから Clean Notes で行います。
• プロジェクトのオーナーは、メンバーが自分の AI ツールを接続できるかどうかを決定します。
• アシスタントは何も削除できず、メンバー、設定、請求情報を変更することもできません。

使用方法

たとえば、自然な言葉で次のように尋ねてください。

• 「Launch プロジェクトで期限超過またはブロック中のタスクはどれですか？それぞれの担当者も教えてください」
• 「この議事メモをもとに、Launch プロジェクトにタスクを作成してください。それぞれに担当者と期限も設定してください」
• 「料金ページのタスクを完了にして、今日決定した内容をプロジェクトノートに書いてください」
• 「月曜日以降、Website プロジェクトで何が変わりましたか？」

ツール

ツール	アクセス	機能
clean_notes_list_projects	読み取り	この接続でアクセスできるプロジェクトを一覧表示します。
clean_notes_get_project	読み取り	順序付けされたステータスと、担当者として割り当て可能なメンバーを含むプロジェクトを返します。
clean_notes_list_tasks	読み取り	ステータス、担当者、または最終更新日時で絞り込み、カーソルと件数上限を指定してタスクを一覧表示します。
clean_notes_get_task	読み取り	詳細情報をすべて含むタスクを返します。
clean_notes_list_notes	読み取り	カーソルを指定して、短いプレビュー付きのノートを一覧表示します。
clean_notes_get_note	読み取り	ノートの本文全体を返します。
clean_notes_create_task	書き込み	タイトル、詳細、ステータス、優先度、担当者、日付を指定してタスクを作成します。
clean_notes_update_task	書き込み	タスクの各項目を変更します。
clean_notes_complete_task	書き込み	タスクを完了済みとしてマークします。
clean_notes_create_note	書き込み	タイトルと本文を指定してノートを作成します。必要に応じてピン留めできます。
clean_notes_update_note	書き込み	ノートのタイトル、本文、またはピン留めを編集します。

書き込みツールを使用できるのは、読み取りと変更が許可されているプロジェクトのみです。それ以外の場所への呼び出しは拒否されます。

安全に再試行できる設計

• すべての書き込みでは冪等性キーが必要です。そのため、呼び出しを繰り返しても、2つ目のタスクやノートを作成せず、最初の結果を返します。
• 更新と完了では、レコードの expectedUpdatedAt を指定します。先に他の人が変更していた場合、編集内容を上書きせず、競合エラーで呼び出しが失敗します。その後、アシスタントは再読み込みしてから再試行します。
• すべてのツールはクローズドワールド方式です。許可されたプロジェクトのみを読み書きし、インターネットにはアクセスしません。
• 各プロジェクトには、クライアント、ツール、時刻、結果を記録するAI変更のアクティビティログが保存されます。保存されるのはメタデータであり、呼び出しの内容ではありません。

料金

すべてのプランでAIアクセスを利用できます。月間の利用枠に算入されるのは、成功した変更のみです。読み取り、競合、拒否された呼び出しは無料です。

プラン	料金	月間のAI変更回数
Free	$0	50
Pro	月額 $4.90	5,000
Scale	月額 $14.90	25,000

請求は作成したプロジェクトに基づくため、招待した人にシート料金が請求されることはありません。料金をご覧ください。

リンク

• ドキュメント：cleannotes.app/en/ai/mcp
• ウェブサイト：cleannotes.app
• サポート：cleannotes.app/en/support または [email protected]
• プライバシーポリシー · 利用規約

Clean Notesは独自のホスト型サービスです。このリポジトリには公開ドキュメントのみが含まれており、サーバーのソースコードは公開されていません。