Geneziz MCP サーバーを Claude Code で設定する方法
なぜ Geneziz を AI アシスタントに繋ぐのか？
あなたは X.com でブックマークを厳選し、GitHub でリポジトリにスターをつけ、Geneziz ですべてを構造化されたナレッジベースに整理するのに何時間も費やしてきました。しかしコードを書くために IDE を開くと、そのナレッジは見えません ーー 別のアプリに閉じ込められています。
Model Context Protocol（MCP） がこれを変えます。MCP に対応した任意の AI アシスタントが、ターミナルやチャットインターフェースから直接、あなたの Geneziz ナレッジベースをリアルタイムにクエリできるようにします。
このガイドでは Claude Code（最も普及している MCP 対応 AI アシスタント）で Geneziz MCP サーバーを設定する手順を説明しますが、同じ手順は Cursor、Windsurf、その他の MCP 対応ツールでもそのまま使えます。
前提条件
始める前に、以下を確認してください。
- Geneziz がインストール済みで、少なくとも 1 回の同期が完了していること（
geneziz fetch+geneziz processを少なくとも一度実行） - 有効なライセンスキー（
GNZ-またはGNZD-プレフィックス ーー すべてのライセンスに MCP サーバーが含まれます） - ナレッジディレクトリにツール、記事、またはブックマークが入っていること
- Node.js 18 以上（MCP サーバー実行用）
セットアップが正しいか、次のコマンドで確認できます。
geneziz status
ツール、記事、ブックマークの数が 0 ではないことを確認してください。
ステップ 1：MCP サーバーを起動する
Geneziz の MCP サーバーは CLI に組み込まれています。ターミナルを開いて次を実行します。
geneziz mcp
これにより MCP サーバーが stdio（標準入出力）で起動します。ほとんどの AI アシスタントはこの方法で MCP サーバーと通信します。
次のような出力が表示されるはずです。
MCP server starting...
Listening on stdio...
このサーバーは AI アシスタントに対して次のツールを公開します。
| ツール | 機能 |
|---|---|
search_knowledge | ナレッジベース全体のセマンティック + キーワード ハイブリッド検索 |
get_tool | slug で特定のツール／記事を取得 |
get_article | 記事の全文を読む |
list_categories | ナレッジベース内のすべてのカテゴリーを閲覧 |
get_recent | 最近追加されたアイテムを取得 |
ステップ 2：Claude Code を MCP 用に設定する
Claude Code はネイティブで MCP をサポートしています。Geneziz サーバーをその設定に追加する必要があります。
方法 0：geneziz mcp register（推奨）
Geneziz に任せましょう。1 つのコマンドで、マシン上で検出されたすべての AI クライアント ーー Claude Code を含む ーー に MCP サーバーを登録します。
geneziz mcp register
このコマンドは、各クライアントの設定（Claude Code なら ~/.claude.json）に geneziz サーバーのエントリを書き込みます。Geneziz 実行ファイルへの絶対パスと GENEZIZ_DATA_DIR 環境変数のピンが使われるため、PATH を設定しなくてもサーバーが起動し、データディレクトリを常に見つけられます。変更されるのは Geneziz 自身のエントリのみ ーー 同じファイル内の他のサーバーはそのまま維持され、変更の前に 1 回限りのバックアップが書き込まれます。何が行われたかは次のコマンドで確認できます。
geneziz mcp register --status
取り消すときは、いつでも geneziz mcp register --remove --all を実行してください（削除されるのは Geneziz のエントリだけです）。エントリを自分で確認したり設置したい場合は、以下の手動の方法を使ってください。
方法 A：Claude Code の設定から
- Claude Code を開く
/を押してコマンドパレットを開く- MCP または Manage MCP Servers と入力
- Add Server をクリック
- 次を入力：
- Name:
Geneziz - Command:
geneziz mcp - Type:
stdio
- Name:
- Save をクリック
方法 B：.claude/settings.json から
ホームディレクトリの ~/.claude/settings.json を作成または編集します。
{
"mcpServers": {
"geneziz": {
"command": "geneziz",
"args": ["mcp"],
"type": "stdio"
}
}
}
ステップ 3：接続をテストする
新しい Claude Code セッションを開くか（または Cursor／Windsurf でチャットを始め）、試してみましょう。
「ナレッジベースから React のパフォーマンス最適化に関する記事を検索して」
すべてが正しく設定されていれば、AI アシスタントは search_knowledge ツールを呼び出し、ローカルのナレッジベースをクエリして、関連する結果 ーー タイトル、カテゴリー、スニペット付き ーー を返します。
こんなテストクエリも試してみてください。
- 「ナレッジベースに保存したツールは何がある？」
- 「Python に関する最近の記事を見せて」
- 「ナレッジベース内のすべてのカテゴリーを一覧表示して」
裏側でどう動くか
ツール呼び出しをトリガーする質問をしたとき：
- Claude Code が
geneziz mcpプロセスに JSON-RPC リクエストを送信 - MCP サーバーが
viewer-index.jsonとナレッジファイルを読み取る - 結果が構造化データ（タイトル、slug、カテゴリー、本文）として返される
- Claude Code が結果を自然言語の回答にまとめる
これらはすべてローカルで行われます ーー データがあなたのマシンから外に出ることはありません。MCP サーバーは、SQLite FTS5 全文検索または ChromaDB ベクトル検索（どちらもすべてのライセンスに含まれます）を使って、ナレッジディレクトリから直接読み取ります。
よくある問題
"Command not found: geneziz"
Geneziz のデスクトップアプリがインストールされているか確認してください。インストーラーが geneziz CLI を PATH に追加します。それでもコマンドが見つからない場合は、最新版を再インストールして新しいターミナルを開き、次のコマンドで確認してください。
geneziz --help
"No tools found"
まず geneziz index を実行してビューアーインデックスを生成してください。
geneziz index
geneziz status # ツール／記事が 0 より大きいか確認
"License error: no active license"
MCP サーバーはすべての Geneziz ライセンス ーー GNZ- キーも GNZD- キーも機能します ーー に含まれていますが、有効でアクティベート済みのライセンスが必要です。キーが入力されており、デバイスがアクティベート済みであることを確認したうえで、チェックしてください。
geneziz license --check GNZ-YOUR-KEY-HERE
ポートがすでに使用中
別の geneziz mcp プロセスが動いている場合は、まず終了させてください。
# 既存のプロセスを見つけて終了
pkill -f "geneziz mcp"
# そのあと再起動
geneziz mcp
次のステップ
MCP サーバーが起動して接続できたら：
- AI アシスタントの起動設定に追加し、毎セッション自動で接続するようにする
- 自分のブックマークについて質問してみる ーー 思いがけないものが見つかるはず
geneziz syncと組み合わせて、毎回のコーディングセッションの前にナレッジベースを最新に保つ
シェアのメモ
この投稿は Geneziz ブログシリーズの一部です。役に立ったら、ブックマークに溺れている開発者にシェアしてください。