この記事では、ClaudeのMCP設定などで必要になる「JSONファイル」の基本と編集方法を解説します。
ClaudeをカスタマイズするMCPの設定は、Claudeの拡張機能でMCPサーバーを選択することで設定する方法と、JSONファイルを直接書き換える方法があります。ここでは後者について説明します。難しそうに聞こえますが、ルールはシンプルで、この記事を読めば迷わず編集できるようになります。
JSONファイルとは何か
JSONとは、設定や情報をテキストで整理して書くためのフォーマットです。
フォーマットとは？
データの書き方のルール・形式のことです。
たとえば「名前：山田、年齢：28、所属：東京大学」という情報をJSONで書くと：
{
"名前": "山田",
"年齢": 28,
"所属": "東京大学"
}
このような見た目になります。人間にも読みやすく、コンピュータにも処理しやすい形式です。
JSONの基本ルール
JSONには厳格なルールがあります。1文字でも間違えるとエラーになるので、以下を覚えておきましょう。
ルール①：文字列は必ずダブルクォーテーションで囲む
// ✅ 正しい
"名前": "山田"
// ❌ 間違い（シングルクォーテーションはNG）
'名前': '山田'
ルール②：項目と項目の間はカンマで区切る（最後の項目にカンマは不要）
{
"名前": "山田", ← カンマあり
"年齢": 28, ← カンマあり
"所属": "東京大学" ← 最後はカンマなし
}
ルール③：数字はクォーテーション不要
"年齢": 28 ← 数字はそのまま
"名前": "山田" ← 文字列はクォーテーション必要
ルール④：波括弧 {} と角括弧 [] を使い分ける
// {} はひとまとまりの情報
{
"名前": "山田"
}
// [] はリスト（複数の情報）
{
"メンバー": ["山田", "田中", "鈴木"]
}
よくあるエラーと原因
| エラーの原因 | 悪い例 | 正しい例 |
|---|---|---|
| 最後の項目にカンマ | "所属": "東大", | "所属": "東大" |
| シングルクォーテーション | '名前': '山田' | "名前": "山田" |
| 括弧の閉じ忘れ | { "名前": "山田" | { "名前": "山田" } |
| 全角文字の混入 | "名前"："山田" | "名前": "山田" |
コロン（:）やカンマ（,）は必ず半角で入力してください。
日本語入力モードのまま入力すると全角になりエラーの原因になります。
JSONファイルの編集方法
JSONファイルを編集するには「テキストエディタ」を使います。テキストエディタとは、文字を編集するためのアプリです。WordやPagesとは違い、装飾なしの純粋なテキストを扱います。
以下に3種類紹介します。目的に合わせて選んでください。
方法①：VS Code（おすすめ）
VS Code（Visual Studio Code） はMicrosoftが無料で提供しているテキストエディタです。
なぜおすすめか？
JSONの書き方が間違っているとリアルタイムで赤線で教えてくれます。また、後述するClaude Codeもこのアプリを使うため、今のうちに慣れておくと一石二鳥です。
インストール方法
- https://code.visualstudio.com にアクセス
- 「Download」ボタンをクリック
- Mac版またはWindows版を選んでダウンロード
- ダウンロードしたファイルを開いてインストール
JSONファイルを開く方法
- VS Codeを起動
- メニューの「ファイル」→「ファイルを開く」
- 編集したいJSONファイルを選択
VS Codeの便利機能
エラーの自動検出： 間違いがある行に赤い波線が表示されます。
自動整形： 以下のショートカットでインデント（字下げ）を自動で整えてくれます。
- Mac：
Shift+Option+F - Windows：
Shift+Alt+F
方法②：メモ帳（Windows標準搭載）
Windowsに最初から入っているシンプルなテキストエディタです。追加インストール不要ですぐ使えます。
注意点
エラーの自動検出機能がないため、間違いに気づきにくいです。VS Codeが使える環境ではVS Codeを推奨します。
JSONファイルを開く方法
- JSONファイルを右クリック
- 「プログラムから開く」→「メモ帳」を選択
方法③：テキストエディット（Mac標準搭載）
Macに最初から入っているテキストエディタです。
重要：必ずプレーンテキストモードで使う
テキストエディットはデフォルトで「リッチテキスト」モードになっており、JSONの編集には不向きです。以下の手順でモードを変更してください。
プレーンテキストモードへの切り替え
- テキストエディットを開く
- メニューの「フォーマット」→「標準テキストにする」をクリック
JSONファイルを開く方法
- JSONファイルを右クリック
- 「このアプリケーションで開く」→「テキストエディット」を選択
エディタの選び方まとめ
| エディタ | OS | インストール | エラー検出 | おすすめ度 |
|---|---|---|---|---|
| VS Code | Mac・Windows | 必要 | あり | ⭐⭐⭐ |
| メモ帳 | Windowsのみ | 不要 | なし | ⭐ |
| テキストエディット | Macのみ | 不要 | なし | ⭐ |
迷ったらVS Codeを選んでください。 後のClaude Code記事でも使います。
実際にJSONファイルを編集してみよう
練習として、簡単なJSONファイルを作って編集してみましょう。
ステップ1：新しいファイルを作成
VS Codeで「ファイル」→「新しいファイル」→ファイル名を test.json として保存。
ステップ2：以下を貼り付ける
{
"サイト名": "bioinfo-hub",
"カテゴリ": ["RNA-seq", "Python", "Claude"],
"公開中": true
}
ステップ3：自動整形を実行する
- Mac：
Shift+Option+F - Windows：
Shift+Alt+F
インデントが自動で整えば成功です。
まとめ
- JSONは設定や情報をテキストで整理する書き方のルール
- 文字列はダブルクォーテーション、カンマは最後の項目には不要
- コロンやカンマは必ず半角で入力する
- 編集にはVS Codeが最もおすすめ
次の記事では、VS Codeを使ってClaudeをMCPでカスタマイズする方法を解説します。
コメント