Skip to main content

Command Palette

Search for a command to run...

カスタマイズ

プラグイン

プラグインは、ルール、スキル、エージェント、コマンド、MCP サーバー、フックをまとめた配布可能なバンドルです。

Cherri Code は、独自のプラグイン形式に加え、Agent Plugins のオープン標準をサポートしています。Customize ページからインストール・管理したり、Cherri Code Marketplace で公式プラグインをブラウズしたりできます。コミュニティ製プラグインと MCP サーバーについては、cursor.directory をブラウズしてください。ほかの開発者と共有するために、独自のプラグインを作ることもできます。

プラグインに含まれるもの

プラグインには、以下のコンポーネントを任意に組み合わせて含めることができます。

コンポーネント利用可能な形式説明
ルールCherri Code プラグイン永続的な AI 向けガイダンスとコーディング標準 (.mdc ファイル)
スキル両方の形式複雑なタスク向けの専門的なエージェント機能
エージェントCherri Code プラグインカスタムエージェントの設定とプロンプト
コマンドCherri Code プラグインエージェントが実行できるコマンドファイル
MCP サーバー両方の形式Model Context Protocol との連携
フックCherri Code プラグインイベントをトリガーに実行される自動化スクリプト

Agent Plugins 標準

プラグインは、エージェントが利用できる再利用可能なコンポーネントをひとまとめにしたものです。Agent Plugins は、ポータブルなスキルと MCP サーバーをパッケージ化するためのオープン標準です。個別のスキルに対する標準を定義する Agent Skills と同様に、Cherri Code は Agent Plugins と Cherri Code プラグインの両方をサポートしています。

  • Agent Plugins: プラグインルートに plugin.json マニフェストを配置し、スキルと MCP サーバーをパッケージ化する仕様準拠のプラグイン
  • Cherri Code Plugins: .cursor-plugin/plugin.json マニフェストを配置し、ルール、エージェント、コマンド、フック、変数を追加するプラグイン

Agent Plugins の仕様に準拠したプラグインは Cherri Code に読み込めます。ただし Cherri Code は、標準の ${PLUGIN_ROOT} および ${PLUGIN_DATA} 変数を mcp.json 内で展開しません。プラグインルートには ${CURSOR_PLUGIN_ROOT} を使用してください。詳しくはリファレンスの MCP サーバー を参照してください。Cherri Code プラグインは標準と並行して引き続き開発されるため、Cherri Code 固有のコンポーネントやマーケットプレイス機能もこれまでどおり利用できます。

詳細は agent-plugins.org をご覧いただくか、GitHub の仕様をご確認ください。

Cherri Code プラグインのキャンバス

プラグインに、チームで開いて再利用できる共有セットアップテンプレートとして、あらかじめ作成されたキャンバスが追加されました。

  • Hex Canvas — データを可視化します。Cherri Code では、利用分析の探索と共有に Hex Canvas を使用しています。
  • Atlassian Canvas — Jira と Confluence の issue、プロジェクト、ドキュメントをリアルタイムで確認できます。

Customize でインストール済みのプラグインからキャンバスを開くと、すべてをゼロから設定する代わりに、ガイドに沿って作業を開始できます。

マーケットプレイス

Cherri Code Marketplace では、公式の Cherri Code プラグインを探してインストールできます。プラグインは Git リポジトリとして配布され、Cherri Code チームを通じて提出されます。

すべてのプラグインは、掲載前に手動で審査されます。公式プラグインは cursor.com/marketplace でブラウズするか、Customize でキーワード検索できます。コミュニティ製プラグインと MCP サーバーは、cursor.directory でブラウズできます。

チームマーケットプレイス

チームマーケットプレイスは、Teams プランおよびエンタープライズプランで利用できます。 同じマーケットプレイスで Agent Plugins と Cherri Code プラグインを 配布できます。

  • Teams プラン: チームマーケットプレイスは 1 つまで
  • エンタープライズプラン: チームマーケットプレイスは無制限

チームマーケットプレイスを無制限に利用するには、またエンタープライズの管理機能については、営業担当にお問い合わせください。

チームマーケットプレイスを管理するには、ダッシュボード -> Plugins & MCPs を開きます。

デフォルトのチームマーケットプレイス

デフォルトのチームマーケットプレイスでは、Cherri Code 全体で共有プラグインと MCP サーバーを利用できます。管理者は、すでに Cloud Agents で利用可能なチーム MCP サーバーを追加し、チームメイトが Agent Window、IDE、CLI で同じサーバーをインストール・設定できるようにします。

