たった1つのファイルを作るだけ！Claude Codeをサーバーに繋いで、もっと便利にする方法

Claude Code

たった1つのファイルを作るだけ！Claude Codeをサーバーに繋いで、もっと便利にする方法

【これを読むと何ができるようになる？】

この設定をすると、あなたがいつも使っているサーバーにClaude Codeを直接つなげることができます。毎回サーバーのアドレスやユーザー名を入力する手間が省けて、ファイルの編集やプログラムの実行がぐっとスムーズになりますよ。

準備するもの

  • Claude Codeがあなたのパソコンにインストールされていること。
  • 接続したいサーバーの情報（サーバーのアドレス、ログイン用のユーザー名など）が手元にあること。

手順（ステップごとに丁寧に）

ステップ1：ターミナル（命令を打ち込む黒い画面）を開く

まずは、パソコンに直接命令を伝えるための「ターミナル」というアプリを開きましょう。これからの作業はすべてこの画面で行います。

  • macOSの場合：「Launchpad」から「その他」フォルダの中にある「ターミナル.app」を探してクリックします。
  • Windowsの場合：「スタートメニュー」で「Windows Terminal」または「コマンドプロンプト」と検索して開きます。

なぜこれをするのか：キーボードでコマンド（命令文）を打ち込んで、パソコンの深い部分を直接操作するために必要な画面だからです。

ステップ2：設定ファイルをしまうための「専用フォルダ」を作る

次に、MCP連携（サーバーと連携するための機能）の設定ファイルを置くための場所を用意します。以下のコマンドをコピーして、ターミナル画面に貼り付けてEnterキーを押してください。

mkdir -p ~/.claude

このコマンドは、「~/.claudeという名前のフォルダを作ってください」という命令です。「~」はあなたのホームフォルダ（個人のファイルが置かれる基本の場所）を意味します。何もメッセージが表示されなければ、フォルダは無事に作られています。

なぜこれをするのか：Claude Codeは、この特定の場所に設定ファイルがないと見つけてくれないため、決められた場所に専用のフォルダを用意する必要があります。

ステップ3：設定ファイルを作成して開く

いよいよ設定ファイルそのものを作ります。以下のコマンドをターミナルに打ち込んでEnterキーを押しましょう。

nano ~/.claude/.mcp.json

このコマンドは、「nanoというシンプルなテキストエディタ（メモ帳のようなもの）を使って、.mcp.jsonという名前の新しい設定ファイルを作って開いてください」という命令です。画面が切り替わり、文字を入力できる状態になります。

なぜこれをするのか：ここに、どのサーバーに接続したいかの情報を書き込んで、Claude Codeに教えてあげるためです。

ステップ4：サーバーの情報を書き込む

開いたnanoの画面に、以下の内容をコピーして貼り付けます。そして、"your-server-address.com"などの部分を、あなた自身のサーバー情報に書き換えてください。

{
  "servers": [
    {
      "name": "my-server",
      "host": "your-server-address.com",
      "user": "your-username",
      "port": 22
    }
  ]
}
  • "name": 自分でわかる好きな名前（例: “会社のサーバー”）をつけましょう。
  • "host": 接続したいサーバーのアドレス（例: “example.com” や IPアドレス）を入力します。
  • "user": サーバーにログインするときのあなたのユーザー名を入力します。
  • "port": サーバーとの通信で使う「ドア番号」のようなものです。通常は22でOKです。

書き換えが終わったら、ファイルを保存してエディタを終了します。

  1. Ctrlキーを押しながらOキーを押します。（書き込み）
  2. ファイル名を確認する画面で、そのままEnterキーを押します。
  3. Ctrlキーを押しながらXキーを押して、エディタを終了します。

ステップ5：設定がうまくいったか確認する

最後に、Claude Codeが設定をちゃんと読み込んでくれたか確認します。ターミナルに以下のコマンドを打ち込んでEnterキーを押してください。

claude mcp ls

このコマンドは、「登録されているMCPサーバーの一覧を見せてください」という命令です。先ほどステップ4の"name"で設定したサーバー名（例: my-server）が表示されれば、設定は完璧に成功です！

うまくいかないときは

  • claude mcp lsを実行しても何も表示されない場合： 設定ファイルの場所か名前が間違っている可能性が高いです。ファイル名が.mcp.json（先頭にドットがある）になっているか、場所が~/.claude/フォルダの中にあるか、もう一度確認してみましょう。
  • 「JSONの形式が正しくありません」といったエラーが出る場合： 設定ファイルの中身の書き方を間違えているかもしれません。{ }や" "、,（カンマ）などが抜けていたり、余分だったりしないか、お手本とじっくり見比べてみてください。特に、項目の最後にはカンマをつけないのがルールです。
  • サーバー名が表示されるのに接続できない場合： host（サーバーのアドレス）やuser（ユーザー名）の情報が間違っている可能性があります。手元にある正しい情報と、設定ファイルに書き込んだ内容が一致しているか、再度確認してみましょう。

もっと活用するには

基本の設定に慣れたら、こんな応用もできますよ。

  • 複数のサーバーを登録する： 設定ファイルの中の[...]の中に、{...}のブロックをカンマで区切って複数書くことで、仕事用やプライベート用など、たくさんのサーバーを登録できます。claude mcp lsで一覧を確認し、簡単に切り替えられます。
  • パスワードなしで安全に接続する： 「秘密鍵」という特別なファイルを使って、もっと安全にサーバーに接続する方法もあります。設定ファイルに"privateKeyPath": "/Users/yourname/.ssh/id_rsa"のような一行を追加するだけで設定できますので、ぜひ挑戦してみてください。

※Claude Codeは継続的にアップデートされます。最新情報は公式ドキュメントをご確認ください。

情報源：@Piste_AI_BOSS のポストをもとに編集部が解説記事として構成しました。

コメント

タイトルとURLをコピーしました