> ## Documentation Index > Fetch the complete documentation index at: https://docs.devin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Devin のプラグインと Customize ページ > Customize ページから Devin のプラグインをインストールし、インデックス作成の問題を解決し、MCPサーバーを接続して、個人・組織・Enterprise の各スコープを管理します。
## プラグインとは？
**プラグイン**は、スキル — および任意でルール、フック、MCP サーバー、サブエージェント — をまとめたもので、ひとまとまりとしてインストールおよび再利用できます。ファイル形式とプラグインに含められるものについては、[プラグイン リファレンス](/ja/cli/extensibility/plugins/overview) を参照してください。 プラグインは、**cloud Devin セッション**、[**Devin CLI**](/ja/cli/index)、**Devin Desktop** に共通するカスタマイズ層です。一度インストールすれば、そのスキルは Devin を利用するあらゆる場所で `/:` コマンドとして利用できるようになります。プラグインは次の 3 つのレベルでインストールできます。 | スコープ | インストールする人 | 適用される対象 | | -------------- | -------------- | -------------------------------------------------- | | **Personal** | 自分 | 自分のセッション — クラウド、CLI、Desktop。サインインしているすべてのデバイスで有効 | | **組織** | org 管理者 | その組織のクラウドセッション、および当該組織を主要な組織とするメンバーの CLI と Desktop | | **Enterprise** | Enterprise 管理者 | その Enterprise 内のすべての組織の全員 | このページでは、プラグインの Web アプリ側について説明します。Customize ページ、各スコープでのインストール、indexing、MCP、そしてそれらを支える管理対象のマニフェストを扱います。
## Customize ページ
プラグインは [**Customize**](https://app.devin.ai/customize) ページにあり、サイドバーの **Customize** 項目から開けます (従来の Settings → プラグイン、Settings → Marketplace、Settings → Connections → MCP サーバーの各ページを置き換えたもので、古いリンクはリダイレクトされます) 。次の 5 つのタブがあります。 * **プラグイン** — インストール済みのすべての項目をスコープごとにまとめて表示します。さらに **Browse marketplace** から追加インストールできます。 * **スキル** — インストール済みプラグインと自分のリポジトリから、Devin が必要に応じて読み込むスキル。 * **MCPs** — 標準搭載のツールを超える機能を Devin に提供する MCP サーバー。下記の [MCPs](#mcps) を参照してください。 * **フック** — セッション中の特定のタイミングで自動的に実行されるコマンド。下記の [フック](#hooks) を参照してください。 * **ルール** — スコープ内のセッションに適用される恒久的なガイダンス。下記の [ルール](#rules) を参照してください。 スコープタブでは、自分のアクセス権に応じて **Personal**、**組織**、**Enterprise** を選択します。各スコープには、ガバナンス適用後に実際に有効となる内容が表示されます。リポジトリ単位の内容 (リポジトリの `.devin/config.json` で宣言されたスキル、ルール、プラグイン) を変更するには、そのリポジトリのファイルを編集してください。 誰が何を変更できるか： * **Personal** — 誰でも、自分のスコープについて変更できます。 * **組織** — 組織設定へのアクセス権を持つメンバー。 * **Enterprise** — Enterprise 設定へのアクセス権を持つメンバー。 プラグインをクリックすると詳細シートが開き、そのスキル、MCP、フック、ルール、サブエージェント、追跡中の ref または固定された SHA とパス、どのスコープにインストールされているか・何がそれを必要としているか、権限が表示されます。また、権限がある場合は、MCP の接続、必要とする内容の変更、アンインストール、 (アップロードしたプラグインの場合は) 削除といった操作を実行できます。
## プラグインのインストール
### marketplace から
プラグインタブで **Browse marketplace** をクリックします。marketplace は、**Devin 公式 marketplace** ([CognitionAI/devin-marketplace](https://github.com/CognitionAI/devin-marketplace)。Linear、Notion、Datadog、Snowflake などの統合ごとに 1 つのプラグインを用意しています) と、組織または enterprise が追加したプラグインを 1 つのリストにまとめたものです。各カードには書き込み可能なすべてのスコープを含むインストールメニューがあり、そのプラグインが既にインストールされている場所も表示されます (「Installed for me」「Installed at organization」など) 。 プラグインを初めてインストールする際には、Devin が**セキュリティに関する注意**を表示します。インストールすると、Devin はそのプラグインのルール、フック、スキルを実行できるようになります (MCP サーバーを含むプラグインの場合は、それらを通じて外部データにアクセスできるようになります) 。そのプラグインを信頼でき、ソースを確認済みの場合にのみ続行してください。公式 marketplace のプラグインにはその旨が表示されます。 インストール後は、スコープを確認する toast が表示されます。認証情報や認可が必要な MCP サーバーを含むプラグインの場合は、その場でセットアップを完了できる **Connect MCP** も表示されます。 Enterprise admins は、すべての組織に対して公式 marketplace を非表示にでき (**Show official marketplace plugins** スイッチ) 、**Marketplace availability** で組織に表示する marketplace の MCP サーバーを制御できます。
### リポジトリ、`.zip`、または Editor から
プラグインタブの **Add plugin** メニューでは、さらに 3 つのソースを利用できます。いずれも書き込み権限のある任意のスコープにインストールできます。 | 配置場所 | 追加方法 | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **Git リポジトリ** (公開・非公開を問わず) | **From repository** — `owner/repo` または git URL を入力します。プラグインがサブフォルダにある場合はサブディレクトリも指定してください。Git 統合を通じて Devin がアクセスできる非公開リポジトリであれば利用できます。 | | **リポジトリ以外** | **Upload .zip** — アップロードしたプラグインバンドルはスコープとともに保存され、そのスコープ内の全員に対してインストールされます。 | | **まだ存在しない** | **Create plugin** — **Preview**/**Source** タブと **Version history** を備えたファイルエディタです (保存するたびに復元可能なバージョンが作成されます) 。 | アップロードしたプラグインや作成したプラグインは、後から詳細シートで編集できます。削除するとファイルは完全に失われ、他に複製は残りません。プラグインファイルにシークレットを記載せず、代わりに[シークレット参照](#plugin-environment-variables)を利用してください。
### CLI から
`devin plugins install ` は、デフォルトでプラグインを**パーソナル**スコープに追加するため、クラウドセッションや他のデバイスにも引き継がれます。現在のマシンにのみインストールする場合は `--local` を指定してください。詳細は[CLI コマンド](/ja/cli/extensibility/plugins/overview#installing-a-plugin)を参照してください。
### Devin に任せる
クラウドセッションでは、Devin に対して、何かを個人用のスキル、ルール、hook、MCP サーバーとして保存したり、plugin をインストールしたりするよう依頼できます。Devin は変更をカード形式で提案するので、承認または拒否してください。承認された変更は個人用のスコープに反映され、以降のセッションに適用されます。
## プラグインがセッションに届くしくみ (クラウド ↔ ローカルの同期)
すべてのスコープは、Devin Cloud に保存された **管理対象のマニフェスト** に支えられています ([The manifest](#the-manifest) を参照) 。どこからインストールしてもその manifest に書き込まれ、すべての対象がそれを読み取ります。 * **クラウドセッション**は開始時に enterprise、組織、個人の manifest を取得し、そこから得られたプラグインを、クローンするリポジトリが宣言したプラグインとあわせてセッションのマシンにインストールします。 * **Devin CLI** と **Devin Desktop** は、サインインしていれば同じ manifest を取得します。そのため、Web でインストールしたプラグインはお使いのノートパソコンにも表示され、ノートパソコンで実行した `devin plugins install` の結果は次のクラウドセッションに反映されます。非公開リポジトリのプラグインはローカルの git 認証情報で取得されるため、ご自身にそのリポジトリへのアクセス権が必要です。enterprise では CLI プラグインを完全に無効化することもできます (enterprise settings の **Devin CLI plugins**) 。 * **個人利用のユーザー** (組織なし) は個人スコープのみを利用できます。 実行中のセッションは開始時に読み込んだ内容を保持し、変更は**次の**セッションから適用されます。 プラグインのインストールと MCP の認証は別の手順です。クラウドの MCP は [Customize → MCPs](#mcps) から接続してください。CLI で動作するプラグインの OAuth サーバーには [`devin mcp login`](/ja/cli/extensibility/mcp/configuration#troubleshooting) を利用します。プラグインを同期しても、すべてのデバイスが同じ認証情報を共有するわけではありません。
## インデックス
Devin は各スコープのプラグインの**インデックス**を保持します。各プラグインのソースをクローンし、マニフェストと内容を読み取り、依存関係を解決し、ガバナンスを適用します。Customize ページにはインデックスの結果 (プラグイン、そのスキル、MCP、フック、ルール、およびポリシーによってブロックされたもの) が表示され、ステータス行には各スコープが最後にインデックスされた時刻が示されます。 * **実行のきっかけ** — プラグインのインストール、削除、編集を行うと、再インデックスが自動的にキューに入ります。プラグインのソースリポジトリに変更をプッシュした後にインデックスを更新するには、**プラグイン設定 → Reindex plugins** を利用してください。 * **実行中の状態** — 実行の状態は scheduled、queued、starting、indexing のいずれかです。再インデックスが頻繁な場合は間隔が空けられ、アップロードしたバンドルの保存はキューに入るまで少し時間がかかることがあります。プラグイン MCP は、その設定がインデックスされた後に接続できます。 * **結果** — **プラグイン設定** (歯車メニュー) を開くと、最後にインデックスされた時刻と発生した問題を確認できます。更新に失敗した場合、直前に成功した結果が表示されたままになることがあります。プラグインが一覧に表示されていても、最新の更新が成功したとは限りません。 * **リポジトリへのアクセス** — リポジトリからインデックスされたプラグインの内容は、Git 統合を通じて当該リポジトリへのアクセス権を持つ組織にのみ表示されます。アクセス権がない場合、そのスコープの内容は *Plugin repos unauthorized* という通知とともに**保留**されます。**Settings → Repositories** でリポジトリへのアクセスを許可してください。なお、保留されたスコープのガバナンス (その禁止設定) は引き続き適用されます。 * **ネットワークポリシー** — インデックスは、組織の[セッションネットワークポリシー](/ja/product-guides/security-profiles)を継承したマシン上で実行されるため、プラグインのソースはそのポリシー下で到達可能である必要があります。 セッション自体はインデックスを待ちません。開始時にプラグインを直接取得してインストールします。
### インデックスの問題を解決する
1. プラグインが必要な組織で [Customize → Plugins](https://app.devin.ai/customize) を開きます。**Personal**、**組織**、**Enterprise** のいずれかのスコープを選択し、**プラグイン設定** を開いて、問題の内容と、そこに示されているプラグインまたはスコープを確認します。 2. 実行が scheduled、queued、starting、indexing のいずれかの状態であれば、完了するまで待ちます。プラグインが一度もインデックスされていない場合や、前回のインデックス以降にソースが変更された場合は、**Reindex plugins** を選択します。 3. 実行が failed の場合やコンテンツが見つからない場合は、以下の該当する対処法を利用します。修正を保存またはコミットしたうえで **Reindex plugins** を選択し、結果を再度確認します。共有マニフェストやリポジトリ権限の変更には、管理者の対応が必要になる場合があります。 | メッセージまたは症状 | 対応内容 | | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Plugin repos unauthorized** | 管理者に依頼して、[Settings → Repositories](https://app.devin.ai/settings/repositories) から、該当する組織に対し、問題に示されたすべてのリポジトリへのアクセス権を付与してもらってください。Enterprise プラグインでは、複数の組織にリポジトリアクセスを付与する必要がある場合があります。プラグインをマニフェストに追加しても、リポジトリアクセスは付与されません。 | | **Plugin source could not be cloned** または **Repository unavailable** | リポジトリの URL、ブランチまたはタグ、pin されたコミットを確認します。すでにリポジトリ一覧に表示されている場合でも、その組織にリポジトリの読み取り権限があることを確認してください。Git ホストに到達できない場合は [ネットワークポリシー](/ja/product-guides/security-profiles) を確認します。アクセス権やソース参照を修正したら、再インデックスしてください。 | | **No plugin manifest found** | ソースがプラグインのディレクトリを指しているか確認します。サブフォルダ内にあるプラグインは、ソース参照にそのサブディレクトリを含める必要があります。想定される場所に [サポートされているマニフェスト](/ja/cli/extensibility/plugins/overview#compatible-formats) を配置してください。 | | **Plugin manifest malformed**、**Skill malformed**、**MCP config malformed**、またはその他の不正な形式のアセット | 問題の **Learn more** リンクを開き、該当する形式を確認します。ソースリポジトリ内、またはアップロードしたプラグインのエディタで、指摘されたファイルを修正します。[マニフェストのフィールド](/ja/cli/extensibility/plugins/overview#manifest)、[skill の frontmatter](/ja/cli/extensibility/skills/creating-skills#frontmatter-reference)、[MCP の設定](/ja/cli/extensibility/plugins/overview#mcp-servers)、およびプラグインルートからの相対パスを確認してください。 | | **Conflicting version pins** | そのプラグインを必要としているマニフェストを確認します。`sha` の値を揃えるか、より上位の権限を持つスコープで pin を指定するようにします。[競合と依存関係](/ja/cli/extensibility/plugins/overview#conflicts-and-dependencies) を参照してください。矛盾する pin は、再インデックスだけでは解決できません。 | | **Plugin source not pinned** | これはインデックスの失敗ではなく、注意喚起です。プラグインがブランチまたはタグを追跡している状態です。固定されたバージョンが必要な場合は、[コミットに pin してください](#pinning-a-plugin)。 | | **Could not load plugin contents** または **Indexed content unavailable** | **Reindex plugins** を選択して、インデックスされたコンテンツを再構築します。代わりにページに **Couldn't load your configuration** と表示される場合は、**Try again** で読み込みを再試行してください。 | | **Installed but blocked** | どのスコープがそのプラグインを禁止しているかを確認し、ポリシーの所有者にレビューを依頼してください。下位のスコープからそのポリシーを上書きすることはできません。[ガバナンス](#governance) を参照してください。 | インデックスが成功したら、プラグインの詳細を開き、想定どおりのスキル、ルール、フック、MCP が表示されていることを確認します。MCP に認可が必要な場合は、[接続](#mcps) を完了してください。変更後のプラグインの内容を利用するには、新しいセッションを開始します。CLI のインストールが古い場合は [`devin plugins update`](/ja/cli/extensibility/plugins/overview#managing-plugins) を利用してください。Customize での再インデックスでは、Web 上の一覧が更新されます。`--local` を指定して行ったインストールは、そのデバイス内にとどまります。 インデックスが繰り返し失敗する場合や、実行が queued や indexing のまま進まない場合は、サポートにお問い合わせください。その際、組織とスコープ、プラグインのソースと参照、最後にインデックスされた時刻、正確なエラー内容、問題のスクリーンショットを添えてください。
## MCPs
MCP サーバーは、Customize の **MCPs** タブで、同じ 3 つのスコープごとに管理します。このタブには 2 種類のエントリーがあります。 * **From plugins** — インストール済みのプラグインが宣言した MCP サーバー。接続設定 (URL、transport、必要な認証情報) はプラグイン側が保持し、read-only で表示されます。ただし、有効化・無効化・接続・アンインストールは可能です。公式 marketplace のプラグインの多くは、1 つの MCP サーバーと、任意で skills で構成されています。 * **Standalone** — 単体でインストールされた MCP サーバー。カスタムサーバー (**Add custom MCP**) と、レガシーの **MCP marketplace** (このタブから引き続きアクセスできます) からインストールしたサーバーが該当します。 **接続について。** APIキーが必要なプラグイン MCP では、secrets をすぐに入力できる Connect シートが開きます。OAuth を利用するものでは provider の認可フローが開き、どちらも不要なものはプラグインをインストールした時点で利用できます。接続は、インストール時の toast、プラグインの詳細シート、または MCP の行から実行できます。 **共有接続とメンバーごとの接続。** 組織または enterprise スコープでインストールした OAuth MCP では、サーバーの **Access** 設定によって接続の共有方法が決まります。**Organization** アクセスでは、スコープ内の全員が 1 つの接続を共有するため、個人のログインではなく **service account** を利用してください。**Personal** アクセスでは、各メンバーが自分のアカウントで認可します。メンバーごとのアクセスに対応していないサーバーで、各メンバーが個別の認証情報を必要とする場合は、プラグイン (または MCP) を個人スコープでインストールしてください。同じ marketplace MCP をメンバーが 1 人ずつ接続しているような場合は、admin が組織向けに一度インストールしておけば、それを宣言するプラグインはその接続を利用します。 **Enterprise MCPs。** Enterprise admins は、サーバーを一度 configure するだけで済みます (顧客ネットワーク経由でルーティングされる MCP トラフィック用の非公開 CA 証明書 bundle の設定を含む) 。あわせて、どの組織に適用するかを選択します。同じサーバーを組織自身がインストールしている場合は、そちらが enterprise の設定を override します。 transport の種類、カスタムサーバーの入力項目、サーバーごとのセットアップに関する注意点については、[MCP サーバー](/ja/work-with-devin/mcp) を参照してください。
## フック
フックは、ツール呼び出しの前後など、セッション中の特定のタイミングで Devin が実行するコマンドです。Hooks タブの **New hook** ではスコープの `hooks.json` を編集でき、変更は新しいセッションから適用されます。認証情報はフック自体ではなく、[プラグインの環境変数](#plugin-environment-variables)を通じて渡してください。フックはベストエフォートで動作するため、失敗してもセッションは停止しません。 ファイル形式については、[フックのリファレンス](/ja/cli/extensibility/hooks/overview)を参照してください。
## ルール
ルールは、チームの規約のように、スコープ内のセッションに常に適用される指針です。Rules タブの **New rule** から、スコープの `rules/` に Markdown ファイルを追加できます。常時適用のルールは簡潔にまとめ、特定の場面でのみ必要となる内容には[スキル](/ja/product-guides/skills)の利用をおすすめします。 ファイル形式と `trigger` オプションについては、[ルールのリファレンス](/ja/cli/extensibility/rules)を参照してください。
## マニフェスト
各スコープの背後には管理対象のマニフェスト (3つのリストを含むJSONドキュメント) があります。Customize UIがこれを代わりに編集しますが、プラグイン タブの **プラグイン設定 (歯車) → マニフェストを編集** から直接操作することもできます。 ```jsonc theme={null} { "requiredPlugins": ["acme/review-tools"], "optionalPlugins": [], "forbiddenPlugins": ["sketchy-org/bad-plugin", "acme/*"] } ``` * **`requiredPlugins`** — スコープ内の全員にインストールされます (再帰的に、依存しているプラグインも含みます) 。UIからインストールすると、ここに項目が追加されます。 * **`optionalPlugins`** — プラグインを自動インストールせずに許可する許可リストです。禁止された項目に対する例外を設けるために利用されます。 * **`forbiddenPlugins`** — プラグインの識別子またはグロブパターンの拒否リストです。 マニフェストはそのまま保存され、エージェントはインストール時に完全なソースを検証します。各項目で指定できる[ソース形式](/ja/cli/extensibility/plugins/overview#manifest)と、完全な[依存関係およびガバナンスのセマンティクス](/ja/cli/extensibility/plugins/overview#dependencies)については、プラグイン リファレンスを参照してください。
## ガバナンス
3 つのリストは、Enterprise、組織、リポジトリ (`.devin/config.json`) 、個人というすべてのレベルで共通のポリシー記述手段であり、上位レベルの設定が優先されます。つまり Enterprise は、どの組織・リポジトリ・ユーザーも削除できないプラグインを必須にしたり、下位のどのレベルからも復活させられないプラグインを禁止したりできます。ポリシーによってブロックされたプラグインは、プラグイン タブの **Installed but blocked** に表示され、そのスキルはセッション開始時にスキップされ、禁止元を示す警告が表示されます。 Enterprise を承認済みのセットに限定するには、`"*"` を禁止したうえで、承認済みのプラグイン (およびその dependencies) を `requiredPlugins`/`optionalPlugins` に列挙します。具体的な設定例は [プラグイン エコシステムを設定する](/ja/product-guides/plugin-ecosystem#6-govern) を、ルールの詳細は [継承とレベル](/ja/cli/extensibility/plugins/overview#inheritance-and-levels) を参照してください。
### スコープと継承
* **スタンドアロンアカウント**には、**アカウント**マニフェスト (Customize では *Organization* と表示) と、各メンバーの個人マニフェストがあります。 * **Enterprise** の場合は、すべての子組織に継承される **enterprise** マニフェストがあり、その下に**組織**単位のマニフェスト、さらにその下に個人マニフェストが重なります。
## 更新の反映タイミング
* **マニフェストの変更** (インストール、削除、マニフェストの編集) は、すべての対象で**次回のセッション**から適用されます。 * **プラグインの内容の変更** — プラグインが追跡しているブランチにマージされた変更は、新しいセッションへ自動的に反映されます (クラウドセッションでは開始時に取得され、CLI では `devin plugins update` の実行時に更新されます)。Customize では次回のインデックス実行後に新しい内容が表示されます。すぐに反映したい場合は **Reindex plugins** をクリックしてください。 * 実行中のセッションでは、開始時に読み込まれた内容がそのまま維持されます。更新によって進行中のセッションが途中で変更されることはありません。
### プラグインの固定
`"owner/repo"` の形式 (または `ref` 付き) で記述されたプラグインはブランチやタグを追従するため、同じマニフェストでも時間の経過とともに異なる内容に解決されることがあります。Customize では、こうした項目が **Plugin source not pinned** と表示されます。プラグインを特定の内容に固定するには、`sha` を指定したオブジェクト形式を利用してください: ```json theme={null} { "requiredPlugins": [ { "source": "github", "repo": "acme/review-tools", "sha": "3f2a9c1d8e4b7a6f5c0d1e2f3a4b5c6d7e8f9a0b" } ] } ``` 固定したプラグインは、SHA を編集するまで一切変更されません。`ref` (ブランチまたはタグ) と `sha` は排他的で、1 つの項目に両方を指定することはできません。これらのフィールドは、`url` および `git-subdir` の[ソース形式](/ja/cli/extensibility/plugins/overview#dependencies)でも同様に機能します。アップロードしたプラグインは、常にアップロードした内容に固定されます。2 つのスコープが同じプラグインを異なる SHA に固定している場合、インデックスは固定の競合を報告します。
## プラグインの環境変数
クラウドセッションで[コマンドフック](#hooks)を設定するには、`requiredPlugins` または `optionalPlugins` の項目に `env` を追加します。認証情報には [Devin Secrets](/ja/product-guides/secrets) を参照し、その他の値にはリテラル文字列を使用できます。 ```json theme={null} { "requiredPlugins": [ { "source": "github", "repo": "acme/review-tools", "env": { "API_KEY": "secret:org:REVIEW_API_KEY", "REVIEW_MODE": "strict" } } ] } ``` 変更を適用するには、新しいクラウドセッションを開始してください。依存関係ごとに、マニフェスト内の項目と`env`が必要です。
### サポートされている参照
```text theme={null} secret:org:NAME secret:enterprise:NAME secret:personal:NAME secret:session:NAME secret:repo:owner/repo:NAME ``` シークレットはセッションから利用できる必要があります。既存のキーと値のシークレットの場合は、`/ENTRY` を追加します。例：`secret:org:AWS_CREDS/ACCESS_KEY_ID`。 プラグインの MCP 設定では、シークレットを `${NAME}` として参照します。メンバーはサーバーの詳細シートから値を指定し、設定に直接書き込まれたリテラル値は削除されます。
## 詳細情報
* [プラグイン リファレンス](/ja/cli/extensibility/plugins/overview) — プラグインのファイル形式、manifest、ガバナンスの動作、CLIコマンド * [プラグイン エコシステムを設定する](/ja/product-guides/plugin-ecosystem) — 独自のプラグイン リポジトリを構築・運用する * [クイックスタート: チーム marketplace](/ja/cli/extensibility/plugins/quickstart) — ゼロから共有プラグイン リポジトリを作るまで * [スキル](/ja/product-guides/skills) — プラグインに同梱される `SKILL.md` の手順 * [MCPサーバー](/ja/work-with-devin/mcp) — トランスポート、カスタム サーバー、サーバーごとのセットアップ