Skip to main content

プラグインとは?

プラグインは、スキル — および任意でルール、フック、MCP サーバー、サブエージェント — をまとめたもので、ひとまとまりとしてインストールおよび再利用できます。ファイル形式とプラグインに含められるものについては、プラグイン リファレンス を参照してください。 プラグインは、cloud Devin セッションDevin CLIDevin Desktop に共通するカスタマイズ層です。一度インストールすれば、そのスキルは Devin を利用するあらゆる場所で /<plugin>:<skill> コマンドとして利用できるようになります。プラグインは次の 3 つのレベルでインストールできます。 このページでは、プラグインの Web アプリ側について説明します。Customize ページ、各スコープでのインストール、indexing、MCP、そしてそれらを支える管理対象のマニフェストを扱います。

Customize ページ

プラグインは Customize ページにあり、サイドバーの Customize 項目から開けます (従来の Settings → プラグイン、Settings → Marketplace、Settings → Connections → MCP サーバーの各ページを置き換えたもので、古いリンクはリダイレクトされます) 。次の 5 つのタブがあります。
  • プラグイン — インストール済みのすべての項目をスコープごとにまとめて表示します。さらに Browse marketplace から追加インストールできます。
  • Skills — インストール済みプラグインと自分のリポジトリから、Devin が必要に応じて読み込むスキル。
  • MCPs — 標準搭載のツールを超える機能を Devin に提供する MCP サーバー。下記の MCPs を参照してください。
  • Hooks — セッション中の特定のタイミングで自動的に実行されるコマンド。
  • Rules — Devin がすべてのセッションで従う恒久的なガイダンス。
スコープタブでは、自分のアクセス権に応じて Personal組織Enterprise を選択します。各スコープには、ガバナンス適用後に実際に有効となる内容が表示されます。リポジトリ単位の内容 (リポジトリの .devin/config.json で宣言されたスキル、ルール、プラグイン) を変更するには、そのリポジトリのファイルを編集してください。 誰が何を変更できるか:
  • Personal — 誰でも、自分のスコープについて変更できます。
  • 組織 — 組織設定へのアクセス権を持つメンバー。
  • Enterprise — Enterprise 設定へのアクセス権を持つメンバー。
プラグインをクリックすると詳細シートが開き、そのスキル、MCP、フック、ルール、サブエージェント、追跡中の ref または固定された SHA とパス、どのスコープにインストールされているか・何がそれを必要としているか、権限が表示されます。また、権限がある場合は、MCP の接続、必要とする内容の変更、アンインストール、 (アップロードしたプラグインの場合は) 削除といった操作を実行できます。

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

marketplace から

