Headlesshost Mcp

Headlesshost MCP サーバー

Headlesshost プラットフォーム API と完全な通信を行う Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、AI アシスタントは Headlesshost プラットフォームを通じて、コンテンツサイト、ステージングサイト、ページ、セクション、オーディエンス、ユーザー、ファイルのアップロードを管理できます。

@modelcontextprotocol/sdk v1.26 を使用して構築されており、ツールのアノテーション、構造化ログ、Zod による入力検証が含まれています。

デモ

https://www.youtube.com/watch?v=xGGwcrI7gSo&feature=youtu.be

インストール

1. このリポジトリをクローンします

2. 依存関係をインストールします：

   npm install
   

3. サーバーをビルドします：

   npm run build
   

設定

サーバーには、HEADLESSHOST_API_KEY 環境変数で設定する Headlesshost API キーが必要です。

使用方法

Claude Desktop の場合

この設定を Claude Desktop の設定ファイルに追加します：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

ローカル開発

{
  "mcpServers": {
    "headlesshost-cms": {
      "command": "node",
      "args": ["/path/to/kapiti.mcp/build/index.js"],
      "env": {
        "HEADLESSHOST_API_KEY": "your-auth-token"
      }
    }
  }
}

npx 経由

{
  "mcpServers": {
    "headlesshost-cms": {
      "command": "npx",
      "args": ["headlesshost-mcp-server@latest"],
      "env": {
        "HEADLESSHOST_API_KEY": "your-auth-token"
      }
    }
  }
}

Claude Code の場合

.claude/settings.json に追加します：

{
  "mcpServers": {
    "headlesshost-cms": {
      "command": "node",
      "args": ["/path/to/kapiti.mcp/build/index.js"],
      "env": {
        "HEADLESSHOST_API_KEY": "your-auth-token"
      }
    }
  }
}

その他の MCP クライアントの場合

このサーバーは、VS Code、Zed Editor、Continue.dev、カスタム MCP 実装など、あらゆる MCP クライアントと互換性があります。

クライアントが以下を使用するように設定してください：

• コマンド：node
• 引数：["/path/to/kapiti.mcp/build/index.js"]
• 環境変数：HEADLESSHOST_API_KEY を設定します

ツール（53）

すべてのツールには、クライアントが適切な UI と確認プロンプトを表示できるよう、MCP アノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）が含まれています。

一般（3）

ツール	説明
ping	認証と接続をテストします
health	API のヘルスステータスを確認します
get_ref_data	システムの参照データと検索データを取得します

ユーザー管理（4）

ツール	説明
create_user	現在のアカウントに新しいユーザーを作成します
get_user	ID でユーザーの詳細を取得します
update_user	ユーザー情報とクレームを更新します
delete_user	システムからユーザーを削除します

アカウント管理（3）

ツール	説明
create_account	新しいユーザーアカウントを作成します
get_account	現在のアカウント情報を取得します
update_account	アカウント情報を更新します

ファイルのアップロード（3）

ツール	説明
upload_user_profile_image	ユーザーのプロフィール画像をアップロードします
upload_staging_site_file	ステージングサイトにファイルをアップロードします
upload_staging_site_image	ステージングサイトに画像をアップロードします

コンテンツサイト（5）

ツール	説明
create_content_site	新しいコンテンツサイトを作成します
get_content_sites	アカウント内のすべてのコンテンツサイトを取得します
get_content_site	ID でコンテンツサイトの詳細を取得します
update_content_site	コンテンツサイトの情報を更新します
delete_content_site	コンテンツサイトを削除します

ステージングサイト（9）

ツール	説明
update_staging_site	ステージングサイトの情報を更新する
delete_staging_site	ステージングサイトを削除する
publish_staging_site	ステージングサイトを公開してライブ状態にする
get_staging_site	ステージングサイトの詳細を取得する
get_staging_site_pages	ステージングサイトのページを取得する
get_staging_site_configuration	セクションタイプを含むステージングサイトの設定を取得する
get_staging_site_logs	前回の公開以降の変更ログを取得する
get_published_sites	コンテンツサイトの公開済みサイトを取得する
revert_staging_site	ステージングサイトを以前の状態に戻す
clone_staging_site	ステージングサイトを複製する

ページ（6）

ツール	説明
create_staging_site_page	新しいページを作成する
get_staging_site_page	ページの詳細を取得する（セクションは任意）
update_staging_site_page	ページを更新する
delete_staging_site_page	ページを削除する
revert_staging_site_page	ページを以前の状態に戻す
get_staging_site_page_logs	前回の公開以降のページ変更ログを取得する

セクション（7）

ツール	説明
create_staging_site_section	ページに新しいセクションを作成する
get_staging_site_section	セクションの詳細を取得する
update_staging_site_section	セクションを更新する
delete_staging_site_section	セクションを削除する
publish_staging_site_section	単一のセクションを公開する
revert_staging_site_section	セクションを以前の状態に戻す
get_staging_site_section_logs	前回の公開以降のセクション変更ログを取得する

サイトオーディエンス（4）

ツール	説明
create_staging_site_audience	サイトのオーディエンス（ロケール／セグメントの組み合わせ）を作成する
get_staging_site_audience	オーディエンスの詳細を取得する
update_staging_site_audience	オーディエンスを更新する
delete_staging_site_audience	オーディエンスを削除する（ベースオーディエンスは削除できません）

セクションオーディエンス（4）

ツール	説明
create_staging_site_section_audience	セクションのオーディエンス上書きを作成する
get_staging_site_section_audience	セクションオーディエンスの詳細を取得する
update_staging_site_section_audience	セクションのオーディエンス上書きを更新する
delete_staging_site_section_audience	セクションのオーディエンス上書きを削除する

アナリティクス（4）

ツール	説明
get_content_site_logs	直近15件のアクティビティログを取得します
get_content_site_hits	日別のヒット数アナリティクスを取得します
get_content_site_accounts	関連アカウントを取得します
get_content_site_claims	現在のユーザーのクレームを取得します

リソース

サーバーは、設定と監視のために2つのリソースを提供します。

• API 設定（config://api）— 利用可能なエンドポイントと現在の設定
• API ヘルスステータス（health://api）— リアルタイムの接続状況と応答時間

開発

サーバーをビルドします。

npm run build

開発モードで実行します。

npm run dev

変更を監視します。

npm run watch

デバッグ用に MCP インスペクターを実行します。

npm run inspector

エラー処理

サーバーには、構造化されたエラー処理が含まれています。

• API 認証の検証
• ネットワーク接続の確認
• MCP ロギング機能による構造化ログ（エラーはクライアントに送信されます）
• API タイムアウト時の適切なフォールバック

セキュリティ

• すべての操作で API キー認証が必要です
• 環境変数を安全に処理します
• すべてのツール入力を Zod スキーマで検証します
• ツールのアノテーションで、破壊的な操作をクライアントに通知します