noteit-mcp

Noteit MCP

🩹 AI の「Markdown 地獄」を解消 — AI プロンプトライブラリ＋開発者向けビジュアルナレッジハブ

Noteit-MCP は、5,000 語のドキュメントに埋もれる状況を、すぐにナビゲート可能な HTML とロジック図に変えます。60 以上の専門家ペルソナを活用し、認知的な負担をかけずに複雑なアイデアを整理できます。仕様駆動開発を、誰にとっても読みやすいものにします。

✨ デモとスクリーンショット

🎥 Noteit MCP の動作 — 使用方法の全体を紹介

🎬 クリックしてデモ全編を視聴

📊 エージェントのプロファイルとノート管理を統合したダッシュボード

🤖 さまざまなコーディングタスクに対応する、構築済みのエージェントテンプレート 40 種類以上

📝 グラフによる可視化に対応した、AI が読み取れるノート

1) Noteit MCP とは？

Noteit MCP は、AI コーディングツールが次の 2 つのコアシステムに安全にアクセスできる HTTP MCP サーバー（Next.js API ルート）です。

• エージェントプロファイル：特定のタスクに合わせて AI の動作を調整する、組み合わせ可能な設定（ペルソナ、指示、ルール、ドキュメント）。
• ノート：構造化された記録とグラフによる可視化を備えた、個人向けのノート作成機能。

認証には、対応する IDE 向けの デバイスフィンガープリントを用いた OAuth 2.1 を使用します。他の MCP クライアント向けには、オプションで API トークンによる認証も利用できます。サーバーのエンドポイントは /api/mcp で公開されています。

2) Noteit MCP を使う理由

• 設定の統合：あらゆる AI クライアントが利用できる、再利用可能なエージェントプロファイル。
• 効率的なノート作成：AI が読み取れるノート、タスク、ビジュアルグラフ。
• 設計段階から安全：OAuth 2.1 と透明性のあるトークン更新。OAuth 非対応のクライアント向けの API トークン。
• 複数の IDE で利用可能：Cursor、Claude Code、Gemini CLI、Claude Desktop（プロキシ経由）など。

さまざまなコーディングタスクやワークフローに対応する、60 種類以上の専門家ペルソナ

3) 接続方法

MCP サーバーは https://www.noteit-mcp.com/api/mcp にあります。

Cursor（mcp.json）

~/.cursor/mcp.json を作成するか、更新します。

{
  "mcpServers": {
    "noteit-mcp": {
      "url": "https://www.noteit-mcp.com/api/mcp"
    }
  }
}

その後、Cursor を再起動します。OAuth は自動的に処理されます。

Claude Code（組み込み MCP）

コマンドラインヘルパーを使用します（グローバルスコープ）。

claude mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp

または、プロジェクトスコープで使用します。

claude mcp add -s project --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp

Gemini CLI

サーバーを追加して認証します。

gemini mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp
/mcp auth noteit-mcp
/mcp  # verify tools are listed

その他の IDE（API トークン）

https://www.noteit-mcp.com にログインして、API トークンを取得します。

---

4）利用可能なツール

Noteit-MCP を通じて、エージェントは次のツールを使用できます。

• noteit_profiles_list: ユーザーのエージェントプロファイルを一覧表示します。エージェントプロファイルは、特定の役割やタスク向けのペルソナ、指示、ルール、ドキュメントを含む設定セットです
• noteit_profiles_getConfig: ペルソナ、指示、ルール、ドキュメントを含む、組み合わせ可能な AI エージェント設定プロファイルを取得します
• noteit_profiles_generate: エージェントプロファイルに組み込める個別の設定コンポーネント（ペルソナ、ルール、ドキュメント、指示）を生成して保存します
• noteit_notes_create: 4 種類の専用タイプを使ってプロジェクトノートを作成します。「note」は一般的な記録、「task」は開発タスク、「why」は説明、「issue」は問題やバグに使用します
• noteit_notes_read: 一意の ID を指定して、特定のノートの全内容を取得します
• noteit_notes_list: タグ、記録タイプ、プロジェクト名で任意に絞り込みながら、プロジェクトを横断してユーザーのすべてのノートを閲覧、フィルタリングします
• noteit_web_create: 開発者が複雑な概念、プロセス、技術的な詳細を理解できるよう、インタラクティブな HTML ノートを生成します
• noteit_flow_create: ネストされたデータに対応した、技術プロセスを視覚化するフロー図を作成します

---

⭐ このプロジェクトにスターを付ける

Noteit MCP が AI ワークフローの効率化に役立った場合は、ぜひスターを付けてください。他の人がこのツールを見つけやすくなり、継続的な開発の励みになります。

ライセンス

MIT