先に結論だけ
MCP error -32000: Connection closed
Dockerイメージを取得してMCPサーバーを起動しようとした際にこのエラーが発生したら、Docker DesktopのAdvanced設定から、Choose how to configure the installation of Docker’s CLI tools
をSystem (requires password)
に変更してください。
対象とする環境
- macOS 15.5(24F74)
- Docker version 28.1.1, build 4eba377
- Docker Desktop for Mac V4.41.2
- .dmgからApplicationsフォルダーへドラッグ&ドロップでインストールしています
- backlog-mcp-server v0.3.0
- mcpサーバーをDockerコンテナーで起動しようとした際に発生
将来のバージョンでは挙動が変わるかもしれないので、記事を読む前にお手元の環境のバージョンを確認してください。
対象とする読者
- Docker初心者
- MCPサーバーの利用にDockerが必要になったが、前提知識がない方
この記事はDockerをはじめて使うユーザーを対象として想定しています。
発生した問題
Clineにbacklog-mcp-serverをセットアップしようとしたところ、以下の表示が出力されて起動しませんでした。
MCP error -32000: Connection closed
backlog-mcp-serverの起動コマンドを直接ターミナルで実行すると、以下のエラーが発生しました。
docker: error getting credentials - err: exec: "docker-credential-desktop": executable file not found in $PATH, out: ``
~/.docker/config.json
に "credsStore": "desktop"
が設定されていると、このエラーが出力されてコンテナーが起動しません。config.json
から "credsStore": "desktop"
を削除すると一時的に解決しますが、Docker Desktopを再起動すると削除した設定が復元されてしまいます。
原因
Docker Desktop for MacではCLIツールが $PATH
に登録されず、docker-credential-desktop
実行ファイルを参照できないため問題が発生しています。
解決方法
A. Docker DesktopのAdvanced SettingでCLIツールを/usr/local/binにインストールする
- Docker Desktopを起動
- 画面右上の歯車アイコンをクリックし、
Settings
を開く - 左メニュー最下部の
Advanced
タブを選択 -
Choose how to configure the installation of Docker’s CLI tools
を切り替える-
System (requires password)
を選択
-
-
Apply & Restart
ボタンをクリック
→ これにより /usr/local/bin/docker-credential-desktop
などにCLIツールが配置され、credsStore: "desktop"
のまま問題なく認証情報を扱えるようになります。
B. 代替手段(参考)
手動でシンボリックリンクを張る方法もありますが、推奨しません。この問題がどのような原因で発生するのかを理解するための参考情報として記録しておきます。
sudo ln -sf \
/Applications/Docker.app/Contents/Resources/bin/docker-credential-desktop \
/usr/local/bin/docker-credential-desktop
問題が解決したかの確認
which docker-credential-desktop
でパスが通っていることを確認してください。
以上、ありがとうございました。