MCP server

概要

Geneziz はナレッジベースを AI アシスタントに公開する MCP (Model Context Protocol) server を同梱しています。ローカルの stdio server として、AI クライアントのサブプロセスとしてあなたのマシン上で実行され、設定するポートはなく、ローカルの Markdown ファイルを直接読み取ります。ナレッジベースがあなたのマシンから外に出ることはありません。

サーバーは**34 のツールと 4 つの knowledge:// リソース（stats、index、trends、categories）**を、機能ごとにグループ化して公開します:

• 検索 - キーワード、セマンティック、関連項目、重複、最近の項目のルックアップ
• 一覧 - ツール、記事、タグ、カテゴリ、ドメイン
• 1 項目の読み取り - ツール・記事・ブックマークの全文と統計
• 質問 + メモリループ - ナレッジベース全体への Q&A、保存済み会話として繋げられるフォローアップ付き
• 書き込み - アシスタントからのリンク保存、ノート追加、TL;DR 生成
• キュレーションと安全な編集 - 一括整理、タグ付け、frontmatter 編集、再ファイリング、アーカイブ/復元、取り消し
• 自己改善 - 品質スキャン、ギャップ修復、wiki 相互リンク、重複チェック、リンクエンリッチ
• リソース - knowledge://stats、knowledge://index、knowledge://trends、knowledge://categories

ask_kb は出典付きでナレッジベース全体への質問に回答し、conversation_id でフォローアップを保存済みの会話に繋げられます。質問は Geneziz AI プロキシ 経由で1 問あたり 1 クレジットかかります。ご自身の API キー（BYOK）なら無料です。AI モード をご覧ください。

有効化

MCP には**有効化された Geneziz アカウント（$99 の一回払いライセンス）**が必要で、あなたのマシン上でローカルに実行されます。登録 - 以下の設定エントリの書き込み - にはライセンスは不要ですが、サーバーの起動には必要です。

自動セットアップ

geneziz mcp register

このコマンドはマシン上の対応 AI クライアントを検出し、それぞれの設定ファイルにサーバーエントリを書き込みます: Claude Desktop、Claude Code、Cursor、Windsurf、Codex、VS Code、ZCode、OpenCode。各エントリには geneziz 実行ファイルへの絶対パス、mcp 引数、データディレクトリを指す GENEZIZ_DATA_DIR 環境変数が書き込まれるため、PATH の設定は不要です。書き込まれるのは geneziz のエントリだけで、他の MCP サーバーには一切触れず、最初の変更の前に各設定の 1 回限りのバックアップが作成されます。

登録の確認または取り消し:

geneziz mcp register --status        # クライアントごとの登録状態を JSON で出力
geneziz mcp register --remove --all  # Geneziz のエントリのみ削除

手動セットアップ

以下のどのクライアントも、そのクライアントの設定ファイルに合わせた形の同じサーバー定義 - コマンド geneziz、引数 mcp - を受け付けます。geneziz 実行ファイルが PATH 上にある必要があります（自動登録は代わりに絶対パスを書き込むため、この要件はなくなります）。

Claude Code

~/.claude.json の mcpServers の下に geneziz エントリを追加します:

{
  "mcpServers": {
    "geneziz": {
      "command": "geneziz",
      "args": ["mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json の mcpServers の下に同じエントリを追加します:

{
  "mcpServers": {
    "geneziz": {
      "command": "geneziz",
      "args": ["mcp"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json の mcpServers の下に同じエントリを追加します:

{
  "mcpServers": {
    "geneziz": {
      "command": "geneziz",
      "args": ["mcp"]
    }
  }
}

ZCode

ZCode はネストした mcp.servers 形を読み取り、"type": "stdio" が必要です。~/.zcode/cli/config.json に geneziz エントリを追加します:

{
  "mcp": {
    "servers": {
      "geneziz": {
        "type": "stdio",
        "command": "geneziz",
        "args": ["mcp"]
      }
    }
  }
}

環境変数のピン留め

AI クライアントが geneziz mcp を起動して空のナレッジベースを見つけた場合は、エントリに GENEZIZ_DATA_DIR 環境変数を追加し、データディレクトリを指してください（macOS では例えば ~/Library/Application Support/Geneziz）。自動登録は常にこのピンを書き込みます - vault をご覧ください。

試してみる

新しいセッションで、保存に関わる質問をしてみてください:

Rust の async 向けにどんなツールをブックマークしましたか?

アシスタントはローカルのナレッジベースを検索し、タイトル・カテゴリ・スニペット付きで回答します。手順の全体は Setting up the Geneziz MCP server with Claude Code（英語）を、製品の残りの部分は 概要 をご覧ください。料金は /landing#pricing にあります。