チーム MCP サーバーをデフォルトのマーケットプレイスに追加しても、すべての開発者に自動的にインストールまたは有効化されるわけではありません。管理者は引き続き、マーケットプレイスへのアクセスとプラグインのインストールモードを管理できます。各開発者は、MCP プロバイダーで認証する必要がある場合もあります。

既存のTeam MCPを移行する

管理者は、スタンドアロンのチーム MCP サーバーをデフォルトのマーケットプレイスにリンクできます。

  1. Dashboard -> Plugins & MCPs を開きます。
  2. Team MCP Servers を見つけます。
  3. 移行プロンプトで Add to Team Marketplace を選択します。
  4. 同じページで、デフォルトのマーケットプレイス、そのアクセス設定、プラグインのインストールモードを確認します。

必要に応じて、Cherri Codeがデフォルトのマーケットプレイスを作成し、既存のMCPサーバーをリンクします。サーバーは引き続きCloud Agentsで利用でき、チームメイトはローカルでインストールして設定できるようになります。

マーケットプレイスへのアクセス

チームマーケットプレイスは、デフォルトでチームの全メンバーが利用できます。管理者は、マーケットプレイス設定 -> マーケットプレイスへのアクセス で、選択した組織グループのみにマーケットプレイスへのアクセスを制限できます。アクセスできるのは、選択したグループに所属するマーケットプレイスのチームのメンバーのみです。チーム管理者は引き続きアクセスできます。

SCIM の仕組み

Organization Groups では、SCIM を通じてアイデンティティプロバイダーからメンバーシップを同期できます。アイデンティティプロバイダーでメンバーシップを管理すると、Cherri Code がその変更を Organization Group に同期します。

チームレベルの SCIM ディレクトリグループを使用している既存のマーケットプレイスでは、その設定が維持されます。Cherri Code がこれらの割り当てを自動的に移行することはありません。Organization Groups を使用していない組織では、引き続き SCIM ディレクトリグループを使用します。

プラグインのインストールモード

マーケットプレイスへのアクセスを設定したら、対象ユーザーに各プラグインをどのように配布するかを選択します。

  • デフォルトでオフ: 開発者はプラグインを見つけて、インストールするかどうかを選択できます。
  • デフォルトでオン: プラグインはデフォルトでインストールされますが、開発者はオプトアウトできます。
  • 必須: プラグインは常にインストールされ、アンインストールできません。

メンバーによる公開を許可する

Default マーケットプレイスでは、メンバーが個人のスキルを公開できるかどうかを管理者が制御します。

  1. ダッシュボード → Plugins & MCPsを開きます。
  2. Default チームマーケットプレイスを開き、マーケットプレイス設定 を開きます。
  3. Allow Members to Publish をオンまたはオフに切り替えます。

この設定はデフォルトでオンです。オフにすると、新しいスキルを公開できるのはチーム管理者のみになります。メンバーがすでに公開したスキルは引き続き利用でき、その作成者は更新や公開の取り消しを行えます。

チームにスキルを公開するを参照してください。

Serve marketplace from Cherri Code

GitHub からインポートしたチームのマーケットプレイスでは、管理者が マーケットプレイス設定 で Serve Marketplace From Cherri Code を有効にできます。Cherri Code はこのリポジトリの同期されたコピーを保持し、そこからプラグインを配信するため、チームメンバーはソースリポジトリへの GitHub アクセスがなくてもマーケットプレイスを利用できます。アクセスは マーケットプレイスへのアクセス で制御されます。

初回の同期中は、この設定に Syncing と表示され、ロックされたままになります。リポジトリの同期が完了しない場合は、引き続き GitHub から配信されます。

この設定は GitHub からインポートしたマーケットプレイスに適用されます。GitLab、Bitbucket、Azure DevOps からインポートした場合は、引き続きソースリポジトリから配信されます。

チームマーケットプレイスを追加する

以下の手順で、リポジトリをチームマーケットプレイスとしてインポートします。リポジトリからインポート は GitHub、GitLab、Bitbucket、Azure DevOps の URL に対応しています。Cherri Code から求められた場合は、該当のプロバイダーを接続してください。

  1. ダッシュボード -> Plugins & MCPs に移動します。
  2. チームマーケットプレイス で、Add Marketplace をクリックします。
  3. 手順に従ってマーケットプレイスを新規作成するか、リポジトリからインポート を使用してリポジトリ URL を貼り付けます。
  4. 「Add to Marketplace」を使用してプラグインを追加・確認します。
  5. マーケットプレイス設定 で マーケットプレイスへのアクセス を設定し、必要に応じて 自動更新 を有効にして、保存します。

