Claude Codeの機能を拡張したいなら、MCP（Model Context Protocol）の設定は避けて通れません。JSONファイルを少し書き換えるだけで、AIがウェブから最新情報を拾ったり、あなたの代わりにファイルを操作したりできるようになります。
エンジニアでなくても、正しい手順さえ踏めばカスタマイズは簡単です。作業を自動化して効率を上げるために、Claude Codeを自分専用のツールへ作り変える具体的な方法を見ていきましょう。
MCPのJSON設定ファイルの保存場所
設定を編集するには、まず設定ファイルがどこにあるかを知る必要があります。Claude Codeは特定のフォルダにあるJSONファイルを読み込んで自分の動きを決定しているからです。場所さえわかれば、あとはテキストエディタで開くだけで準備は整います。OSごとに異なる隠しフォルダを、今すぐ特定してみましょう。
1. macOSでの設定パスを確認
macOSを利用している場合、ファイルはライブラリフォルダの中に隠されています。Finderを開き、メニューの「移動」から「フォルダへ移動」を選択して、以下のパスを入力してください。
~/Library/Application Support/claude-code/config.json
この場所にある config.json が、あなたのClaude Codeの頭脳を制御する設計図です。パスを間違えると全く別のファイルを編集することになるため、一字一句正確に入力することが大切です。
2. Windows環境のフォルダ階層
Windowsユーザーは、アプリデータを格納する特別な変数を利用して場所に辿り着けます。エクスプローラーのアドレスバーに直接パスを打ち込むのが、最も手っ取り早い手段です。
%APPDATA%\claude-code\config.json
「%APPDATA%」は通常 C:\Users\ユーザー名\AppData\Roaming を指しています。隠しファイルを表示する設定になっていないと見つけにくい場所にあるため、パスの直接入力を強く推奨します。
3. Linuxでの保存先ディレクトリ
LinuxやWSL2環境で動作させている場合は、標準的な設定ディレクトリを確認します。多くの場合はユーザーのホームディレクトリ内にある隠しフォルダに格納されています。
~/.config/claude-code/config.json
ターミナルから ls -a コマンドを叩いて、ディレクトリが存在するか確認しましょう。設定ファイルが見当たらない場合は、一度Claude Codeを起動して初期設定を完了させるとファイルが自動生成されます。
JSONデータの基本的な書き換えルール
JSONファイルは、コンピューターが理解しやすいように決められたルールで書かれています。このルールを一つでも破ると、Claude Codeは「何をすればいいかわからない」とパニックを起こして起動しなくなります。難しく考える必要はありませんが、カンマの位置やカッコの種類といった、最低限の作法だけは守らなければなりません。
1. プロパティ名と値の記述規則
JSONでは、名前（キー）と値をペアにして記述します。名前は必ずダブルクォーテーション（”）で囲み、その後にコロン（:）を置いてから値を書くのが鉄則です。
値が文字列の場合は、同じようにダブルクォーテーションで囲む必要があります。名前と値の間にスペースを入れても構いませんが、全角のスペースはエラーの原因になるため絶対に使わないでください。
2. 配列とオブジェクトの入れ子構造
複数の設定をまとめる時は波カッコ { } を使い、項目のリストを作る時は角カッコ [ ] を使います。これらは必ず対になっていなければならず、開きカッコがあるなら必ず閉じカッコが必要です。
階層が深くなっても、この親子関係は変わりません。最後の項目の後ろにはカンマを付けないというルールがあるため、書き換えの際は末尾の記号をよく確認してください。
3. 文字列のエスケープ処理
パスを指定する際に、Windowsのバックスラッシュ（\）などはそのまま書くとエラーになる場合があります。特別な意味を持つ記号をただの文字として認識させるには、記号の前にバックスラッシュをもう一つ置くエスケープ処理が必要です。
特にWindowsのファイルパスを直接貼り付ける時は注意してください。エラーが出た時は、パスの区切りが正しく記述されているかを確認するのが解決の近道です。
設定を書き換える前の複製と保存
どんな熟練のエンジニアでも、設定ファイルをいじる前には必ず「バックアップ」を取ります。JSONは非常に繊細なファイルで、カンマが一つ足りないだけでアプリが動かなくなるからです。失敗してもすぐに元の状態に戻せる保険をかけておくことで、安心して大胆なカスタマイズに挑戦できるようになります。
1. 既存のconfig.jsonをコピー
作業を始める前に、現在の config.json を右クリックしてコピーを作成してください。コピーしたファイルの名前を config.json.bak などに変えておけば、どれが元のファイルか一目でわかります。
もし編集後にClaude Codeが起動しなくなったら、壊れたファイルを消してこのバックアップファイルを config.json に戻すだけです。この数十秒の手間を惜しまないことが、無駄なトラブル時間を削る最大の秘訣です。
2. 編集用のエディタを準備
メモ帳でも編集は可能ですが、JSONの構造を色分けしてくれるテキストエディタを使うのが賢明です。Visual Studio CodeやCursorなどのエディタを使えば、カッコの閉じ忘れを赤く光らせて教えてくれます。
無料のエディタでも十分な機能が備わっています。構文エラーを自動で見つけてくれる道具を使うことで、つまらないミスで時間を浪費するリスクを回避できます。
3. 変更履歴を管理する手段
大きな変更を加える時は、どの部分を書き換えたのかを自分なりに記録しておくと安心です。変更前後のコードをメモ帳に貼り付けておくだけでも、トラブル時の原因特定が早まります。
「以前は動いていた設定」を手元に残しておくことが重要です。順調に動いている時の設定内容を定期的に保存しておけば、カスタマイズの幅を広げる際に心強い味方になります。
mcpServers項目を編集する手順
Claude Codeに新しい「手足」を与える作業が、mcpServers 項目の編集です。ここに使用したいツールの情報を追記することで、AIは外部のサーバーやツールと対話できるようになります。正しい場所に正しい書式で追加しなければAIは認識してくれないため、基本の記述パターンを正確にトレースしましょう。
1. サーバー名をキーとして追加
mcpServers という大きな枠の中に、新しいツールの名前を書き込みます。例えばGoogle検索を追加したいなら、名前を "google-search" と定義して波カッコで囲みます。
名前はあなたが認識しやすいもので構いませんが、基本的にはツールの公式名称に合わせるのが一般的です。新しいツールを追加するたびに、この階層に新しい名前を並べていくことになります。
2. commandプロパティの指定方法
そのツールをどうやって動かすかを指定するのが command です。Node.jsで作られたツールなら npx、Python製なら python や uv といった実行コマンドを記述します。
システムにインストールされているパスを指定する場合もあります。ここを間違えるとAIがツールを呼び出せなくなるため、実行環境が整っていることを事前に確認してください。
3. argsプロパティへの引数の記述
コマンドに渡す追加の指示を args に角カッコで並べます。ツールを実行する際のオプションや、インストール済みのパッケージ名をここに列挙するのがルールです。
| プロパティ名 | 記述内容の例 | 役割 |
| command | “npx” | ツールの実行プログラムを指定 |
| args | [“-y”, “@modelcontextprotocol/server-brave-search”] | 実行時に渡す詳細なオプション |
| env | {“API_KEY”: “xxx”} | ツールが必要とする環境変数 |
引数は一つずつダブルクォーテーションで囲み、カンマで区切って並べる必要があります。
Brave Searchなどの検索ツールを追加
Claude Codeに最新のウェブ情報を教えたいなら、Brave Searchなどの検索MCPを導入するのが一番です。JSONを書き換えて検索機能を有効にすれば、AIは「2026年の最新ニュース」を自ら検索してコードに取り込めるようになります。APIキーを取得して設定ファイルに埋め込むだけで、AIの視界は世界中へと広がります。
1. npxを利用した実行コマンドの記述
検索ツールを導入する際は、インストール不要で動かせる npx を利用するのが最も簡単です。設定ファイルの mcpServers セクションに、以下の形式でツール情報を追記してください。
JSON
"brave-search": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-brave-search"
],
"env": {
"BRAVE_API_KEY": "あなたのAPIキー"
}
}
2. 検索ツールの引数設定
args の中には、ツールの実行を安定させるためのオプションを含めます。-y はインストール確認を自動で承諾する設定で、これを入れることで対話の流れを止めずに済みます。
さらに詳細な設定を加えたい場合も、この配列の中に項目を増やしていくだけです。記述をシンプルに保つことで、後から見直した時のミスを防げます。
3. 検索結果の取得範囲の制限
あまりに多くの検索結果をAIに渡すと、トークンを無駄に消費してしまいます。ツールによっては引数で取得件数を制限できるものがあるため、必要最小限のデータだけを受け取るように調整しましょう。
効率的な設定は、コスト削減にも直結します。AIに「賢く検索させる」ための土台をJSON側で作っておくことで、回答の質とスピードが向上します。
sequential-thinkingで論理的思考を強化
複雑な問題を一歩ずつ解かせたいなら、sequential-thinking というツールの追加を検討してください。これを設定に加えると、AIは「思考プロセス」を一つのツールとして使い、論理的な矛盾がないかを確認しながら答えを出すようになります。難しいバグ修正や大規模な設計変更を依頼する際に、その真価を発揮するカスタマイズです。
1. 思考ツール用の実行パスを指定
このツールも他のMCPと同様に mcpServers に追加します。特定のライブラリを読み込むことで、Claude Codeの推論能力を補完する思考ステップが有効化されます。
JSON
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
2. 思考プロセスを最適化する設定
追加した後は、AIに「まず考えてから行動して」と伝えるだけで、このツールが動き出します。JSON側で正しく定義されていれば、AIは自分の思考を整理するための専用スペースを確保できるようになります。
急いで答えを出して間違えるという、AI特有のミスを劇的に減らすことが可能です。 プログラミングのような論理性が求められる作業では、必須とも言える設定です。
3. 複雑なタスクでの挙動の変化
このツールが有効になると、AIの回答前に「思考中…」というプロセスが挟まるようになります。一見時間がかかるように思えますが、最終的な手戻りが減るため、トータルの時間は短縮されます。
一度に多くのことを考えさせるよりも、ステップに分けて考えさせるほうが精度は上がります。JSONを書き換えてこのツールを使える状態にしておくだけで、AIのIQが上がったかのような感覚を味わえるはずです。
環境変数とAPIキーの安全な書き込み
外部ツールを動かすためのAPIキーは、JSON内の env という項目に書き込みます。ここには、ツールが動作するために必要な「パスワード」のような情報を集めておきます。正しく記述しなければツールは認証エラーで動きませんが、同時にこのファイル自体を他人に公開しないといった、セキュリティへの配慮もエンジニアには求められます。
1. envプロパティ内のキー・値ペア
env セクションの中には、ツールが指定する名前（例えば BRAVE_API_KEY）をキーにして、取得したキーを値として書き込みます。ここでもダブルクォーテーションを忘れないようにしてください。
JSON
"env": {
"API_KEY_NAME": "YOUR_ACTUAL_KEY_VALUE"
}
2. ローカル環境変数との紐付け
APIキーをJSONに直接書きたくない場合は、PC本体の環境変数から読み込む方法もあります。しかし、設定ファイル内で完結させるほうが、Claude Codeを動かす際のトラブルは少なくなります。
利用シーンに合わせて使い分けましょう。まずはJSONに直接書き込んで動作を確認し、安定してからセキュリティを強化する手順がスムーズです。
3. キーの漏洩を防ぐ管理の基本
APIキーが記載された config.json をGitHubなどの公開の場にアップロードしてはいけません。万が一漏洩すると、あなたのクレジットが他人に使い果たされる恐れがあります。
ファイルのバックアップを取る際も、保存場所に注意してください。自分だけがアクセスできる安全なフォルダで管理することが、AIを使いこなして稼ぐための大前提です。
JSONの構文エラーを即座に修正するツール
JSONを自力で完璧に書き換えるのは意外と難しいものです。そこで、保存する前に記述が正しいかをチェックするツールの助けを借りましょう。エラーを未然に防ぐ道具を使うことで、「設定を変えたら動かなくなった」と頭を抱える時間をゼロにできます。プロの道具を賢く使い、最短ルートでカスタマイズを完了させましょう。
1. JSONLintなどの外部検証ツール
ブラウザで使える「JSONLint」のようなサービスを使えば、コピー＆ペーストするだけで構文の間違いを指摘してくれます。カンマの不足やカッコの過不足を、行番号付きで教えてくれます。
保存ボタンを押す前に、このチェックを通す習慣をつけましょう。エラー箇所が色付けされて表示されるため、どこを直すべきか一瞬で判断できます。
2. VS Codeの拡張機能による自動補正
Visual Studio Codeで編集しているなら、JSON用の拡張機能を導入してください。ファイルを保存した瞬間に、インデントを整えたり、明らかなミスを自動で修正したりしてくれます。
見た目が整うだけでなく、構造が視覚的にわかりやすくなります。ツールに頼れる部分は頼り、自分は「どの機能を追加するか」というクリエイティブな判断に集中しましょう。
3. エラーメッセージから原因を特定
もし設定後にClaude Codeが起動せずエラーを吐いたなら、そのメッセージをよく読んでください。大抵の場合、「line 24（24行目）」といった具合に、エラーの原因がある場所を教えてくれています。
指摘された行の前後を重点的に見直してください。エラーメッセージはAIからのアドバイスです。冷静に読み解けば、修正は難しくありません。
変更した設定をClaude Codeで読み込む
JSONファイルを書き換えて保存しても、すぐには新機能は使えません。Claude Codeは起動時に一度だけ設定ファイルを読み込むため、変更を反映させるには「再起動」の手順が必要です。正しい再起動の作法を知り、新しく追加したツールがAIの選択肢に並んでいることを確認するまでが、カスタマイズの一連の流れです。
1. 実行中のプロセスを終了
ターミナルで動いているClaude Codeを一度終了させます。通常は exit と打つか、Ctrl + C を押すことで停止できます。
完全にプロセスが閉じていることを確認してください。古い設定がメモリに残っていると、いくらJSONを直しても反映されないため、確実に一度閉じるのがコツです。
2. 再起動後のツール一覧確認
再度 claude コマンドで立ち上げたら、AIに「利用可能なMCPツールを教えて」と聞いてみてください。新しく追加した brave-search や sequential-thinking がリストに含まれていれば成功です。
AIが自ら新しいツールを認識しているはずです。リストに載っていれば、あとはAIが状況に応じて勝手にそのツールを使いこなしてくれます。
3. 設定が反映されない場合のトラブル対処
もし再起動してもツールが増えていないなら、JSONの記述場所が間違っているか、ファイルが保存されていない可能性があります。もう一度パスを確認し、エディタで保存が完了しているか見てください。
| トラブル | 確認すべき点 |
| 起動しない | JSONの構文エラーがないか（カンマやカッコ） |
| ツールが出ない | mcpServers の階層の中に書かれているか |
| 認証エラー | env 内のAPIキーが正しいか、ダブルクォーテーションがあるか |
一つずつ原因を潰していけば、必ず新機能は動き出します。
自作スクリプトをMCPツールとして使う
既存のMCPサーバーだけでなく、自分で書いたNode.jsやPythonのスクリプトをClaude Codeに実行させることも可能です。社内独自のデータベース操作や、特定のファイル変換処理などをスクリプト化し、それをJSONに登録すれば、AIはあなたの指示通りにそのプログラムを動かし始めます。これこそが、作業を極限まで効率化する究極のカスタマイズです。
1. スクリプト実行パスの記述
自作のスクリプトを動かす際は、そのファイルのフルパスを args に指定します。例えば、デスクトップにある my-tool.js を動かしたいなら、パスを正確に記述してください。
JSON
"my-custom-tool": {
"command": "node",
"args": ["/Users/name/Desktop/my-tool.js"]
}
2. 入出力インターフェースの整合
AIがスクリプトを理解するためには、MCPの規格に沿った入出力（stdioなど）をプログラム側で用意する必要があります。既存のMCPテンプレートを参考に、AIからの入力を受け取れるように調整しましょう。
少しテクニカルな作業になりますが、一度作れば汎用性は抜群です。自分専用の武器をAIに持たせることで、他のエンジニアにできない仕事ができるようになります。
3. 独自ツールの呼び出し名の設定
JSONで定義した名前（キー）が、AIがそのツールを呼ぶ時の名前になります。わかりやすい名前にしておけば、AIも「今はこの独自ツールを使おう」と正しく判断しやすくなります。
「特定のファイルを特定のルールで整形する」といった、自分だけの自動化ボタンをClaude Codeの中に埋め込むイメージです。
稼げる環境を作るためのJSONカスタマイズ
AIを使って収入を増やすには、誰でもできる作業をいかに速く、正確に終わらせるかが重要です。複数のMCPサーバーをJSONに仕込み、検索からコード生成、テスト実行までを一貫してAIに丸投げできる環境を構築しましょう。設定ファイルのカスタマイズは、単なる趣味ではなく、あなたのビジネスを加速させるための投資です。
1. 複数サーバーの同時登録
検索、思考強化、ファイル操作など、複数のツールを同時に有効化しておきましょう。AIは状況に応じて最適なツールを自動で使い分けるため、あなたが指示を出す手間を最小限に抑えられます。
「調べて、考えて、作る」という一連の動作を、AIが独り言のように完結させてくれる状態を作ります。
2. 開発効率を上げるエイリアスの設定
頻繁に使うMCPツールは、すぐに呼び出せるように設定を磨いておきます。APIの制限やトークン消費を抑えるための微調整をJSONで行っておけば、長時間の作業でもコストを抑えつつ高い成果を出せます。
効率化は利益に直結します。AIの「視界」と「手足」を最適化しておくことで、1日に行える作業量が劇的に増えるはずです。
3. 繰り返し作業を自動化するツール連携
自分が苦労している単純作業を解決できるMCPツールがないか、常にアンテナを張っておきましょう。新しいツールを見つけたらすぐにJSONに追記し、自分のAIをアップデートし続けてください。
環境を整える時間は、後の何十時間もの作業を節約してくれます。 Claude Codeを自分専用の最強エージェントに進化させ、ライバルに差をつけましょう。
まとめ：MCP設定をマスターしてClaude Codeを最適化する
MCPのJSON設定を書き換えることは、Claude Codeという原石を、あなた専用の宝石へと磨き上げる作業です。OSごとの設定ファイルの場所を特定し、構文ルールを守って mcpServers を編集するだけで、AIの能力は無限に広がります。
- 保存場所を特定する： macOS、Windows、Linuxそれぞれのパスを確認。
- JSONルールを守る： ダブルクォーテーションやカンマ、カッコの対をチェック。
- 新機能を追加する： 検索ツールや思考ツールを
mcpServersに追記。 - 安全に管理する： APIキーは
env内に書き込み、ファイルの複製を忘れずに。
バックアップを常に取り、構文チェックツールを活用しながら一つずつ機能を追加していけば、失敗を恐れる必要はありません。自分好みの設定が完了したとき、Claude Codeはあなたの想像を超えるスピードで、稼げる成果物を生み出してくれるようになるはずです。
