◉CLAUDE LABEN
●CC 2.1.327 — Claude Code 2.1.327(11/18)で、MCP サーバーの設定を標準入力から渡せる claude mcp add-json が加わりました●MCP.JSON — 同じ版で、project スコープの mcp add・remove が .mcp.json の他のキーを消していた問題が直りました●SONNET 4.5 — Claude API での提供終了は 11/30、残り11日。コードと保存済みのモデル設定を一度に洗い出してください●GATEWAY — 1M 文脈のモデルをゲートウェイ越しに使うと、自動圧縮が遅すぎて1回の応答に数十秒かかる、という報告が出ています●NEON — 11/18 に Gemini 4 Neon が GA。Claude Code と併用するなら、MCP の設定をツールごとに分けておくと混乱しません●NEW — Linked billing の 402 と 403、どの財布が空かを見分ける●CC 2.1.327 — Claude Code 2.1.327(11/18)で、MCP サーバーの設定を標準入力から渡せる claude mcp add-json が加わりました●MCP.JSON — 同じ版で、project スコープの mcp add・remove が .mcp.json の他のキーを消していた問題が直りました●SONNET 4.5 — Claude API での提供終了は 11/30、残り11日。コードと保存済みのモデル設定を一度に洗い出してください●GATEWAY — 1M 文脈のモデルをゲートウェイ越しに使うと、自動圧縮が遅すぎて1回の応答に数十秒かかる、という報告が出ています●NEON — 11/18 に Gemini 4 Neon が GA。Claude Code と併用するなら、MCP の設定をツールごとに分けておくと混乱しません●NEW — Linked billing の 402 と 403、どの財布が空かを見分ける
記事一覧/Claude Code
⟐ Claude Code/2026-11-19中級

Claude Code と Gemini CLI で同じ MCP サーバーを使うなら、設定は一つの正本から書き出します

Claude Code の .mcp.json を Gemini CLI に貼ると、HTTP のサーバーだけ繋がらないことがあります。url と httpUrl、変数展開、サーバー名の違いを表にし、一つの正本から両方の設定を書き出す Python スクリプトと確認手順をまとめました。

Claude Code290Gemini CLIMCP62設定ファイル比較6

壁紙アプリのストアレビューを拾う小さな MCP サーバーを、Claude Code と Gemini CLI の両方から呼べるようにしようとした夜のことです。Claude Code ではすぐにツールが並んだのに、同じ定義を Gemini CLI の設定へ貼ると、そのサーバーだけが DISCONNECTED のまま動きませんでした。

stdio で起動するほうの二つは、どちらの CLI でも問題なく繋がっていました。止まっていたのは HTTP で待ち受けている一つだけです。トークンを疑い、サーバーのログを疑い、三十分ほど遠回りしてから、原因が設定の「一語」にあったと分かりました。

最初にお伝えしたいのは、二つの CLI はどちらも mcpServers というキーを使いますが、中身の書き方は同じではないということです。見た目が似ているぶん、コピーで済むと思い込みやすいのだと思います。個人開発で両方を併用している私自身が、その後に引いた線を書き残します。

HTTP のサーバーだけが Gemini CLI で繋がらなかった理由

Claude Code の .mcp.json では、リモートのサーバーを次のように書きます。

{
  "mcpServers": {
    "store-reviews": {
      "type": "http",
      "url": "https://mcp.example.com/mcp"
    }
  }
}

これを .gemini/settings.json の mcpServers にそのまま移しても、Gemini CLI は type を見ません。Gemini CLI はキーの名前で通信方式を決めていて、httpUrl なら Streamable HTTP、url なら SSE、command なら stdio として繋ぎにいきます。

つまり url と書いた時点で、Streamable HTTP のサーバーに SSE で話しかけていたのです。サーバーは落ちておらず、トークンも正しく、間違っていたのはキーの名前だけでした。

逆向きにも同じ落とし穴があります。Claude Code は type の無いエントリを stdio として読むため、Gemini CLI 用に書いた {"httpUrl": ...} を .mcp.json に貼っても繋がりません。url があって type が無い場合は、"type": "http" を足すよう促すメッセージを出して、そのサーバーを飛ばします。

二つの設定ファイルの違いを一枚の表にする

両方のドキュメントを並べて読み、引っかかりそうな行だけを表にしました。2026 年 11 月 19 日時点の Claude Code 公式ドキュメント(MCP の章)と、Gemini CLI リポジトリの docs/tools/mcp-server.md に基づいています。

項目Claude CodeGemini CLI
プロジェクトの設定ファイル.mcp.json(リポジトリ直下).gemini/settings.json
通信方式の指定type(stdio / http / sse / ws)キーの名前(command / httpUrl / url)
Streamable HTTP の書き方"type": "http" と urlhttpUrl(url は SSE 扱い)
環境変数を展開する場所command・args・env・url・headersenv ブロック
書ける変数の形${VAR} と ${VAR:-default}$VAR と ${VAR}(Windows は %VAR% も)
変数が未設定のとき${VAR} の文字列のまま使い、claude mcp list で警告空文字になる
サーバー名の注意予約された名前を避ける_ を使わない(権限ルールの解析がずれる)
初めて読み込むときプロジェクトのサーバーは対話で承認するまで保留信頼していないフォルダでは stdio を繋がない

