PaPoo
cover

Marketplace sync failed. Check the repository URL and try again. が出るときにまず見るところ

このエラーに当たる2件の issue は、どちらも「リポジトリを marketplace として追加したときに同期が通らない」という点では同じですが、症状の出方が少し違います。

ひとつは、リポジトリのルートにある plugin が同期から外されるケースです。"source": "./" の plugin で、しかも .claude-plugin/plugin.json がリポジトリのルートにある構成で起きています。報告では、Claude Code CLI の /plugin marketplace add では問題なく同期できるのに、claude.ai 側の「Customize > Plugins > Add marketplace > from a repository」では、root の plugin だけを載せた marketplace だとダイアログがただの

Marketplace sync failed. Check the repository URL and try again.

になるとされています。別の working な entry を一緒に入れると同期自体は通るものの、Manage marketplaces には root plugin が 1 plugin skipped として出て、理由は plugin.json must be at .claude-plugin/pl... で始まっています。これが #106574 です。

もうひとつは、"source": "./" を使い、.claude-plugin/plugin.json を置かない marketplace です。こちらは issue の報告では、claude plugin validate . --strict が CLI 2.1.153 と 2.1.259 の両方で通り、claude plugin marketplace add と claude plugin install でも問題なく動くのに、Claude Desktop の「Cowork → Customize → Plugins → Personal → Add from repository」では同期に失敗するとされています。画面上はやはり同じ generic な文言しか出ず、実際の理由は ~/Library/Logs/Claude/claude.ai-web.log に MARKETPLACE_ERROR:REMOTE_SYNC と出る、という説明でした。これは #91933 です。

手元で確認できる一次情報は環境情報だけでした。

[env_summary]
OS          : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python      : 3.8.13
検証日時    : 2026-11-02T08:56:40+09:00

このため、ここから先で断定できるのは「少なくとも issue の報告上、このエラーは root 配置の plugin と source: "./" の扱いで起きている」というところまでです。特に、claude.ai / Claude Desktop の UI は失敗理由を隠してしまうので、同じ文言が出ても中身は別の問題かもしれません。

自分のケースかどうかを切り分けるなら、まず marketplace の中身を見ます。source: "./" の plugin があるか、plugin がリポジトリのルートを指しているか、.claude-plugin/plugin.json を root に置いているか、あるいは置いていないか。issue では、このあたりの違いで CLI と UI の結果が分かれています。UI だけで止まるなら、少なくとも報告済みの2件と同系統の可能性があります。

ただし、現時点で確認できるのは issue の報告内容だけで、修正済みかどうか、回避策として何をすべきかまでは分かりません。少なくとも今ある情報では、generic なエラー表示だけでは判断できず、実際の構成とログを見る必要があります。


検証環境

OS          : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python      : 3.8.13
検証日時    : 2026-11-02T08:56:40+09:00

参照した Issue(anthropics/claude-code): #106574, #91933

同じ著者の記事