Claudeが外部ツールを直接利用できるようにするMCP（Model Context Protocol）、皆さん活用されていますか？最近ではワンクリックでインストールできるデスクトップ拡張機能のサポートも始まりましたが、自分で用意したカスタムサーバーや便利なツールを連携させるには、結局claude_desktop_config.jsonファイルを直接編集しなければならないケースが多いです。今回は、初心者の方がよく直面する落とし穴と、その解決策を簡単に共有したいと思います。

最もよく発生する問題がspawn npx ENOENTエラーです。Claudeデスクトップアプリがシステムの環境変数を正しく引き継げず、npxコマンドが見つからないことが原因です。このような場合は、設定ファイルのcommandに単にnpxと記述するのではなく、自身のPCのターミナルでwhich npx（macOS）やwhere npx（Windows）を実行して表示されたnpxの絶対パスをそのまま記述すると綺麗に解決します。ローカルフォルダを指定する際も./のような相対パスではなく、フルパス（絶対パス）を入力しないとエラーになるので注意してください。

入門者の方には、リアルタイムのネット検索に対応したBrave Searchと、ローカルファイルの読み書きができるFilesystemサーバーから試してみることをおすすめします。特にBrave Searchは、最近公式パッケージ名が@brave/brave-search-mcp-serverに変更されたので、古いパッケージではなく新しい名前で以下のように追加してみてください。Claudeアプリを完全に再起動すれば、右下にプラグアイコンが有効になっているのが確認できます。思っていたより簡単ですので、ぜひ試してみてください。