Shilpi for WordPress

Shilpi MCP サーバー

Claude、ChatGPT、または MCP 対応エージェントを、Shilpi テーマを実行している WordPress サイトに接続し、サーバーへのアクセスではなく、範囲を限定した権限を通じてサイトを構築・編集できます。

このリポジトリには、レジストリマニフェスト、ツール一覧、認証ガイド、クライアント設定例という公開インターフェースが含まれています。サーバー自体は Shilpi テーマに組み込まれており、ご自身の WordPress インストール上で動作するため、登録が必要なサービスはなく、エージェントとサイトの間に第三者が介在することもありません。

• 製品と価格：https://shilpibuilder.com/
• ドキュメント：https://shilpibuilder.com/docs/
• 権限モデルの解説：https://shilpibuilder.com/abilities-not-access/

これが必要な理由

ほとんどの WordPress ページビルダーは、独自形式でレイアウトを保存します。そのようなページの編集をエージェントに依頼するには、独自のウィジェットツリーを学習させ、不変条件を推測させ、ベンダーが仕様を変更しないことを期待しなければなりません。

Shilpi は、ページを 3 つのプレーンなフィールドとして保存します。本文の HTML、実際のスタイルシート、そして用途を絞った JavaScript です。Shilpi のページを編集するエージェントは、すでに理解しているマークアップを編集します。サイトに必要なのは生のアクセス権ではなく、どのグローバルクラスが存在するのか、どのデザイン変数が定義されているのか、サイト固有のルールは何かという語彙情報です。これらのツールが、その情報を提供します。

エンドポイント

サーバーはご自身のサイト上で動作します。example.com をご自身のドメインに置き換えてください。

目的	URL
Streamable HTTP、OAuth	https://example.com/wp-json/mcp/shilpi-oauth
Streamable HTTP、アプリケーションパスワード	https://example.com/wp-json/shilpi/v1/mcp
OAuth 保護リソースのメタデータ	https://example.com/wp-json/shilpi/v1/oauth/protected-resource
エージェント向けサイト概要	https://example.com/llms.txt

どちらのエンドポイントも有効なライセンスが必要です。ライセンスがない場合は 404 を返し、どの認証情報でも認証されません。Shilpi → Dashboard → Connect an AI agent でサーバーをオフにすると、両方のエンドポイントが削除されます。これは単なる設定ではなく、実効性のある停止スイッチです。

要件

• WordPress 6.4 以降
• PHP 8.0 以降
• HTTPS（OAuth に必須）
• Shilpi テーマが有効で、ライセンスが有効であること

接続方法

OAuth フローとアプリケーションパスワードによる代替手段については、docs/authentication.md を参照してください。すぐに貼り付けて使えるクライアント設定は、examples/ をご覧ください。

権限

すべてのツールには利用範囲が設定されています。ファイルシステムへのアクセス、SSH、wp-config.php やテーマ・プラグインファイルへのアクセス手段はありません。PHP スニペットの書き込みは、サイト所有者が Shilpi → Security で許可し、ワンクリックで取り消せる一時的な権限です。

以下の一覧は、Shilpi 1.9.4 を実行する実環境から生成されています。数はリリースごとに変わり、WooCommerce Kit プラグインが有効な場合は、独自のツールが追加されます。

ページ、投稿、テンプレート

ツール	機能
shilpi-site-info	サイトの識別情報、バージョン、コンテンツ一覧、ブレークポイント、制限、テンプレートのルーティング
shilpi-list-pages	ID、スラッグ、パーマリンク付きでページ、投稿、テンプレートを一覧表示
shilpi-get-page	ドキュメントを 1 件読み込み：本文 HTML、ページ CSS、ページ JS、ヘッダー、フッター
shilpi-save-page	ページ、投稿、テンプレートを作成または更新（スラッグによる冪等処理）
shilpi-set-page-code	ドキュメントのページ CSS と JavaScript を設定
shilpi-delete-page	ドキュメントを削除
shilpi-import-page	静的 HTML ファイル 1 件を Shilpi ドキュメントとしてインポート
shilpi-import-site	静的 HTML フォルダーをインポート：テンプレート、CSS、画像、メニュー

