1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

トラブルシューティング: `docker-credential-desktop` が見つからず Dockerイメージが起動できない

Posted at

先に結論だけ

MCP error -32000: Connection closed

Dockerイメージを取得してMCPサーバーを起動しようとした際にこのエラーが発生したら、Docker DesktopのAdvanced設定から、Choose how to configure the installation of Docker’s CLI toolsSystem (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にインストールする

  1. Docker Desktopを起動
  2. 画面右上の歯車アイコンをクリックし、Settings を開く
  3. 左メニュー最下部の Advanced タブを選択
  4. Choose how to configure the installation of Docker’s CLI tools を切り替える
    • System (requires password) を選択
  5. 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

でパスが通っていることを確認してください。

以上、ありがとうございました。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?