Pane について
URL を介して人間にリッチなインタラクティブ UI を渡し、任意の MCP クライアントから構造化データを受け取ります。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
mcp.json · 共通設定
起動コマンド
npx -y @paneui/mcp設定が必要な環境変数
PANE_API_KEYシークレットPane agent API key. If unset, the server auto-registers a fresh agent against the relay on first use and saves the key to the shared CLI store (~/.config/pane/config.json).PANE_URLPane relay base URL. Defaults to the hosted relay https://relay.paneui.com; set this to point at a self-hosted relay.PANE_AGENT_NAMEDisplay name for the auto-registered agent on the relay.PANE_REGISTER_SECRETシークレットRegistration secret, required only for relays running REGISTRATION_MODE=secret.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
26掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| html | string | いいえ | ペインの UI を完全なインライン HTML ドキュメントとして指定します。データをあなたに返すには、ページが window.pane.emit(eventType, payload) を呼び出します。送信するすべての eventType は event_schema で宣言し、emittedBy に 'page' を含める必要があります。初期データは window.pane.inputData から読み取ります。`html`(+`name`)を渡して使い捨ての UI を作成するか、`template_id` を渡して保存済みテンプレートを再利用してください。両方は指定できません。 |
| name | string | いいえ | 自動作成されるテンプレートの、人が読める短いラベル(例:'Deploy approval')。`html`(インライン形式)を渡す場合は必須です。`template_id` で既存のテンプレートを再利用する場合は省略してください(テンプレート名を引き継ぎます)。 |
| tags | array | いいえ | ペインごとの任意のフィルタータグ(テンプレートのタグと統合)。タグは最大 20 個、各 50 文字までです。'favorite'/'favorites' は予約語です。 |
| title | string | いいえ | 人向けの任意のブラウザータブタイトル(≤80 文字)。デフォルトは `name` です。 |
| callback | object | いいえ | 任意の webhook コールバック設定です。リレーが新しいイベントをエンドポイントに POST します。形式はリレーのコールバックスキーマに従います(例:{ url, secret? })。ほとんどの MCP エージェントは代わりに get_events でポーリングします。 |
| metadata | object | いいえ | ペインに付加して独自の記録に使える任意の不透明な JSON(人間には表示されず、run_query から照会可能)。 |
| preamble | string | いいえ | UI の上部に表示する任意の 1〜2 行のコンテキスト——「誰が何のために依頼しているか」。 |
| icon_emoji | string | いいえ | このペインのアイコンを上書きする任意の単一絵文字アイコン。 |
| input_data | object | いいえ | このペインインスタンスの任意の初期データ。ページ内で window.pane.inputData として読み取れます(例:レビュー対象の差分、選択肢)。 |
| context_key | string | いいえ | 任意の自然キー(例:'pr-42')。同じ (template, key) で create_pane を繰り返し呼び出すと、同じペインが返されるため、再試行は冪等になります。 |
| template_id | string | いいえ | インライン HTML の代わりに、既存の名前付きテンプレート(id または slug)を再利用します。テンプレートの固定バージョンから HTML と event/input/record schemas が提供されます。`html`/`name`/`event_schema`/`input_schema` とは併用できません。テンプレートの作成には `template` ツールを使用してください。 |
| ttl_seconds | integer | いいえ | ペインの存続時間(秒)。中継が最大値以内に制限します。返される expires_at が確定値です。 |
| event_schema | object | いいえ | インラインフォームのみ。ページ(およびあなた)が発行できるイベントを宣言し、各ペイロードを検証します。形式:{ events: { '<type>': { emittedBy: ['page'|'agent'...], payload: <JSON Schema> } } }。読み取り専用ペインでは省略してください。 |
| input_schema | object | いいえ | インラインフォームのみ。input_data を検証する任意の JSON Schema。input_data がページによるダウンロードを必要とするアップロード済み添付ファイル ID を参照する場合は必須です。 |
| participants | integer | いいえ | 発行する、人間の参加者ごとに異なる URL の数(任意、デフォルトは 1)。各参加者には、返される `urls` 配列内の専用 URL が割り当てられます。 |
| record_schema | object | いいえ | インラインフォームのみ。このペインの変更可能なレコードコレクション(TODO、コメントなど)を宣言する `x-pane-collections` 拡張を含む JSON Schema 2020-12 ドキュメント。イベント専用ペインでは省略してください。 |
| template_version | integer | いいえ | `template_id` と併用:このペインで特定のテンプレートバージョンを固定します。デフォルトではテンプレート head の最新バージョンが使用されます。 |
| icon_attachment_id | string | いいえ | 任意のペインごとのアイコン。用意済みのラスター画像添付ファイル ID(png/jpeg/webp/gif)を指定します。先に `attachments` ツールでアップロードしてください(スコープ:pane または agent)。 |
詳細
メンテナーはまだ詳細を追加していません。リポジトリの README をご覧ください。
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。