Rootr

Rootr CLI + MCP サーバー

チームのナレッジベースを Claude、ChatGPT、あらゆる AI エージェントに接続できます。

Rootr は、チーム向けのナレッジおよびドキュメントのワークスペースです。このパッケージは、AI エージェントにチームで共有するドキュメント、構造化データ、組織の知識への直接的かつ権限に基づいたアクセスを提供する公式の方法です。会話のたびにコンテキストをコピー＆ペーストしなくても、アシスタントがチームの知識をあらかじめ把握できます。

接続方法は 2 つあります。

1. リモートコネクター — インストール不要（推奨）

Rootr は Streamable HTTP 経由でリモート MCP エンドポイントをホストしています。Claude Desktop、claude.ai、または ChatGPT で、URL を指定して OAuth でサインインするだけでコネクターを追加できます。

https://rootr.io/mcp

JSON も CLI も、貼り付けるトークンも必要ありません。ログインしてワークスペースを選ぶと、既存の権限に基づいてチームのドキュメントをアシスタントから利用できます。ドキュメントをご覧ください。

2. ローカル CLI／stdio MCP サーバー（rootr-cli）

シェルを使用する場合や、ローカルの stdio MCP サーバーと通信するエージェント（Claude Code など）を使用する場合：

npm install -g rootr-cli
rootr config --api-key rootr_xxxx --workspace ws_xxx
rootr mcp          # start the stdio MCP server

rootr コマンドは単体でも使用できます：ls、read、write、append、edit、search、ask、ws、config。

ビルド手順不要の、純粋な Node.js ESM です。Node 18 以降が必要です（組み込みの fetch を使用します）。

• ホームページ： https://rootr.io
• ドキュメント： https://rootr.io/en/docs
• npm： https://www.npmjs.com/package/rootr-cli

---

インストール

クローンから直接実行するか、グローバルにインストールします。

npm install -g rootr-cli
rootr --help

# or from source
cd cli && npm install
node bin/rootr.js --help

設定

優先順位：環境変数 > ~/.rootr/config.json

環境変数	設定キー	説明
ROOTR_API_KEY	apiKey	rootr_... 形式の API キーです。各リクエストの x-api-key ヘッダーとして送信されます。
ROOTR_WORKSPACE	workspace	ワークスペース ID
ROOTR_BASE_URL	baseUrl	デフォルトは https://rootr.io/api/v1 です。

設定ファイルに保存します（chmod 600 を指定して作成されます）。

rootr config --api-key rootr_xxxxxxxxxxxxxxxx --workspace ws_123
# optional on-prem / dev base URL
rootr config --api-key rootr_xxx --workspace ws_123 --base-url https://dev.rootr.io/api/v1

rootr config          # show current config (api key shown masked)

2 種類のキー

Rootr の API キーには 2 種類あり、特定のキーが必要なツールもあります。

• ワークスペースキー — 単一のワークスペースに限定されます （docs:read／docs:write／graph:read／ask／webhooks:manage）。ほとんどのドキュメント、LOG、課題、Webhook、ask ツールで十分です。
• アカウントキー（PAT） — アカウント全体で使用できます。workspaces:create スコープがあれば、新しいワークスペースを作成できます（rootr_create_workspace）。アカウントレベルの操作にワークスペースキーを使用すると、アカウントキーが必要であることを示すヒント付きで 403 が返されます。

CLI の使用方法

パスのルール：/ で始まる引数はパスとして扱われます（by-path API を通じてノード ID に解決されます。ワークスペースの設定が必要です）。それ以外はノード IDとして扱われます。

rootr ls                                   # whole tree  (TYPE<TAB>path)
rootr ls /notes                            # subtree

rootr read /notes/todo.md                  # markdown to stdout
rootr read /notes/todo.md --json           # full JSON incl. metadata

echo "# Title" | rootr write /notes/new.md # full replace (creates if missing)
rootr write /notes/new.md --file ./local.md

rootr append /notes/log.md "Deployed today"          # safe, conflict-free
rootr append /notes/log.md "- one more" --heading "## Todo"

rootr edit /notes/todo.md --find "- [ ] ship" --replace "- [x] ship"

rootr search "deploy runbook"              # path — snippet
rootr ws                                   # list workspaces (id<TAB>name)
rootr ask "why did latency go up after last week's deploy?"

append はドキュメント全体を書き換えないため、並行して安全に実行できます。write はオプティミスティック同時実行制御用の --if-match "\"etag\"" をサポートします（412 はドキュメントがその間に変更されたことを意味します。再読み込みして再試行してください）。edit は --find が見つからない場合、または一致が一意でない場合に 409 を返します。すべての一致を置換するには --all を指定してください。ask はワークスペースのナレッジグラフ（GraphRAG）をクエリし、回答と引用（ドキュメントパス：引用文）を出力します。

