ガイド · 約 3 分

Onplana を Gemini CLI と Code Assist に接続する方法

インストールは一行です。Onplana はリポジトリのルートに Gemini の拡張機能マニフェストを含めているので、設定はこれだけです：gemini extensions install <repo>。

その後は Gemini に「Onplana で遅れている自分のタスクをまとめて」「Q3 のローンチのプロジェクト計画を、週ごとのマイルストーン 5 個で作成して」「データプラットフォームのプロジェクトにいるチームメンバーを一覧にして」と頼めば、Gemini が Onplana の中で直接実行します。

Onplana を開く → 設定 → エージェント GitHub の Gemini CLI

要点：三つのコマンド

# 1. Set your Onplana token
export ONPLANA_PAT=pat_paste-your-token-here

# 2. Install the extension
gemini extensions install https://github.com/Onplana/onplana-mcp-server

# 3. Restart and verify
gemini
> list my Onplana projects via the onplana tool

詳しい手順は下にあります。

五つのステップの詳細

  1. 1

    Gemini CLI をインストールする（まだの場合）

    macOS / Linux では npm install -g @google/gemini-cli。Windows では、Node が使えるコンソールで同じコマンドを実行します。`gemini --version` で確認します。VS Code や JetBrains で Gemini Code Assist を使っている場合は、必要なものはすでにそろっています。Code Assist は CLI と設定ファイルを共有しています。

  2. 2

    Onplana の接続トークンを生成する

    app.onplana.com で Onplana にサインインします。設定 → エージェント → エージェントを接続 と進み、Gemini CLI + Code Assist のタイルを選び、次に個人用アクセストークン、最後にトークンを生成して接続スニペットを表示 を選びます。個人用アクセストークン（`pat_` で始まります）をコピーします。環境変数として設定します：export ONPLANA_PAT=pat_your-token-here（設定を残すには、この行を ~/.bashrc か ~/.zshrc に追加します）。

  3. 3

    Onplana の Gemini 拡張機能をインストールする（コマンド一つ）

    次を実行します：gemini extensions install https://github.com/Onplana/onplana-mcp-server。Onplana のリポジトリはルートに gemini-extension.json マニフェストを含んでおり、Gemini CLI はそれを読んで MCP サーバーとの接続を自動で設定します。代わりに ~/.gemini/settings.json を手で編集することもできます。形式は developers.google.com/gemini-code-assist/docs に記載されています。

  4. 4

    Gemini CLI を再起動するか、エディターを再読み込みする

    Gemini CLI では、`gemini` を終了して開き直します。VS Code の Gemini Code Assist では、Cmd/Ctrl+Shift+P → "Developer: Reload Window"。JetBrains では IDE を再起動します。再起動後、Onplana のツールが /mcp の選択画面に表示されます。

  5. 5

    接続を確認する

    新しい Gemini のセッションで「list my Onplana projects via the onplana tool」と頼みます。Gemini が Onplana の list_projects ツールを呼び出し、結果を表示します。エラーが出た場合は、Gemini が使う環境に ONPLANA_PAT が設定されているか、拡張機能のマニフェストが正しくインストールされたかを `gemini extensions list` で確認してください。

手で設定することもできます

拡張機能をインストールしたくない場合は、~/.gemini/settings.json（またはワークスペースのルートの .gemini/settings.json）を直接編集します：

{
  "mcpServers": {
    "onplana": {
      "httpUrl": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      },
      "timeout": 5000
    }
  }
}

キーは httpUrl で、url ではない点に注意してください。Gemini CLI は Onplana のような Streamable HTTP のサーバーに httpUrl を使い、url は SSE のサーバー用に取ってあります。headers.Authorization の Bearer トークンがすべてのリクエストを認証します。

動作を確認する方法

新しい Gemini のセッションを開き、次のいずれかを試してください。

  • 「onplana ツールで自分のプロジェクトを一覧にして。」
  • 「自分に割り当てられた Onplana の遅れているタスクを見せて。」
  • 「プロジェクト X に『Postgres を Aurora に移行』という Onplana のタスクを作成して。」
  • 「Onplana のページから API の移行に関するメモを探して。」

