Garchi CMS MCP

AI エージェント向け Garchi CMS

AI エージェント、公式スターターキット、本番環境向け MCP 統合を活用して、Garchi CMS で構造化されたウェブサイトやアプリケーションを構築、管理できます。

---

お好みのフレームワークと AI コーディングエージェントで開発しながら、Garchi が構造化コンテンツのバックエンドを提供します。アプリケーションを一度作成すれば、その後は通常、アプリケーションコードを変更せずにビジネス側でコンテンツを管理し続けられます。

Garchi CMS とは

Garchi CMS は、LumenHarbor Digital Solutions Limited が提供するホステッド型ヘッドレス CMS です。コンテンツは次のように整理されます。

• スペース — その下にあるすべてのものを所有する作業領域です。
• ページ — セクションの順序付きリストで、各セクションはセクションテンプレートのインスタンスです。テンプレートはプロパティを定義し、コードベース内のコンポーネントのプロパティに対応付けます。
• データ項目 — カテゴリーとキー／値形式のメタデータを持つ、項目化されたコンテンツ（ブログ投稿、商品、イベント）です。
• アセット — ページセクションで使用するアップロード済みファイルです。

アプリは REST API または Node/PHP SDK を通じてこれらを取得し、描画します。Garchi はフレームワーク、データベース、ホスティングの代わりになるものではありません。

このリポジトリで提供されるもの

インストール可能な統合機能は、3 つの要素で構成されています。

MCP — ホステッド型 Garchi MCP サーバー https://garchi.co.uk/mcp-oauth。エージェントはこれを使って、スペースの一覧表示、ページやセクションの作成・編集、データ項目、カテゴリー、メタデータ、アセットの管理など、稼働中の CMS を読み書きします。

スキル — エージェントが Garchi を正しく使用するための手順です。

スキル	役割
garchi-build-site	オーケストレーション：目標を理解し、プロジェクトを調査して、スターターキットと統合のどちらを選ぶか決定し、MCP に接続してコンテンツをモデル化し、コードを変更せずにコンテンツを編集できることを確認します。
garchi-render-content	アプリケーションコード：サーバーサイドクライアント、ページおよびセクションのレンダラー、ネストされたセクション、データ項目、メタデータ、アセット、プレビューモードです。
garchi-manage-content	MCP 経由のコンテンツ操作：ページ、セクション、テンプレート、項目、カテゴリー、アセットと、破壊的な操作を安全に扱う方法です。

スターターキット — Next.js、Nuxt、Laravel 向けの公式プロジェクトひな形です。skills/garchi-build-site/references/starter-kits.md から参照されます（コピーはされません）。

このリポジトリはエージェントプラグイン（plugin.json + skills/ + mcp.json）としてパッケージ化されており、独自のマニフェスト形式を使用するクライアント向けの薄いアダプターも含まれます。スキルは一か所にまとめられているため、スキルを更新すると、対応するすべてのエージェントに変更が反映されます。

対応するエージェント環境

Cursor

Cursor はエージェントプラグインをネイティブに読み込みます。プラグインがマーケットプレイスで審査中の間は、ローカルにインストールしてください。

git clone https://github.com/lumenharbor/garchi-cms-skills.git ~/.cursor/plugins/local/garchi-cms

サイドバーの カスタマイズ を開き、Garchi CMS を見つけて、プロンプトが表示されたら garchi MCP サーバーで認証してください。

Claude Code

このリポジトリをプラグインマーケットプレイスとして追加し、インストールします。

/plugin marketplace add lumenharbor/garchi-cms-skills

/plugin install garchi-cms@garchi-cms

プロンプトが表示されたら、/mcp を使って garchi MCP サーバーを認証してください。

Codex と ChatGPT デスクトップアプリ

このリポジトリをプラグインマーケットプレイスのソースとして追加します。

codex plugin marketplace add lumenharbor/garchi-cms-skills

次に、ChatGPT デスクトップアプリのプラグインディレクトリから Garchi CMS をインストールし、アプリを再起動してください。

バンドルされた MCP サーバーが接続できない場合は、Codex に直接追加してログインしてください。

codex mcp login garchi

それでも接続できない場合は、~/.codex/config.toml でサーバーを手動で追加してください。

[mcp_servers.garchi]
url = "https://garchi.co.uk/mcp-oauth"

ChatGPT