私がいちばん気にしているのは、変数まわりの二行です。Claude Code で ${TOKEN:-dev} と書いた既定値つきの値は、Gemini CLI のドキュメントには載っていない書き方です。未設定の変数も、Claude Code では文字列 ${VAR} のまま、Gemini CLI では空文字として渡ります。

どちらも「黙って違う値で起動する」方向の失敗なので、気づくのが遅れます。認証エラーとして表に出るころには、設定ファイルのことはもう頭から抜けているのです。

もう一つ、Gemini CLI はホストから引き継ぐ環境変数のうち、*TOKEN* や *KEY* に当たる名前を既定で伏せてからサーバーを起動します。サーバーに渡したい変数は、env に明示しておく必要があります。

正本を一つ置き、二つの形へ書き出す

最初は、二つのファイルを手で揃えていました。結果は芳しくありませんでした。片方にだけサーバーを足し、もう片方を忘れる——それを三度繰り返したところで、手で揃えるのをやめました。

定義は一か所に、方言は書き出すときに。 いまはこの線引きにしています。どちらのツールの形でもない mcp-servers.src.json を正本にして、小さなスクリプトで両方を生成します。

正本はこう書きます。env の値には、変数の書式ではなく環境変数の名前だけを書くのが約束です。

{
  "files": {
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "./assets"]
  },
  "issue-tracker": {
    "transport": "stdio",
    "command": "node",
    "args": ["tools/issue-mcp.js"],
    "env": { "TRACKER_TOKEN": "TRACKER_TOKEN" }
  },
  "store-reviews": {
    "transport": "http",
    "url": "https://mcp.example.com/mcp",
    "headers": { "Authorization": "Bearer ${REVIEWS_TOKEN}" }
  }
}

書き出すスクリプトです。既存の設定ファイルにある別のキー(.mcp.json の $schema や、Gemini 側のほかの設定)は残し、mcpServers だけを差し替えます。

#!/usr/bin/env python3
"""mcp-servers.src.json を正本に、.mcp.json と .gemini/settings.json を書き出す。"""
import json
import os
import re
import sys
from pathlib import Path
 
SRC = Path("mcp-servers.src.json")
CLAUDE = Path(".mcp.json")
GEMINI = Path(".gemini/settings.json")
VAR_NAME = re.compile(r"^[A-Z_][A-Z0-9_]*$")
 
 
def load_json(path, default):
    if not path.exists():
        return default
    try:
        return json.loads(path.read_text(encoding="utf-8"))
    except json.JSONDecodeError as e:
        # コメント付きの settings.json を読み直して書き戻すとコメントが消えるため、上書きせず止める
        sys.exit(f"{path}: JSON として読めません({e})。コメントを外してから再実行してください")
 
 
def env_block(name, spec):
    out = {}
    for key, var in spec.get("env", {}).items():
        if not VAR_NAME.match(var):
            sys.exit(f"{name}.env.{key}: 値には環境変数の名前だけを書きます({var!r})")
        out[key] = "${" + var + "}"  # 両方の CLI が読める形に揃える。:-default は使わない
    return out
 
 
def to_claude(name, spec):
    if spec["transport"] == "stdio":
        entry = {"type": "stdio", "command": spec["command"], "args": spec.get("args", [])}
        env = env_block(name, spec)
        if env:
            entry["env"] = env
        return entry
    # type が無いと stdio として読まれるので、http / sse でも必ず書く
    entry = {"type": spec["transport"], "url": spec["url"]}
    if spec.get("headers"):
        entry["headers"] = spec["headers"]
    return entry
 
 
def to_gemini(name, spec):
    if "_" in name:
        sys.exit(f"{name}: Gemini CLI ではサーバー名に _ を使わないでください")
    t = spec["transport"]
    if t == "stdio":
        entry = {"command": spec["command"], "args": spec.get("args", [])}
        env = env_block(name, spec)  # TOKEN などを含む名前は明示しないと渡らない
        if env:
            entry["env"] = env
        return entry
    entry = {"httpUrl": spec["url"]} if t == "http" else {"url": spec["url"]}  # url は SSE 扱い
    headers = spec.get("headers", {})
    if any("${" in v for v in headers.values()):
        print(f"skip: {name} はヘッダーに変数があるため Gemini 側へ書き出しません", file=sys.stderr)
        return None
    if headers:
        entry["headers"] = headers
    return entry
 
 
