Common Elements

Claude 向け Common Elements プラグイン

コミュニティ協会向け情報ネットワークであるCommon Elementsが提供する、Claude chat、Cowork、Claude Code 向けのプラグインマーケットプレイスです。

プラグイン	追加される機能
common-elements	ホスト型 Common Elements MCP サーバーに加え、協会の調査、業者の検索、RFP の実施、法令の確認、理事会および管理体制の変更追跡を行うスキル

インストール

Claude chat および Cowork では、Customize > Plugins からこのマーケットプレイスを追加し、Common Elements をインストールしてから、プラグインの Connectors タブで接続します。インストールは、現在の Claude 組織ごとに行われます。

Claude Code の場合は、シェルで次を実行します。

claude plugin marketplace add CommonElements/common-elements-claude-plugins
claude plugin install common-elements@common-elements

または、Claude Code 内で次を実行します。

/plugin marketplace add CommonElements/common-elements-claude-plugins
/plugin install common-elements@common-elements

次に /mcp を実行し、plugin:common-elements:common-elements を選択して、Common Elements アカウントでサインインします（OAuth）。新しいバージョンを自動で受け取るには、/plugin を開き、Marketplaces、common-elements の順に選択して、自動更新を有効にします。それ以外の場合は、claude plugin update common-elements@common-elements を実行してください。

スキルを使わずにサーバーだけを利用しますか？ claude mcp add --transport http common-elements https://commonelements.com/api/mcp を実行してください。それ以外のすべてのクライアント（ウェブ版およびデスクトップ版の Claude、ChatGPT、Cursor、VS Code、Codex）については、https://commonelements.com/developers/mcp をご覧ください。

Codex は同じリポジトリを読み込みます：codex plugin marketplace add CommonElements/common-elements-claude-plugins。

正直に言うと、このプラグインでできること

• 協会の記録：州の登録簿やその他の公的記録に基づく、HOA、コンドミニアム、協同組合の協会情報です。無料アクセスでは公的記録の基本情報を取得できます。管理、役員、変更フィード、建物の安全性、ハザードリスクなどの詳細セクションには、有料の Data プランが必要です。情報の網羅状況は州や郡によって異なり、すべての応答にデータの出典が記載されます。
• 法令：米国のコミュニティ協会関連法令の全文検索と条文のほか、その目的で明示的に提供されたテキストを対象とする読み取り専用のコンプライアンススキャンを利用できます。これは参考情報であり、法的助言ではありません。
• 業者と RFP：州の免許委員会の記録に基づく請負業者やその他の免許を持つ企業、免許の確認、ならびに業務の掲載や提案の審査に使う RFP Hub を利用できます（下書きは非公開で、公開には確認が必要です）。検索可能な、検証済み Common Elements 業者プロフィールの一覧はまだ小規模で、現在拡大中です。検証を完了した業者のみが掲載されています。
• Common Elements は、協会がすでに利用している管理ソフトウェアや会計ソフトウェアを補完します。管理ソフトウェアや会計ソフトウェアではありません。

データとプライバシー

理事会メンバー、役員、免許保持者など、個人の連絡先情報（メールアドレス、電話番号、郵送先住所）が MCP サーバーから返されることはありません。理事会メンバーおよび役員のデータは、公的記録に記載された氏名と役職です。このサービスは、リクエストされたアカウントコンテンツを保存し、アカウントが有効な間、利用ログと操作ログを保持します。プラグインの READMEに、データの送信、保持、取り消しについて記載されています。プライバシーポリシー：https://commonelements.com/privacy。お問い合わせ：[email protected]。

リリース（メンテナー向け）

1. plugins/common-elements/ 内のプラグインを変更します。スキルでは、稼働中のサーバー（Common Elements アプリの apps/web/app/api/[transport]/_lib/）に存在するツール名を使用してください。ツール名を変更する場合は、同じリリースでスキルも更新してください。
2. plugins/common-elements/.claude-plugin/plugin.json（およびその隣にある Codex の plugin.json）の version を更新します。バージョンはプラグインマニフェストにのみ記載し、marketplace.json には記載しません。ユーザーが利用している古いコピーは、変更が反映されるまでそのままです。
3. claude plugin validate . と claude plugin validate --strict plugins/common-elements が成功する必要があります。CI では両方を実行します。
4. ローカルのチェックアウトから隔離された設定でインストールし、スキルと MCP サーバーが読み込まれることを確認します。

   export CLAUDE_CONFIG_DIR=$(mktemp -d)
   claude plugin marketplace add ./
   claude plugin install common-elements@common-elements
   claude plugin details common-elements@common-elements
   

5. claude plugin eval plugins/common-elements --no-publish を実行し、接続あり／なしの結果を確認します。同梱のオフラインシナリオでは、安全なフォールバック動作を検証しますが、MCP Inspector と Claude を使ったライブツールのテストや、サポート対象の各環境でのテストに代わるものではありません。
6. PR を作成し、必要な証拠がそろったらマージします。任意で、プラグインのディレクトリから claude plugin tag --push を実行できます。

公開済みのプラグイン名は変更しないでください。名前の変更が避けられない場合は、marketplace.json の renames に旧名を追加します（{"old-name": "new-name"}）。このマップは追記専用です。エントリーを削除すると、旧名を使っているユーザーがそのプラグインを利用できなくなります。

ライセンス

このリポジトリ内のファイルは MIT ライセンスです。Common Elements 自体は、利用規約の適用対象です。