gemini extensions list を実行して、Onplana の拡張機能がインストールされていることを確認します。インストールに成功すると、/mcp の選択画面に Onplana のツールの一覧全体が表示されるはずです。

よくある質問

VS Code の Gemini Code Assist でも使えますか？

はい。Gemini CLI と Gemini Code Assist は同じ設定ファイル（ユーザー全体では ~/.gemini/settings.json、ワークスペースでは .gemini/settings.json）を共有しています。`gemini extensions install` での一回のインストールで両方に対応します。その後、Code Assist が新しい設定を読み込むように VS Code のウィンドウを再読み込みしてください（Cmd/Ctrl+Shift+P → "Developer: Reload Window"）。

gemini.google.com の Gemini アプリはどうですか？

gemini.google.com は 2026 年五月の時点で、まだカスタムの MCP サーバーに対応していません。Google は、サードパーティーの MCP サーバーに接続したい利用者に Gemini CLI か Gemini Code Assist を案内しています。私たちはこの動きを追っており、アプリが MCP に対応すれば、Claude.ai に似たコネクタの画面からワンクリックでインストールできるようになります。

Gemini Enterprise / Vertex AI Agent Builder はどうですか？

Gemini Enterprise は Gemini CLI とは別の設定です。管理者が Google Cloud のコンソールで Onplana を Custom MCP Server のデータストアとして追加し、OAuth のクライアント ID とシークレットを使います。早期アクセスの段階で、管理者が行うものであり、セルフサービスではありません。Onplana が依頼に応じてお客様の組織向けのクライアントを発行します。docs.onplana.com/ai-agents/connect-onplana-to-gemini-enterprise/ のガイドに、設定、最初に有効にする 20 個のアクション、アクセスを依頼するリンクがあります。

MCP を含むのは Onplana のどのプランですか？

MCP は無料プランを含むすべてのプランで利用できます。同時に使えるエージェント接続の数はプランに応じて増え（Free 2、Professional 3、Business 5、Enterprise 10、Enterprise+ 無制限）、実際の AI の利用を制限するのはお客様の AI トークン残高（有料プランでは毎月の割り当て、Free プランでは一回限りのボーナス、それに購入したクレジット）です。プランは app.onplana.com/billing でいつでも変更できます。

gemini-extension.json でインストールするのと、settings.json を直接編集するのとでは何が違いますか？

機能の面では同じです。拡張機能のインストールはコマンド一つで、リポジトリのルートにあるマニフェストを使うので、再現できます。settings.json の手作業での編集は、同じ `mcpServers` オブジェクトの中で Onplana を複数の MCP サーバー（たとえば Onplana 用、Linear 用、社内 API 用）と並べたいときに使います。どちらも動作し、同じ設定を共有します。

キーが url ではなく httpUrl なのはなぜですか？

Gemini CLI は、stdio 経由（キー：command）、SSE 経由（キー：url）、Streamable HTTP 経由（キー：httpUrl）の MCP サーバーを区別します。Onplana の MCP サーバーは最新のトランスポート標準である Streamable HTTP を使い、SSE なしで通常の HTTPS 上でリクエストとレスポンスを扱います。Claude Desktop、Cursor、ChatGPT の設定にある `url` キーがこれに相当します。

接続を取り消せますか？

はい、方法は二つです。(1) Onplana → 設定 → エージェント → 接続 → トークンの行で失効。(2) 環境から ONPLANA_PAT を削除し、さらに `gemini extensions uninstall onplana` を実行します。どちらもすぐに有効になり、Gemini の次のツール呼び出しは 401 を返します。

Gemini はどのツールにアクセスできますか？

351 個のツールで、Claude Desktop、Cursor、ChatGPT が受け取るものと同じです。読み取り（list_projects、list_my_tasks、get_task、search_org_knowledge など）と書き込み（create_task、update_task、assign_task、create_milestone など）に加え、ガバナンス、変更管理、コンプライアンス、ドキュメント、ワークフローの領域があります。どのクライアントを接続してもカタログは同じです。一部のツールはプランによって有効になります。カタログの全体は onplana.com/mcp にあります。

関連情報