def main():
    servers = load_json(SRC, None)
    if not servers:
        sys.exit(f"{SRC} が見つからないか空です")
    for name, spec in servers.items():
        for var in spec.get("env", {}).values():
            if var not in os.environ:
                print(f"warning: {name} が使う {var} が今のシェルに未設定です", file=sys.stderr)
 
    claude = load_json(CLAUDE, {})
    gemini = load_json(GEMINI, {})
    claude["mcpServers"] = {n: to_claude(n, s) for n, s in servers.items()}
    g = {n: e for n, e in ((n, to_gemini(n, s)) for n, s in servers.items()) if e is not None}
    gemini["mcpServers"] = g
 
    CLAUDE.write_text(json.dumps(claude, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
    GEMINI.parent.mkdir(exist_ok=True)
    GEMINI.write_text(json.dumps(gemini, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
    print(f"claude={len(claude['mcpServers'])} gemini={len(g)}")
 
 
if __name__ == "__main__":
    main()

上の正本で実行すると、claude=3 gemini=2 と表示され、レビュー用の store-reviews だけが skip: の行とともに Gemini 側から外れます。このスクリプトで防ぎたかったのは、三つの事故です。

一つ目は通信方式の取り違えです。to_gemini が http を必ず httpUrl に、to_claude が type を必ず書くようにしました。二つ目は変数の書式の方言で、正本には変数名だけを書かせ、出力ではどちらの CLI も読める ${VAR} に揃えています。既定値の構文は、あえて使いません。

三つ目は秘密の置き場所です。Gemini CLI のドキュメントでは展開の対象が env ブロックとされているので、ヘッダーに変数を含むサーバーは Gemini 側へ書き出さず、警告だけを出します。その一つは、リポジトリに入らない ~/.gemini/settings.json へ手で一度だけ登録しました。

コメント付きの settings.json を読めないときに上書きせず止めるのも、意図してのことです。Gemini CLI の設定例にはコメントを含むものがあり、json モジュールで読み直して書き戻すと、コメントごと消えてしまいます。

書き出したあと、どちらの CLI でも確かめる

生成したら、両方の CLI に一覧を出させて答え合わせをします。

python3 tools/sync_mcp.py
claude mcp list
gemini mcp list

Claude Code では、.mcp.json から読んだサーバーが ⏸ Pending approval と出ることがあります。壊れているのではなく、対話で claude を起動して承認するまでは使わない、という安全側の動きです。

Gemini CLI では、信頼していないフォルダの stdio サーバーは Disconnected と表示されます。gemini trust で現在のフォルダを信頼してから、もう一度一覧を見ます。

Claude Code のバージョンも確かめておきたいところです。11 月 17 日の 2.1.327 で、プロジェクトスコープの claude mcp add と claude mcp remove が、.mcp.json のほかのトップレベルキー($schema や、別のツールの servers など)を消してしまう不具合が直りました。同じ版から、mcpServers キーが無くトップレベルにサーバーを並べた .mcp.json に対しては、上書きせずに止まるようになっています。

併用している方ほど、古い版のままコマンドを打つと別のツールの設定を巻き込みかねません。claude --version で 2.1.327 以降かを、一度だけ見ておくと安心です。

どちらの CLI で直すか、という線引き

二つの CLI を並べて使っていると、不具合が出たときに「どちらの設定で直すか」で迷います。私は、正本を直して書き出し直す以外の直し方をしないと決めています。片方のファイルを直接直すと、次の書き出しで元に戻り、同じ不具合にもう一度出会うからです。

例外は、Gemini 側のユーザー設定に置いた秘密つきのサーバーだけです。そこが正本の外にあることは、書き出しのたびに出る skip: の行が思い出させてくれます。

設定に書いた変数がそのまま渡ってしまう症状は、プラグイン同梱の MCP だけ認証に失敗するときの切り分けで詳しく扱いました。繋がったあとにツールが減っていく問題まで踏み込みたい方には、メンバー向けのMCPサーバーは繋がっているのに、ツールが0件で返るが次の一歩になると思います。

まずは手元の .gemini/settings.json を開き、url と書かれたサーバーが本当に SSE なのかを、一つずつ確かめていただければと思います。私の場合、直すべきだったのはその一語だけでした。

シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

⟐ Claude Code2026-10-23
夜間の claude -p で MCP が「認証待ち」になった朝、sleep と keychain を切り分ける事前確認を足しました
Claude Code 2.1.307 は macOS の sleep とログインキーチェーンのロックが原因の MCP 失敗を修正しました。修正の有無に関わらず効く事前確認スクリプトと、sleep 履歴との照合手順をまとめます。
⟐ Claude Code2026-10-23
夜間の claude -p で MCP が「認証が必要」と出る朝に、Mac のスリープとキーチェーンを疑う順番
無人で回した claude -p の朝のログに「needs authentication」や MCP のタイムアウトが残っているとき、Mac のスリープとログインキーチェーンのロックを先に確かめる手順です。v2.1.307 で変わった挙動と、版を上げても残る部分の線引きをまとめました。
⟐ Claude Code2026-10-19
MCP の allow を `mcp__サーバー名` で書いていた人へ — v2.1.299 の変更で見直すのは名前に `__` を含むサーバーだけ
Claude Code v2.1.299 で MCP の allow ルールが「名指ししたサーバーだけ」に一致する形へ変わりました。裸の mcp__サーバー名 が影響を受けるのは、名前に __ を含む、または末尾が _ のサーバーだけです。点検用の Python スクリプト付き。