Claude Desktop × DocBase MCP連携でnodebrewユーザーがハマったPATH問題と解決法

はじめに

TeraDox株式会社の@tdx_yoshikawaです。弊社では社内ドキュメントの管理ツールとしてDocBaseを使用しており、先日MCPサーバーがリリースされたとのことで、Claude Desktopとの連携でつまづいたポイントを説明します。

環境

• M4 Macbook Pro
• node v23.11.1
• npm v11.4.2
• Node.jsのバージョン管理ツールとしてnodebrewを使用しています

つまづいた点

MCP公式の手順に沿って設定したにも関わらず、Claude DesktopでDocBase MCPサーバーに接続する際に以下のようなエラーが発生しました。

MCP接続のため参考にした手順は以下です。
https://help.docbase.io/posts/3809370

原因

nodebrewでNode.jsをインストールしている環境では、node、npm、npxコマンドが/usr/local/bin/にシンボリックリンクされていないため、Claude Desktopがこれらのコマンドを見つけることができませんでした。Claude DesktopのMCPサーバーは通常、システムの標準的なPATHからこれらのコマンドを探すため、nodebrewの環境では追加の設定が必要になります。

解決方法

以下のコマンドでシンボリックリンクを作成します。

sudo ln -s $HOME/.nodebrew/current/bin/npx /usr/local/bin/npx
sudo ln -s $HOME/.nodebrew/current/bin/node /usr/local/bin/node
sudo ln -s $HOME/.nodebrew/current/bin/npm /usr/local/bin/npm

シンボリックリンクが設定されていることは以下のコマンドで確認できます。

ls -la /usr/local/bin/{node,npm,npx}

正常に設定されていれば、以下のような出力が表示されます。

lrwxr-xr-x  1 root  wheel  XX XX XX XX:XX /usr/local/bin/node -> /Users/username/.nodebrew/current/bin/node
lrwxr-xr-x  1 root  wheel  XX XX XX XX:XX /usr/local/bin/npm -> /Users/username/.nodebrew/current/bin/npm
lrwxr-xr-x  1 root  wheel  XX XX XX XX:XX /usr/local/bin/npx -> /Users/username/.nodebrew/current/bin/npx

まとめ

nodebrewでNode.jsを管理している環境では、MCPサーバーを使用する際にシンボリックリンクの設定が必要でした。同じような環境で困っている方の参考になれば幸いです。