DocBase の MCP と CLI、使い分けは「誰がどこから使うか」 ![ChatGPT Image 2026年5月29日 10\_31\_09.png](https://image.docbase.io/uploads/7c3d419a-0a88-4ec4-bb97-b6564362ab60.png =WxH) ## はじめに 「DocBase MCP と DocBase CLI、結局どっちを使えばいいの?」──特にAIコーディングエージェントでのMCPのコンテキスト消費が気になっていた方へ。 こんにちは!クレイの天野です。DocBaseのプロダクトオーナーをしています。 DocBaseの本質は「チームのナレッジが集まる場所」。議事録・仕様書・日報・問い合わせ履歴などをためて共有するサービスです。最近は人だけでなく、AIエージェントからもそのナレッジを活用したいというニーズが増えています。 たとえば、DocBaseに仕様書・議事録・問い合わせ対応履歴がたまっていれば、AIに「この仕様に沿って実装して」「過去の問い合わせ傾向を要約して」「このリリース内容を社内向けにまとめて」と頼めます。 DocBase CLI をリリースしてから約3か月。`patch-body`(メモの部分更新)などの新しいAPIが乗り、MCPは複数チームに対応できるようになりました。 「Claude CodeやCursorからDocBaseにある仕様書を確認したい」「社内で使っているChatGPTからもDocBaseのメモを分析したり更新したい」──そんな声に対して、DocBaseは現在 **DocBase MCPサーバー**・**DocBase CLI**・**公開REST API** の3つを提供しています。 このうち特に疑問となるのが、「**DocBase MCP と DocBase CLI、どう使い分ければいいの?**」という点。例えば、AIコーディングエージェントを使うときの**MCPのコンテキスト消費**が気になっていた方も多いはずです。 この記事では、改めてMCPとCLIそれぞれの強みと、最近のアップデートを踏まえた使い分けの考え方を整理します。 ## 1. リモートMCPがあるのに、なぜCLIを出すのか ### 結論:MCPとCLIは「代替」ではなく「補完」 先に結論を書きます。 **MCPとCLIは「どちらが優れているか」ではなく、「使う場面が違う」**ということです。大まかな目安として、ChatGPTやClaude.aiのようなブラウザ上のAIアプリではMCPが使いやすく、Claude CodeやCursorのようにターミナルやプロジェクトファイルにアクセスできるAIコーディングエージェントではCLIが活きます。どちらからでもDocBaseの情報を引き出せる状態を作りたかった、というのがCLIを出した一番の理由です。 ![ChatGPT Image 2026年5月29日 09\_39\_33.png](https://image.docbase.io/uploads/acf42135-22ef-4ee3-b80b-881a70596edb.png =WxH) ### 近い考え方の先例:MicrosoftのPlaywright 近い考え方を取っている先例として、MicrosoftのPlaywrightがあります。ブラウザ自動化ツールのPlaywrightは、MCPサーバー(`@playwright/mcp`)とCLI(`@playwright/cli`)の**両方**を公式に提供しています。MCPはブラウザの状態を保ちながらページ構造を調べる用途に、CLIはトークン効率を重視する用途に向く——同じ土台を持ちつつ役割で使い分ける、補完関係です。 DocBaseでも、MCPサーバーを運用する中で同じ「補完」の必要性を実感していました。 たとえば、こんなことがありました。Claude Code に長文の仕様書メモをレビューさせようとして、MCP経由でメモを読み込ませたときのことです。 - ツール結果が約10万文字に達し、トークン上限を超過 - 超過分は一時ファイルに自動保存されるが、その一時ファイルさえも Read ツールの上限(25,000トークン)を超えて開けない - 結局 Bash から `jq` で中身を取り出すという回り道に 「メモを1本読ませたいだけ」なのに、ここまで遠回りすることになる。一方、CLIなら `docbase posts get > file.json` の1コマンドで完了します。出力は直接ファイルに書き込まれ、会話コンテキストを一切消費しません。この差を体感したとき、「MCPだけでは足りない場面がある」と確信しました。 なお、**書き込み・更新時のレスポンス肥大**については、2026年5月にリリースした[公開APIの部分更新と本文除外オプション(`exclude_body`)](https://help.docbase.io/posts/4126290)で、MCP側もかなり改善されています。※同じ機能でも表記はインターフェースごとの慣習に合わせています(CLIは `patch-body` / `--exclude-body`、MCPツールは `patchPostBody` / `excludeBody`、REST APIは `exclude_body`)。詳しくはセクション2で触れます。 ### 「MCPかCLIか」ではなく「誰がどこから使うか」 最近は、コーディングエージェントではCLIの方が効率的ではないか、という議論もあります。コンテキスト消費やトークン効率の観点には、確かにうなずける部分もあります。 ただ、この議論は **「ユーザーが使うAI環境は1種類だけ」** という暗黙の前提に立っています。現実のチームを見渡すと、そうではありません。 - 企画やマーケのメンバーは、Claude.ai や ChatGPT で議事録から提案書のたたきを作りたい - エンジニアは、Claude Code や Cursor で設計書を参照しながらコードを書きたい - カスタマーサクセスは、Web上のAIアシスタントで過去の問い合わせ履歴を引きたい 全員に共通するのは「DocBaseのナレッジを使いたい」こと。違うのは **届け方** です。 ここで「CLIだけで十分」と言ってしまうと、Claude.ai や ChatGPT のユーザーは DocBase に直接アクセスする手段を失います。逆に「MCPだけで十分」と言えば、Claude Code や Cursor の長時間セッションでコンテキストが圧迫される問題が残ったままになります。**どちらを捨てても、誰かが取り残される。** だから DocBase は **「MCPもCLIも両方持つ」** というポジションを取っています。「MCP vs CLI」は二者択一ではなく、**どの環境にも届けるための二つの手段** です。AIにとって最も使いやすい外部データソースであり続けることが、DocBase の価値を高めると考えています。 ## 2. DocBase MCP と DocBase CLI の違いを整理する ### DocBase MCPサーバーとは **DocBase MCPサーバー**は、Claude.aiやChatGPTといった**AIアプリ**からDocBaseに接続するためのリモートMCPサーバーです。URLを追加してOAuthで認証するだけで使い始められ、非ターミナル環境のユーザーやチーム横断利用に向いています。 2026年4月のアップデートで `https://mcp.docbase.io/mcp/{teamname}` のようにチーム名付きのURLにも対応しました。Claude Webのように同一URL(エンドポイント)のMCPサーバーを重複登録できないツールでも、チームごとにURLが分かれるため複数チームを同時に連携できます。 ### DocBase CLIとは **DocBase CLI**は、Claude CodeやCursorなどの**AIコーディングエージェント**や、CI/CDスクリプトからDocBaseを操作するためのコマンドラインツールです。npmで配布されており、AIエージェントは `--help` を読むだけで使えるので、MCPと比べてコンテキスト消費が圧倒的に少ないのが特徴です。 2026年5月リリースのv1.0.0で `patch-body`(部分更新)と `--exclude-body`(本文除外)に対応し、さらに6月末のv1.1からは作成・更新系レスポンスの本文除外が既定になりました。長文メモを扱うシナリオを、意識しなくても軽量に処理できます。 ### 3秒でわかる使い分け 迷ったら、まずはこう考えてください。 - ブラウザ上のAIアプリから使うなら **MCP** - コード作業・CI/CD・長文処理に組み込むなら **CLI** - 独自アプリから細かく制御したいなら **REST API** ### MCPとCLIの比較表 | | DocBase MCPサーバー | DocBase CLI | |---|---|---| | **対象ユーザー** | AIアプリ(Claude.ai、ChatGPT等)の一般ユーザー | AIコーディングエージェント(Claude Code、Cursor等)/ エージェント開発者 | | **認証** | OAuth(ユーザーが意識しない) | OAuth or APIトークン(開発者が管理) | | **セットアップ** | URLを追加するだけ(`/mcp/{team}` でチーム別登録も可) | `npm install -g @krayinc/docbase-cli@latest` + 認証設定 | | **コンテキスト消費** | ツール定義や結果が会話コンテキストを消費する。接続先やクライアントによって大きくなることがある | `--help` を読むだけ(数百トークン) | | **大きなデータの取得** | レスポンス肥大は `excludeBody` で緩和。読み込みはトークン上限に注意 | シェルリダイレクトでファイルに逃がせるため、会話コンテキストを圧迫しにくい | | **大きなデータの更新** | `patchPostBody` で行単位の部分更新が可能 | `patch-body` で行単位の部分更新が可能 | | **スクリプト連携** | MCP単体ではシェルパイプやCI/CDには向かない | パイプや `jq` と組み合わせ可能 | | **IP制限環境での利用** | IP制限の対象外(管理画面で利用統制) | OAuth認証時は対象外。APIトークン利用時は対象 | | **メンテナンス** | サーバー側で一元管理 | ユーザーがCLIを更新する必要あり | 表にすると整然と見えますが、正直なところ、私自身はターミナルにいる時間が長いのでCLIに手が伸びがちです。一方で、エンジニアでないメンバーにDocBase×AIを試してもらうときは、URLを渡すだけで済むMCP一択でした。セットアップ不要でスマホからでも使える手軽さは、現場に広げるうえで想像以上に効きます。この「人によって最短ルートが違う」という手触りこそが、両方を持つ理由そのものだと感じています。 ### CLIでワークフローを組む例 CLIの真価は、複数の操作をパイプやスクリプトでつないでエージェントのワークフローを組める点にあります。たとえばClaude CodeやCursorで「DocBaseを検索 → コードを書く → 結果をDocBaseにメモ」という一連の流れも、軽量なコマンドの組み合わせで実現できます。 ```bash # DocBaseのメモを検索 docbase posts search -q "認証フロー" # 検索結果をもとにメモを作成(レスポンスは既定で本文が除外され軽量) docbase posts create --title "設計メモ" --body-file ./body.md --draft # 長文メモの特定の行だけを差分更新 docbase posts patch-body 12345 \ --op '{"start":2,"end":2,"old_content":"旧","content":"新"}' ``` AIコーディングエージェントがこれらのコマンドを必要に応じて呼び出すだけなので、コンテキストを圧迫しません。 なお、`patch-body` と `--exclude-body` は **CLI v1.0.0以降** で利用可能で、CLI v1.1 / MCPサーバー v1.2(2026年6月末)からは作成・更新系レスポンスの本文除外が既定になりました(本文が必要なときだけ `--include-body` を指定)。既にインストール済みの方は `npm install -g @krayinc/docbase-cli@latest` で更新してください。MCP経由でも `patchPostBody` ツールと `createPost`/`updatePost` の本文除外(既定)として利用できます。 ## 3. どちらを使うべきか──使い分けの目安 どちらを使うか迷ったら、以下を目安にしてみてください。 ![ChatGPT Image 2026年5月29日 09\_41\_59.png](https://image.docbase.io/uploads/5ced4325-e1f0-4d49-a1dd-8a9cef873b0b.png =WxH) **MCPがおすすめのケース** - ChatGPTやClaude.aiなど、AIアプリからサッとDocBaseの情報を引き出したいとき - セットアップに手間をかけたくないとき(URLを追加するだけ) - 認証管理を個々のユーザーに委ねず、OAuthで一元化したいとき - セットアップやバージョン管理の運用コストを最小限にしたいとき - **複数のDocBaseチームを同じAIアプリから使い分けたいとき**(`/mcp/{team}` でチームごとに別URLとして登録でき、Claude Webのように同一URLのMCPを重複登録できないツールでも複数チーム連携が可能) **CLIがおすすめのケース** - AIコーディングエージェントで長時間の作業セッションを行い、コンテキスト消費を抑えたいとき - CI/CDやシェルスクリプトにDocBase連携を組み込みたいとき - 複数のツールをパイプでつないで、エージェントのワークフローを構築したいとき - 大きなメモの読み込みや、長文メモの差分更新を頻繁に行うケース もちろん、**チーム内でMCPとCLIを併用する**のが最も柔軟です。企画・営業メンバーはMCPで、開発チームはCLIで──同じDocBaseのナレッジにそれぞれ最適な方法でアクセスできます。 ## 4. これからのDocBaseとAI連携 MCPとCLIの2つが揃ったことで、DocBaseへのアクセス手段は3つになりました。 | アクセス手段 | 想定ユーザー | 強み | |---|---|---| | **DocBase MCPサーバー** | AIアプリ(Claude.ai、ChatGPT等)ユーザー | URLを追加するだけ(ブラウザ完結)。チーム別URL対応。普段使いのAIアプリ(ChatGPT/Claude.ai)で動く | | **DocBase CLI** | AIコーディングエージェント(Claude Code、Cursor等)/ エージェント開発者 | コンテキスト消費が少ない。シェルリダイレクトや `jq` との連携で、長文メモの読み込みやCI/CD組み込みに強い | | **公開REST API** | 独自アプリ開発者 | 独自アプリ・高度な自動化に最も柔軟 | DocBaseの本質は「チームのナレッジが集まる場所」です。これまでもそうでしたし、これからもそうです。 ただ、これからは人間だけでなく、さまざまなAIエージェントもチームのナレッジを必要とするようになります。社内で使われるAIが増えていく中で、AIからも簡単にアクセスできることが当たり前になっていく。 だからこそDocBaseが目指しているのは、**「AIにとって最も使いやすい外部データソース」**になることです。 チームのナレッジはAIにとって最も価値の高い外部データのひとつです。どのAI環境からでも、最適な方法でチームの知見を活用できる。MCP・CLI・APIの3つの手段が揃い、`patch-body`/`exclude_body` などの基盤強化や、MCPの複数チーム対応も進んだことで、その土台が着実に固まってきました。 ## おわりに 「MCPかCLIか」ではなく、「**誰がどこから使うか**」。──これが本記事を通してお伝えしたかったことです。 MCPは「ブラウザだけで使える手軽さ」と「普段使いのAIアプリ(ChatGPT/Claude.ai)でそのまま動く」ことが強み。CLIは「コンテキスト消費の少なさ」と「シェル・CI/CD と自然に連携できる」ことが強み。どちらも欠かせない、補完関係の二つの手段です。 これからは人だけでなく、AIもチームの一員としてナレッジを使う時代になります。どのAI環境からアクセスするAIにも知見が開かれている──DocBaseがMCPもCLIも両方持つのは、その状態に一歩でも近づくためです。 DocBase MCPサーバーは管理画面の「AI機能管理 → 外部AIアプリ連携」から、DocBase CLIは npm からそれぞれ導入できます。 ```bash npm install -g @krayinc/docbase-cli@latest ``` 詳しいセットアップ手順は [DocBase CLIヘルプ](https://help.docbase.io/posts/4077653) をご覧ください。Claude CodeやCursorなどのAIコーディングエージェントをお使いの方は、ぜひ試してみてください。