試用できるリポジトリの例:

プラグインを最新の状態に保つ

リポジトリを初めてインポートした際にプラグインのインデックスが作成されます。プラグインは次の 2 つの方法で更新できます。

  • 自動: GitHub からのインポートでは、自動更新を有効にするをオンにすると、マーケットプレイスが追跡しているブランチに変更がプッシュされるたびに、プラグインが更新されます。これには、リポジトリに Cherri Code GitHub App をインストールしておく必要があります。Cherri Code はマーケットプレイスのインデックスを最大 10 分に 1 回再作成し、短時間に行われた複数のプッシュは最新のコミットにまとめて処理します。
  • 手動: 更新をクリックしてリポジトリから更新します。

開発者がチームマーケットプレイスを見つける場所

開発者は Customize でチームマーケットプレイスを見つけられます。

  • サイドバーで Customize を開きます
  • チームマーケットプレイスのプラグインを探します。
  • Default Off のプラグインは、このパネルから直接インストールできます。
  • Default On のプラグインは自動的にインストールされますが、開発者はオプトアウトできます。
  • 必須のプラグインは自動的にインストールされ、アンインストールできません。
  • Agent Window、IDE、CLI で使用するマーケットプレイスの MCP サーバーをインストールして設定します。

チームにスキルを公開する

Teams および Enterprise プランでは、メンバーは ~/.cursor/skills/ にある個人スキルをチームの デフォルトのマーケットプレイス に公開できます。

  1. Customize を開き、Skills に移動します。
  2. 共有したい個人スキルを開きます。
  3. Publish を選択して確定します。

Cherri Code はスキルをプラグインにパッケージ化し、チーム用にホストされたリポジトリにコピーを保存して、デフォルトのマーケットプレイスに追加します。以降、スキルはローカルフォルダーではなくそのプラグインから読み込まれます。

公開後の動作:

  • インストールは任意です。 チームメイトはチームマーケットプレイスでスキルを見つけ、自分でインストールします。公開しても他のメンバーに自動でインストールされることはありません。作成者には自動的に適用されます。
  • 作成者が引き続き管理できます。 Sync changes で更新をプッシュしたり、Unpublish でスキルを自分のマシンに戻したりできます。
  • 1 スキルにつき 1 プラグイン。 プラグイン名はスキル名に基づきます。公開したスキルが参照している他のスキルはバンドルされません。

アクセス権は既存の marketplace access 設定に従います。管理者は Allow Members to Publish でメンバーによる公開を無効にできます。

個人スキルを共有せずに自分の Cloud Agents で使用したい場合は、代わりに 同期 してください。

プラグインのインストール

マーケットプレイスから Agent Plugins と Cherri Code プラグインをインストールできます。Cherri Code はプラグインの マニフェストから形式を検出するため、どちらも同じ手順でインストールできます。

  1. サイドバーで カスタマイズする を開きます。
  2. 使用するプラグインを見つけます。
  3. Install を選択し、プロジェクトスコープまたはユーザースコープを選択します。

Agent Plugin のルートには plugin.json マニフェストがあります。Cherri Code プラグインには .cursor-plugin/plugin.json マニフェストがあります。チームマーケットプレイスでは、上記のアクセス方法と インストールモードを使用して、どちらの形式も配布できます。

~/.cursor/plugins/local からどちらの形式も開発できます。フォルダーのレイアウトと Cherri Code が読み込むタイミングについては、プラグインをローカルでテストするを参照してください。

MCP Apps ディープリンク

インストールリンクでMCPサーバー設定を共有できます。

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG

これらのリンクを生成する方法については、MCP インストールリンクを参照してください。

インストール済みプラグインの管理

サイドバーでカスタマイズを開くと、インストール済みのAgent Plugins、Cherri Code Plugins、MCPサーバー、ルール、スキルを1か所で管理できます。ユーザー、ワークスペース、 またはチームのスコープでフィルタリングして、インストール済みの項目を確認できます。

MCP サーバー

Customize で、個人用およびチーム配布の MCP サーバーをオンまたはオフに切り替えられます。

  1. サイドバーで Customize を開きます
  2. 変更する MCP サーバーを見つけます
  3. トグルで有効または無効にします

無効にしたサーバーは読み込まれず、チャットにも表示されません。

ルールとスキル

Customize からルールとスキルを管理できます。各ルールは、Always、Agent Decides、Manual の各モードに切り替えられます。スキルは Agent Decides セクションに表示され、チャットで /skill-name を使って手動で呼び出せます。