MCP サーバーとして使用する

rootr mcp は、stdio 経由で Model Context Protocol サーバーを起動します。Rootr の全機能にわたる 80 以上のツールを公開するため、エージェントはあらゆるノードタイプを作成・検索できます。

グループ	ツール（例）
ドキュメント	rootr_list、rootr_read、rootr_append (推奨、競合なし)、rootr_edit、rootr_write、rootr_search、rootr_document_versions、rootr_delete_node、rootr_duplicate_node
公開とコメント	rootr_publish_document、rootr_set_document_public、rootr_document_public_status、rootr_comment_document、rootr_list_document_comments
ワークスペースとひな形作成	rootr_workspaces、rootr_scaffold_plan、rootr_create_workspace、rootr_scaffold_apply
データベース（型付き列＋ボード／テーブルビュー）	rootr_read_database、rootr_add_row、rootr_update_row、rootr_delete_row、rootr_list_rows
スプレッドシート（数式）	rootr_create_spreadsheet、rootr_read_spreadsheet、rootr_update_spreadsheet、rootr_create_sheet、rootr_update_sheet、rootr_delete_sheet、rootr_patch_spreadsheet_cells
ホワイトボード	rootr_create_whiteboard、rootr_read_whiteboard、rootr_update_whiteboard
フォーム	rootr_create_form、rootr_read_form、rootr_update_form、rootr_list_form_responses、rootr_submit_form_response、rootr_create_form_share_link、rootr_list_form_share_links
CRM	rootr_crm_* — 企業、連絡先、取引（カンバン）、アクティビティ、タスク、CSV インポート
プレゼンテーション	rootr_create_presentation、rootr_read_presentation、rootr_update_presentation、rootr_update_presentation_slide、rootr_append_presentation_slides、rootr_reorder_presentation_slides
LOG データストア	rootr_create_log_store、rootr_update_log_fields、rootr_add_log_entries、rootr_query_log_entries、rootr_log_stats
課題	rootr_create_issue_tracker、rootr_list_issues、rootr_create_issue、rootr_get_issue、rootr_update_issue、rootr_comment_issue
Webhook	rootr_list_webhooks、rootr_create_webhook、rootr_delete_webhook
GraphRAG 質問	rootr_ask — ナレッジグラフを対象に、引用付きで自然言語による根本原因の質疑応答を行います
画像	rootr_generate_image、rootr_remove_image_background

ツールの説明では、破壊的な rootr_write よりも rootr_append / rootr_edit を優先するようエージェントに促しています。workspace 引数を取るツールでは、その引数が省略された場合、ROOTR_WORKSPACE（または設定のデフォルト値）が使用されます。すべてのツールスキーマは英語です。JSON を返すツールは、整形済みの JSON テキストを返します。

Claude Code / Claude Desktop に登録する

~/.claude.json（Claude Code）または Claude Desktop の MCP 設定に追加します。

{
  "mcpServers": {
    "rootr": {
      "command": "rootr",
      "args": ["mcp"],
      "env": {
        "ROOTR_API_KEY": "rootr_xxxxxxxxxxxxxxxx",
        "ROOTR_WORKSPACE": "ws_123"
      }
    }
  }
}

（グローバルにインストールしていない場合は、"command": "node" と "args": ["/path/to/rootr-cli/bin/rootr.js", "mcp"] を使用してください。）

エラー処理

2xx 以外のレスポンスの場合、CLI は API の message（存在する場合）を stderr に出力し、終了コード 1 で終了します。

• 401 / 403 — API キー／ワークスペースのスコープを確認してください
• 412 — 読み取り後にドキュメントが変更されています（If-Match の不一致）。再読み込みして再試行してください
• 409 — サーバーの理由がそのまま表示されます（例：edit の検索対象が見つからない／一意でない）

構成

• bin/rootr.js — エントリーポイント、コマンドのディスパッチ
• lib/config.js — 設定の読み込み／保存
• lib/client.js — Rootr REST API クライアント
• lib/resolve.js — パス／ID の共通ターゲット解決
• lib/mcp.js — MCP stdio サーバー、すべてのツールグループを組み立てます
• lib/mcp-tools/* — ツールグループごとのモジュール（ドキュメント、ワークスペース、データベース、 スプレッドシート、ホワイトボード、フォーム、crm、プレゼンテーション、ログ、課題、webhooks、ask、misc）

依存関係：@modelcontextprotocol/sdk（MCP サーバー）と zod（ツール入力スキーマ）。CLI のコアに外部依存関係はありません。ビルド工程は不要で、純粋な ESM JavaScript です。

---

Inspirio 製 · rootr.io · [email protected]