MCPサーバーの設定を手伝っていて、受講者の方のターミナルの履歴をさかのぼったら、APIのトークンがそのまま何行も並んでいたことがあります。本人は気づいていませんでした。

MCPは、Claude Codeに外の道具をつなぐための共通の決まりです。つなぐときにトークン(サービスに入るための合い鍵の文字列)を渡すことが多く、その渡し方によっては、鍵がパソコンの中に残り続けます。11月17日公開の2.1.327で、この問題を避ける書き方が Claude Code に入りました。この記事では、claude mcp add-jsonの新しい使い方を中心に、鍵を残さないMCPの設定を見ます。11月19日時点の情報です。

何が危ないのか

MCPサーバーを足すコマンドの例は、公式ドキュメントにもこう書かれています。

claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

波かっこの部分はJSON(設定を書くための決まった書式)で、つなぎ先のURLと、送るトークンが書かれています。最後の token の部分に、本物のトークンを入れて打つと、どうなるか。多くのシェル(コマンドを受け付ける仕組み)は、打ったコマンドを履歴のファイルに保存します。上矢印キーで前のコマンドを呼び出せるのは、この履歴のおかげです。

つまり、トークンが履歴のファイルに、暗号化されず、そのまま読める形で残ります。パソコンを共有している、画面を見せながら説明する、履歴のファイルをバックアップごと別の場所に送る。どれでも漏れる道ができます。

2.1.327で入った書き方

2.1.327の更新履歴には、claude mcp add-json <name> - で、サーバーの設定を標準入力(コマンドに外から流し込む入口)から読めるようにした、と書かれています。理由は「トークンをコマンドラインに載せないため」です。

使い方は、設定をファイルに書いておき、それを流し込む形です。server.json は、テキストエディタで作るか、Claude Codeに「この設定で server.json を作って」と頼んで作ります。そのうえで、ターミナルで次のように打ちます。cat はファイルの中身を出す命令で、| はその中身を次の命令に流し込む記号です。

cat server.json | claude mcp add-json weather-api -

これなら、履歴に残るのは server.json というファイルの名前だけです。登録が終わったら、rm server.json で server.json を消しておきます。

登録先は --scope で選べます。何も付けなければ、自分だけが今のプロジェクト(Claude Codeを起動したフォルダ)で使う設定になります。--scope user なら自分のすべてのプロジェクトで、--scope project ならチームで共有するMCPの設定ファイル .mcp.json に書かれます。トークンを含む設定を project で登録すると、共有のファイルに鍵が入ってしまうので、後で書く環境変数の形と組み合わせてください。

注意点として、この書き方はClaude Codeの会話の中では使えません。ターミナルで、Claude Codeを起動していない状態で打ちます。

ついでに直ったこと

1つ前の2.1.326では、claude mcp add-json の書き間違いに対して、ほとんど何も分からない「Invalid configuration」というエラーしか出なかった問題も直りました。今は、どこを直せばいいかを教えてくれます。

JSON(設定を書くための決まった書式)の括弧や引用符が1つずれただけで登録に失敗し、原因が分からずに30分迷った経験が私にもあります。古い版を使っている人は、claude update で上げておくのがおすすめです。

もっと良いのは、鍵を設定に書かないこと

標準入力から渡す方法は、履歴に残さないための工夫です。ただ、登録したあとの設定ファイルには、やはり鍵が書かれます。

公式ドキュメントでは、設定の中で環境変数(パソコンに覚えさせておく値)を参照する書き方が案内されています。

{
  "headers": {
    "Authorization": "Bearer ${API_KEY}"
  }
}

こうしておけば、設定ファイルには ${API_KEY} という名前だけが残り、本物の鍵は別の場所で管理できます。本物の値は、Claude Codeを起動する前のターミナルで export API_KEY=... のように設定するか、パスワード管理の道具から読み込ませます。どこに置くのが自分の環境に合うかは、Claude Codeに相談すれば候補を出してくれます。チームで共有する .mcp.json に書くなら、この形が前提です。

ひとつ落とし穴があります。外のサーバーにつなぐ設定のURLやヘッダーでは、ANTHROPIC_API_KEY のような、鍵らしい名前の決まった環境変数が空として扱われます。うっかり別のサービスにClaudeの鍵を送らないための仕組みです。自分で別の名前の変数を作り、そちらを参照してください。

すでに履歴に残してしまった人へ

心当たりがある人は、次の順で片付けてください。

  1. トークンを発行したサービスの画面で、そのトークンを無効にし、新しいものを作る
  2. シェルの履歴のファイルから、該当の行を消す(macOSなら多くは ~/.zsh_history。Claude Codeに「履歴からこのトークンを含む行を消して」と頼んでもよい)
  3. 新しいトークンは、上の環境変数の形で設定し直す

1が一番大事です。履歴を消しても、すでにどこかに写っているかもしれません。鍵を変えてしまえば、古い鍵は使えなくなります。

MCPの設定の全体は、こちらにまとめています。