Garchi CMS は、ChatGPT の MCP コネクターとして登録されています： chatgpt.com/plugins/plugin_asdk_app_698da77dd2f48191ba19e15b0b188796。 ChatGPT で Garchi のツールを使うには、そこで有効にしてください。プラグインの .app.json は、Codex と ChatGPT デスクトップアプリの接続先として同じ登録済みコネクターを指定しているため、 ローカルインストール時にサーバーが重複して登録されることはなく、そのコネクターが再利用されます。

Agent Plugins 互換クライアント

Agent Plugins v1 仕様を実装するクライアント（VS Code など）は、 ルートの plugin.json、skills/ ディレクトリ、mcp.json を直接読み込みます。 クライアントの参照先にこのリポジトリを指定してください。

プラグインホストを使わずにスキルをインストールする

skills CLI がサポートする任意のエージェントにスキルのみをインストールするには：

npx [email protected] add lumenharbor/garchi-cms-skills

MCP サーバーは別途設定してください。クライアントごとの手順（OAuth 非対応クライアント向けのベアラートークンエンドポイントを含む）については、 garchi.co.uk/mcp-docs を参照してください。

プロンプトの例

インストール後は、MCP サーバー、スキル、SDK の名前を指定しなくても、次のように指示できます：

• 「Garchi CMS を使って SaaS のマーケティングサイトを構築してください。」
• 「この既存の Next.js プロジェクトで Garchi を CMS として使ってください。」
• 「このプロジェクトを自分の Garchi スペースに接続してください。」
• 「Garchi で About ページと Pricing ページを作成してください。」
• 「このフロントエンドで自分の Garchi ページをレンダリングしてください。」
• 「Garchi のデータアイテムを使って、このサイトにブログを追加してください。」
• 「アプリケーションコードを変更せずに、Garchi の価格設定の文言を変更してください。」
• 「このプロジェクトを始めるために、公式の Garchi スターターキットを使ってください。」

スターターキット

フレームワーク	リポジトリ	SDK
Next.js	garchi-next-starter-kit	@garchicms/garchi-node-sdk
Nuxt	garchi-nuxt-starter-kit	@garchicms/garchi-node-sdk
Laravel	garchi-laravel-starter-kit	garchicms/garchi-sdk-php

次のコマンドで、いずれかのキットを使い始められます：

npx @lumenharbor/[email protected] -k next

-k には next、nuxt、laravel を指定できます。

その他のフレームワーク（SvelteKit、Astro、Django、Rails、React Native など）は、 Node SDK、PHP SDK、または REST API を通じて連携できます。これら向けのスキャフォールドはありませんが、 Garchi は同様に利用できます。

セキュリティ

• 認証はリモートで行われ、OAuth ベースです。 バンドルされている MCP サーバーは https://garchi.co.uk/mcp-oauth です。PKCE（S256）と動的クライアント登録を備えた OAuth 2.1 保護リソースメタデータ（RFC 9728）を公開するため、 対応クライアントは認可フローを自ら実行し、トークンを保存します。
• このリポジトリには認証情報は保存されません。 API キー、トークン、シークレットは マニフェスト、スキル、参照ファイルのいずれにも含まれておらず、プラグインのインストールにも必要ありません。 mcp.json と .mcp.json のエントリに含まれるのは URL だけです。
• アクセス権は Garchi の権限設定に従います。 MCP サーバーは、サインイン中のユーザーとして動作します。 プラグインによって、そのアカウントがすでに持つ権限を超えるアクセスが許可されることはありません。
• 破壊的な操作には確認が必要です。 delete-section-tool と update-prop-template-tool の 2 つのツールは破壊的な操作として指定されており、 garchi-manage-content では、いずれかを実行する前に アイテムごとの明示的な確認が必要です。これは、クライアント独自のツール承認プロンプトに加えて求められます。
• アプリケーションの認証情報はサーバー側に保持されます。 アプリがコンテンツの読み取りに使う GARCHI_API_KEY は MCP とは別のもので、ブラウザーには公開されません。また、このリポジトリではなく、 ご自身の環境設定に記述してください。

ドキュメント

• Garchi CMS のドキュメント
• REST API · OpenAPI 仕様
• MCP クライアントのセットアップ

エージェントは誤った回答をすることがあります。スキルに記載されたとおりに動作しない場合は、ドキュメントを確認してください。

ライセンス

MIT — LICENSE を参照してください。