プラグインタブで Browse marketplace をクリックします。marketplace は、Devin 公式 marketplace (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 つのソースを利用できます。いずれも書き込み権限のある任意のスコープにインストールできます。 アップロードしたプラグインや作成したプラグインは、後から詳細シートで編集できます。削除するとファイルは完全に失われ、他に複製は残りません。プラグインファイルにシークレットを記載せず、代わりにシークレット参照を利用してください。

CLI から

devin plugins install <source> は、デフォルトでプラグインをパーソナルスコープに追加するため、クラウドセッションや他のデバイスにも引き継がれます。現在のマシンにのみインストールする場合は --local を指定してください。詳細はCLI コマンドを参照してください。

Devin に任せる

クラウドセッションでは、Devin に対して、何かを個人用のスキル、ルール、hook、MCP サーバーとして保存したり、plugin をインストールしたりするよう依頼できます。Devin は変更をカード形式で提案するので、承認または拒否してください。承認された変更は個人用のスコープに反映され、以降のセッションに適用されます。

プラグインがセッションに届くしくみ (クラウド ↔ ローカルの同期)

すべてのスコープは、Devin Cloud に保存された 管理対象のマニフェスト に支えられています (The manifest を参照) 。どこからインストールしてもその manifest に書き込まれ、すべての対象がそれを読み取ります。
  • クラウドセッションは開始時に enterprise、組織、個人の manifest を取得し、そこから得られたプラグインを、クローンするリポジトリが宣言したプラグインとあわせてセッションのマシンにインストールします。
  • Devin CLIDevin Desktop は、サインインしていれば同じ manifest を取得します。そのため、Web でインストールしたプラグインはお使いのノートパソコンにも表示され、ノートパソコンで実行した devin plugins install の結果は次のクラウドセッションに反映されます。非公開リポジトリのプラグインはローカルの git 認証情報で取得されるため、ご自身にそのリポジトリへのアクセス権が必要です。enterprise では CLI プラグインを完全に無効化することもできます (enterprise settings の Devin CLI plugins) 。
  • 個人利用のユーザー (組織なし) は個人スコープのみを利用できます。
実行中のセッションは開始時に読み込んだ内容を保持し、変更は次のセッションから適用されます。 プラグインのインストールと MCP の認証は別の手順です。クラウドの MCP は Customize → MCPs から接続してください。CLI で動作するプラグインの OAuth サーバーには devin mcp login を利用します。プラグインを同期しても、すべてのデバイスが同じ認証情報を共有するわけではありません。

インデックス

Devin は各スコープのプラグインのインデックスを保持します。各プラグインのソースをクローンし、マニフェストと内容を読み取り、依存関係を解決し、ガバナンスを適用します。Customize ページにはインデックスの結果 (プラグイン、そのスキル、MCP、フック、ルール、およびポリシーによってブロックされたもの) が表示され、ステータス行には各スコープが最後にインデックスされた時刻が示されます。
  • 実行のきっかけ — プラグインのインストール、削除、編集を行うと、再インデックスが自動的にキューに入ります。プラグインのソースリポジトリに変更をプッシュした後にインデックスを更新するには、プラグイン設定 → Reindex plugins を利用してください。
  • 実行中の状態 — 実行の状態は scheduled、queued、starting、indexing のいずれかです。再インデックスが頻繁な場合は間隔が空けられ、アップロードしたバンドルの保存はキューに入るまで少し時間がかかることがあります。プラグイン MCP は、その設定がインデックスされた後に接続できます。
  • 結果プラグイン設定 (歯車メニュー) を開くと、最後にインデックスされた時刻と発生した問題を確認できます。更新に失敗した場合、直前に成功した結果が表示されたままになることがあります。プラグインが一覧に表示されていても、最新の更新が成功したとは限りません。
  • リポジトリへのアクセス — リポジトリからインデックスされたプラグインの内容は、Git 統合を通じて当該リポジトリへのアクセス権を持つ組織にのみ表示されます。アクセス権がない場合、そのスコープの内容は Plugin repos unauthorized という通知とともに保留されます。Settings → Repositories でリポジトリへのアクセスを許可してください。なお、保留されたスコープのガバナンス (その禁止設定) は引き続き適用されます。
  • ネットワークポリシー — インデックスは、組織のセッションネットワークポリシーを継承したマシン上で実行されるため、プラグインのソースはそのポリシー下で到達可能である必要があります。
セッション自体はインデックスを待ちません。開始時にプラグインを直接取得してインストールします。

インデックスの問題を解決する

  1. プラグインが必要な組織で Customize → Plugins を開きます。Personal組織Enterprise のいずれかのスコープを選択し、プラグイン設定 を開いて、問題の内容と、そこに示されているプラグインまたはスコープを確認します。
  2. 実行が scheduled、queued、starting、indexing のいずれかの状態であれば、完了するまで待ちます。プラグインが一度もインデックスされていない場合や、前回のインデックス以降にソースが変更された場合は、Reindex plugins を選択します。
  3. 実行が failed の場合やコンテンツが見つからない場合は、以下の該当する対処法を利用します。修正を保存またはコミットしたうえで Reindex plugins を選択し、結果を再度確認します。共有マニフェストやリポジトリ権限の変更には、管理者の対応が必要になる場合があります。
インデックスが成功したら、プラグインの詳細を開き、想定どおりのスキル、ルール、フック、MCP が表示されていることを確認します。MCP に認可が必要な場合は、接続 を完了してください。変更後のプラグインの内容を利用するには、新しいセッションを開始します。CLI のインストールが古い場合は devin plugins update を利用してください。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 サーバー を参照してください。

マニフェスト

各スコープの背後には管理対象のマニフェスト (3つのリストを含むJSONドキュメント) があります。Customize UIがこれを代わりに編集しますが、プラグイン タブの プラグイン設定 (歯車) → マニフェストを編集 から直接操作することもできます。
  • requiredPlugins — スコープ内の全員にインストールされます (再帰的に、依存しているプラグインも含みます) 。UIからインストールすると、ここに項目が追加されます。
  • optionalPlugins — プラグインを自動インストールせずに許可する許可リストです。禁止された項目に対する例外を設けるために利用されます。
  • forbiddenPlugins — プラグインの識別子またはグロブパターンの拒否リストです。
マニフェストはそのまま保存され、エージェントはインストール時に完全なソースを検証します。各項目で指定できるソース形式と、完全な依存関係およびガバナンスのセマンティクスについては、プラグイン リファレンスを参照してください。

ガバナンス

3 つのリストは、Enterprise、組織、リポジトリ (.devin/config.json) 、個人というすべてのレベルで共通のポリシー記述手段であり、上位レベルの設定が優先されます。つまり Enterprise は、どの組織・リポジトリ・ユーザーも削除できないプラグインを必須にしたり、下位のどのレベルからも復活させられないプラグインを禁止したりできます。ポリシーによってブロックされたプラグインは、プラグイン タブの Installed but blocked に表示され、そのスキルはセッション開始時にスキップされ、禁止元を示す警告が表示されます。 Enterprise を承認済みのセットに限定するには、"*" を禁止したうえで、承認済みのプラグイン (およびその dependencies) を requiredPlugins/optionalPlugins に列挙します。具体的な設定例は プラグイン エコシステムを設定する を、ルールの詳細は 継承とレベル を参照してください。

スコープと継承

  • スタンドアロンアカウントには、アカウントマニフェスト (Customize では Organization と表示) と、各メンバーの個人マニフェストがあります。
  • Enterprise の場合は、すべての子組織に継承される enterprise マニフェストがあり、その下に組織単位のマニフェスト、さらにその下に個人マニフェストが重なります。

更新の反映タイミング

  • マニフェストの変更 (インストール、削除、マニフェストの編集) は、すべての対象で次回のセッションから適用されます。
  • プラグインの内容の変更 — プラグインが追跡しているブランチにマージされた変更は、新しいセッションへ自動的に反映されます (クラウドセッションでは開始時に取得され、CLI では devin plugins update の実行時に更新されます)。Customize では次回のインデックス実行後に新しい内容が表示されます。すぐに反映したい場合は Reindex plugins をクリックしてください。
  • 実行中のセッションでは、開始時に読み込まれた内容がそのまま維持されます。更新によって進行中のセッションが途中で変更されることはありません。

プラグインの固定

"owner/repo" の形式 (または ref 付き) で記述されたプラグインはブランチやタグを追従するため、同じマニフェストでも時間の経過とともに異なる内容に解決されることがあります。Customize では、こうした項目が Plugin source not pinned と表示されます。プラグインを特定の内容に固定するには、sha を指定したオブジェクト形式を利用してください:
固定したプラグインは、SHA を編集するまで一切変更されません。ref (ブランチまたはタグ) と sha は排他的で、1 つの項目に両方を指定することはできません。これらのフィールドは、url および git-subdirソース形式でも同様に機能します。アップロードしたプラグインは、常にアップロードした内容に固定されます。2 つのスコープが同じプラグインを異なる SHA に固定している場合、インデックスは固定の競合を報告します。

プラグインの環境変数

クラウドセッションでコマンドフックを設定するには、requiredPlugins または optionalPlugins の項目に env を追加します。認証情報には Devin Secrets を参照し、その他の値にはリテラル文字列を使用できます。
変更を適用するには、新しいクラウドセッションを開始してください。依存関係ごとに、マニフェスト内の項目とenvが必要です。

サポートされている参照

シークレットはセッションから利用できる必要があります。既存のキーと値のシークレットの場合は、/ENTRY を追加します。例:secret:org:AWS_CREDS/ACCESS_KEY_ID プラグインの MCP 設定では、シークレットを ${NAME} として参照します。メンバーはサーバーの詳細シートから値を指定し、設定に直接書き込まれたリテラル値は削除されます。

詳細情報