メインコンテンツへスキップ

​
前提条件

  • Node.js 20+
  • MCP 対応クライアント（Claude Desktop、Claude Code、Cursor、VS Code 等）

​
インストール

インストール不要です。MCP クライアントを npx 経由で実行するよう設定します：
{
  "mcpServers": {
    "cohaku": {
      "command": "npx",
      "args": ["-y", "@cohaku/cli", "mcp"]
    }
  }
}

​
自動セットアップ（推奨）

@cohaku/cli をグローバルインストール済みの場合： 
cohaku init
これにより以下が実行されます：
  1. データベースの初期化
  2. インストール済み AI ツール（Claude Code、Cursor、VS Code、Windsurf 等）の自動検出
  3. 検出された各ツールへの MCP サーバー登録
対応する12ツールの一覧はインテグレーションをご覧ください。

​
手動セットアップ

手動で設定する場合は、各インテグレーションガイドをご覧ください：

Claude Code

Claude Desktop

Cursor

VS Code

Windsurf

OpenCode

​
接続の確認

MCP クライアントを起動し、Cohaku のツールが表示されることを確認してください。add_memory、search_memories、get_context、session_start、generate_claude_md など、24のツールが表示されるはずです。

​
初回利用

接続が完了すると、AI エージェントはすぐに Cohaku を使い始めることができます： 
Agent: "このプロジェクトは React 19 と TypeScript を使っていることを覚えておいて"
→ calls add_memory({ content: "Project uses React 19 with TypeScript", layer: "rule", type: "rule" })

Agent: "このプロジェクトについて何を知っている？"
→ calls search_memories({ query: "project" })
→ returns the stored memory with relevance score

​
CLI コマンド

グローバルインストール済みの場合、cohaku CLI ですべてのメモリ操作が可能です：
コマンド説明
cohaku initデータベースの初期化と検出ツールへの MCP 登録
cohaku memory add新しいメモリを保存
cohaku memory searchメモリを検索
cohaku memory context優先度順のコンテキストを読み込み
cohaku graph entity addナレッジグラフにエンティティを追加
cohaku graphナレッジグラフを検索
cohaku generate <tool>メモリをエディタ設定ファイルにエクスポート
cohaku statusメモリの統計情報を表示
コマンドの全一覧は CLI リファレンスをご覧ください。

​
設定

デフォルトのデータベースパスは ~/.config/cohaku/memory.db です。環境変数で変更できます：
変数デフォルト説明
COHAKU_DB_PATH~/.config/cohaku/memory.dbSQLite データベースファイルのパス

​
次のステップ