デザインシステム

ツール	内容
shilpi-manage-variables	デザイン トークンを一覧表示および登録・更新します。ブレークポイントごとの値にも対応しています
shilpi-manage-classes	グローバル CSS クラスとその状態を一覧表示および管理します
shilpi-get-globals	グローバル CSS と JS、およびデフォルトのヘッダー、フッター、フロントページを読み取ります
shilpi-set-globals	これらのグローバル設定を書き込みます

構造とコンテンツ

ツール	内容
shilpi-manage-menu	ナビゲーションメニューを作成・並べ替えし、表示位置に割り当てます
shilpi-manage-taxonomy	カテゴリー、タグ、カスタムタクソノミーを管理します
shilpi-get-seo	タイトル、説明、canonical、robots、ソーシャルフィールドを読み取ります
shilpi-set-seo	サイトで稼働している SEO プラグインを通じて、それらを書き込みます
shilpi-upload-media	画像をメディアライブラリにサイドロードします。ソース URL に基づく冪等性を備えています
shilpi-search-icons	インストール済みのアイコンライブラリを検索します
shilpi-manage-icon-libraries	アイコンライブラリを追加・削除します

コードとアセット

ツール	内容
shilpi-list-php-snippets	Code Hub のスニペットを、有効状態とエラー状態とともに一覧表示します
shilpi-get-php-snippet	1 つのスニペットとそのコンテンツハッシュを読み取ります
shilpi-save-php-snippet	構文チェックとハッシュによる保護を行い、スニペットを作成または更新します
shilpi-configure-php-snippet	スニペットを有効化または無効化します。有効化の前にテスト実行します
shilpi-delete-php-snippet	スニペットを削除します
shilpi-list-script-files	管理対象の JavaScript ファイルを一覧表示します
shilpi-upload-script-file	信頼できるライブラリまたはバンドルをアップロードします
shilpi-configure-script-file	有効状態、読み込み優先度、jQuery 依存関係を設定します
shilpi-list-project-files	プロジェクトの JSON ファイルとアセットファイルを一覧表示します
shilpi-upload-project-file	生成された JSON をアップロードし、同一オリジンの URL を返します
shilpi-delete-project-file	プロジェクトファイルまたはスクリプトファイルを削除します
shilpi-set-site-manifest	ウェブアプリマニフェストを有効化します
shilpi-list-fonts	セルフホストされたフォントフェイスを一覧表示します
shilpi-upload-font	WOFF2、WOFF、TTF、または OTF のフォントフェイスをアップロードして登録します
shilpi-delete-font	フォントフェイスを削除します

エージェント向けの指示

ツール	内容
shilpi-get-skill	Markdown スキル（shilpi-theme または wordpress-core）を読み込みます

スキルを使って、サイト独自の規約をエージェントに伝えます。独自の Markdown スキルをアップロードしてサイト独自のルールを追加すると、エージェントは書き込みの前にそれを読み込みます。

サーバーでできないこと

何かに接続する前に、ぜひ読んでおきたい項目です。

• ファイルシステムにはアクセスできません。テーマファイルやプラグインファイルの読み書きはできません。
• シェル、SSH、wp-config.php は使用できません。
• WooCommerce ツールを通じた顧客、注文、住所、決済データへのアクセスはできません。
• PHP の書き込みはデフォルトで無効です。これはオフにできる権限であり、一度有効にしたら忘れてよい設定ではありません。
• JavaScript のアップロードには、unfiltered_html を持つアカウントが必要です。

ライセンス

このリポジトリの内容（マニフェスト、ドキュメント、サンプル）は、MIT ライセンスの下で公開されています。Shilpi テーマ自体は商用ソフトウェアです。https://shilpibuilder.com/pricing/ をご覧ください。