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

管理画面からインストールするための準備

レジストリからのインストールには、次のものが必要です。

• plugins:manage 権限を持つ管理者のアカウント
• ダウンロードしたプラグインのバンドルのための、設定済みのストレージ
• 使用できるサンドボックスランナー

Cloudflare Workersでは、@emdash-cms/cloudflare の sandbox() を使います。

import { sandbox } from "@emdash-cms/cloudflare";
import { defineConfig } from "astro/config";
import emdash from "emdash/astro";

export default defineConfig({
	integrations: [
		emdash({
			sandboxRunner: sandbox(),
		}),
	],
});

Cloudflareのランナーは、Worker Loaderを使って、プラグインごとに別のWorkerを作成します。Workersの有料プラン（Workers Paid）と、LOADER という名前の worker_loaders バインディングが必要です。サンドボックス型プラグインは、PluginBridge を通してコンテンツ、メディア、ストレージ、ネットワーク、メールのAPIにアクセスするため、サイトのWorkerのエントリーポイントでこのクラスをエクスポートする必要があります。

*-cloudflare のテンプレートは PluginBridge をエクスポートしていますが、Worker Loaderのバインディングはコメントアウトしてあります。そのため、新しいプロジェクトはWorkersの無料プランでデプロイできます。サンドボックス型プラグインは、雛形を作るときに有効にするか、あとからCloudflareのサンドボックスの設定に従ってバインディングを追加します。sandbox() ヘルパーは、ビルド時に実際に適用されるWranglerの設定を読み取ります。LOADER がない場合、レジストリの閲覧はできますが、設定ファイルで管理するサンドボックス型プラグインは読み込まれず、インストールや更新のリクエストは SANDBOX_NOT_AVAILABLE を返します。

Node.jsでは、ランナーと、そのピア依存の workerd をインストールします。

npm install @emdash-cms/sandbox-workerd workerd

workerd のプロセスが、Node.jsのサーバーとは別にプラグインのコードを実行します。EmDashのインテグレーションでランナーを指定します。

import { defineConfig } from "astro/config";
import emdash from "emdash/astro";

export default defineConfig({
	integrations: [
		emdash({
			sandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",
		}),
	],
});

両方のプラットフォームでの、開発環境の設定、実行環境の要件、リソースの制限、ランナーが使えない場合のエラーについては、プラグインサンドボックスを参照してください。

レジストリからのインストール

EmDashは、公開者の現在の署名付きレコードを検証し、ダウンロードしたバンドルを確認してから、サンドボックスランナーを通して読み込みます。プラグインは「プラグイン」に表示され、そこで無効にしたり設定したりできます。検証と信頼のモデルの全体は、プラグインレジストリを参照してください。

権限の確認

同意のダイアログには、プラグインが宣言したすべての権限が表示されます。よく使われる権限には次のものがあります。

プラグインがModel Context Protocol（MCP）のツールとして公開するルートを宣言している場合は、ダイアログにそれも表示されます。権限のモデルの全体は、権限（Capabilities）とセキュリティを参照してください。

プラグインの更新

レジストリからの更新で、権限やMCPのツールが追加される場合や、ルートが認証済みから公開に変わる場合は、もう一度確認が必要です。変更を承認するまで、EmDashはインストール済みのバージョンをそのまま使います。

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

EmDashは、インストールされたバンドルを削除し、プラグインの読み込みを止めます。既定では、プラグインが保存したデータは残ります。

npmからのインストール

ネイティブ型プラグインと、設定ファイルで管理するサンドボックス型プラグインは、npmの依存パッケージとしてインストールします。plugins: [] と sandboxed: [] のどちらを使うかは、パッケージの説明に従います。

次の例は、ネイティブ型のField Kitプラグインを登録します。

import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import { fieldKitPlugin } from "@emdash-cms/plugin-field-kit";

export default defineConfig({
	integrations: [
		emdash({
			plugins: [fieldKitPlugin()],
		}),
	],
});

設定ファイルで管理するプラグインは、npmの依存パッケージを更新してサイトをデプロイしたときに変わります。管理画面からインストールしたり削除したりはできません。

インストール方法の選び方

Reactの管理画面のコンポーネント、Portable Textの描画コンポーネント、ページフラグメント、サイトのプロセスへの直接のアクセスのいずれかが必要な場合は、ネイティブ型プラグインを使います。宣言したプラグインAPIで動かせる場合は、サンドボックス型プラグインを使います。