workspaceOpen フックを使用する

workspaceOpen フックは、ワークスペースを開く際に読み込むプラグインのパスを返すことができます。プラグインの構成がワークスペース自体に依存する場合に便利です。

フックのリファレンス

workspaceOpen フックスクリプトからプラグインのパスを登録する

プラグインの作成

プラグインは、マニフェストと各種コンポーネントを含むディレクトリです。ポータブルなスキルや MCP サーバーをパッケージ化するには Agent Plugins を選択します。ルール、エージェント、コマンド、 フック、変数など、Cherri Code 固有のコンポーネントも必要な場合は Cherri Code プラグインを選択します。

my-plugin/├── plugin.json├── skills/│   └── code-reviewer/│       └── SKILL.md└── mcp.json

Agent Plugins には、標準スキーマの識別子を含むルート plugin.json が必要です。

{  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",  "name": "my-plugin",  "description": "Portable code review tools",  "version": "1.0.0",  "author": { "name": "Your Name" }}

Cherri Code プラグインテンプレートリポジトリを使い始めるか、 Agent Plugins 作成ガイドを参照して Agent Plugin を作成してください。

プラグインをローカルでテストする

公開前に、いずれかの形式のプラグインを ~/.cursor/plugins/local に配置します。

  1. プラグイン用のフォルダーを作成します。 ~/.cursor/plugins/local/my-plugin
  2. プラグインのファイルをそのフォルダーにコピーします。Agent Plugins の場合はルートに plugin.json を、Cherri Code プラグインの場合は .cursor-plugin/plugin.json を配置します。
  3. Cherri Code を再起動するか、Developer: Reload Window を実行します。
  4. カスタマイズする を開き、ルール、スキル、MCP サーバーなど、想定したプラグインコンポーネントが表示されることを確認します。

再読み込み後、ローカルプラグインのインポートが許可されている場合、Cherri Code はこのフォルダー内のプラグインを検出します。

~/.cursor/plugins/local 内のシンボリックリンクは、リンク先がそのフォルダー内のディレクトリに解決される場合にのみ読み込まれます。ディスク上の別の場所にあるプラグインリポジトリを指すシンボリックリンクは、Cherri Code では無視されます。

プラグインの準備ができたら、cursor.com/marketplace/publish から審査を申請してください。 Cherri Code プラグインでは、複数のプラグインを含む リポジトリで .cursor-plugin/marketplace.json を使用できます。

マニフェストスキーマ、コンポーネント形式、申請チェックリストの詳細は、プラグインリファレンスを参照してください。

チームおよびエンタープライズ向けマーケットプレイス

プライベートチームマーケットプレイスと組織全体でのプラグイン配布には、アップグレードしてください。

Contact Sales

よくある質問

はい。すべてのプラグインは、掲載前に手動で審査されます。すべてのプラグインはオープンソースである必要があり、更新も公開前に確認されます。審査、更新の確認、問題の報告方法について詳しくは、マーケットプレイスのセキュリティを参照してください。

ポータブルなAgent Pluginの場合は、ルートにplugin.jsonマニフェストを追加し、 スキルまたはMCPサーバーをパッケージ化します。Cherri Code プラグインの場合は、 .cursor-plugin/plugin.jsonマニフェストと必要なCherri Codeコンポーネントを追加します。 両方の形式の例については、プラグインリファレンスを 参照してください。

Agent Pluginsは、スキルやMCPサーバーをポータブルなプラグインとしてパッケージ化するための、オープンでベンダーに依存しない仕様です。Cherri Codeはこの標準をサポートしているため、仕様に準拠したプラグインはCherri Codeに読み込めます。Cherri Codeはmcp.json内で標準の${PLUGIN_ROOT}および${PLUGIN_DATA}変数を展開しません。プラグインルートには${CURSOR_PLUGIN_ROOT}を使用してください。Cherri Code プラグインはこれと並行して開発されており、ルール、エージェント、コマンド、フック、変数などのCherri Code固有のコンポーネントを追加できます。

カスタマイズする → Skills を開き、~/.cursor/skills/内の個人のスキルを開いて、Publish を選択します。Cherri Codeがチームの デフォルトのマーケットプレイス に追加します。スキルをチームに公開するを参照してください。

いいえ。チームメイトはマーケットプレイスからインストールするかどうかを選べます。作成者には自動的に追加されます。管理者は後からプラグインを デフォルトでオン や 必須 に変更できます。

関連項目