Kuroco Skills の使い方
Kuroco Skills は、Claude Code 向けのスキルパッケージです。 Kuroco の API 連携、コンテンツ管理、フロントエンド統合、バッチ処理などに関するベストプラクティスを Claude Code に学習させ、Kuroco 開発の生産性を向上させます。
Kuroco AI アーキテクチャ
Kuroco は AI 連携のために以下のインターフェースを提供しています。
| コンポーネント | 種類 | 説明 |
|---|---|---|
| 管理画面 | Web UI | 管理者向けの Kuroco 管理画面 |
| Admin API | REST API | API 経由の管理操作（/direct/rcms_api/admin_api/） |
| Admin MCP | MCP サーバ | Admin API の MCP サーバ（/direct/rcms_api/admin_mcp/）、Bearer トークン認証 |
| Client API | REST API | フロントエンドアプリ向けの公開 API（/rcms-api/{id}/） |
| Client API | MCP サーバ | Client API の MCP サーバ (/rcms-api/{id}/mcp) |
| Client CLI | CLI ツール | Client API のラッパー CLI（kuroco-client） |
AI エージェントから管理操作を行う場合は、Admin MCP を使用してください。MCP 対応クライアント（Claude Code、Claude Desktop など）に直接登録でき、OAuth によるスコープ／読み取り専用のアクセス制御を利用できます。
Client CLI は、独立して使用可能なスタンドアロンのコマンドラインツールです。
Kuroco Skills とは
Kuroco Skills をインストールすると、Claude Code が Kuroco に関する質問に対して、正確で具体的なコード例やベストプラクティスを提示できるようになります。 以下の 9 つのスキルが含まれています。
| スキル | 説明 |
|---|---|
| kuroco-docs | Kuroco 公式ドキュメントの検索・参照 |
| kuroco-app-builder | アプリ・サイトをゼロから構築するワークフロー（モックファースト → コンテンツ定義 → API → 実データ接続 → デプロイ） |
| kuroco-api-content | API 設計・認証（Cookie / 動的・静的アクセストークン）、CORS、コンテンツ CRUD、フィルタークエリ |
| kuroco-frontend-integration | Vite / Nuxt.js / Next.js 統合、SPA/SSG/SSR、認証実装、KurocoFront へのデプロイ |
| kuroco-server-processing | Smarty プラグイン・構文リファレンス（206 プラグイン）、バッチ処理、Webhook、トリガー |
| kuroco-admin-mcp | Admin MCP（管理 MCP サーバ）への接続設定、OAuth / CIMD 認証、スコープ、ツール利用 |
| kuroco-content-structure-creation | MCP ツールによるコンテンツ定義（TopicsGroup）の作成、フィールドタイプリファレンス |
| kuroco-api-performance-review | API パフォーマンス・利用料の調査（API 解析、キャッシュ設定レビュー、改善提案） |
| kuroco-security-audit | セキュリティ設定の読み取り専用診断（API セキュリティ、CORS、IP 制限、権限、トークン） |
各スキルの詳細は「Kuroco Skills リファレンス」を参照してください。
事前準備: Claude Code のインストール
Kuroco Skills を使用するには Claude Code が必要です。
Claude Code はデスクトップ版（CLI）でのみ動作確認を行っています。Web 版（claude.ai）での動作は未検証です。
macOS の場合
ネイティブインストーラー（推奨）または Homebrew でインストールします。
# ネイティブインストーラー（推奨、自動更新あり）
curl -fsSL https://claude.ai/install.sh | bash
# または Homebrew
brew install --cask claude-code
インストール後、ターミナルで claude を実行すると Claude Code が起動します。
Windows の場合
ネイティブインストーラー（推奨）、WinGet、または WSL でインストールします。
# PowerShell（推奨、自動更新あり）
irm https://claude.ai/install.ps1 | iex
# または WinGet
winget install Anthropic.ClaudeCode
インストール後、ターミナル（PowerShell またはコマンドプロンプト）で claude を実行すると Claude Code が起動します。
Windows ではネイティブ（Git Bash が必要）と WSL の両方に対応しています。WSL 2 の使用が推奨されています。詳細は Claude Code 公式ドキュメントを参照してください。
その他のインストール方法については Claude Code セットアップガイドを参照してください。
インストール方法
方法 1: skills.sh からインストール（推奨）
skills.sh は AI エージェント向けスキルのオープンマーケットプレイスです。
npx skills add diverta/kuroco-skills
skills.sh でインストールすると、Kuroco Skills と一緒に find-skills メタスキルも自動的にインストールされます。
find-skills があることで、Claude Code が適切なスキルを選択して呼び出せるようになり、Kurocoに関する質問に対して、kuroco-skills を適切に使用します。
方法 2: Claude Code コマンドで追加
Claude Code 内で以下の 2 つのコマンドを実行します。マーケットプレイスの登録とプラグインのインストールは別の操作です。
/plugin marketplace add diverta/kuroco-skills
/plugin install kuroco-skills@diverta-kuroco-skills
インストール後、Claude Code を再起動するとスキルが有効になります。
方法 3: 手動でクローン（グローバル）
すべてのプロジェクトで Kuroco Skills を利用する場合は、グローバルにインストールします。
mkdir -p ~/.claude/skills
git clone https://github.com/diverta/kuroco-skills.git ~/.claude/skills/kuroco-skills
方法 4: プロジェクトローカルに追加
特定のプロジェクトでのみ利用する場合は、プロジェクトディレクトリに追加します。
mkdir -p .claude/skills
git clone https://github.com/diverta/kuroco-skills.git .claude/skills/kuroco-skills
同梱ドキュメント
Kuroco Skills には、Kuroco 公式ドキュメントがカテゴリ単位の統合ファイルとしてプラグインに同梱されています。 インストール後すぐに Claude Code がドキュメントを横断検索して、正確な回答を提供できます。
お知らせ・リリースノートは鮮度が重要なため同梱されていません。これらは公式サイトを参照してください。
ドキュメントを最新の状態に保つには、プラグイン自体を更新してください（更新方法を参照）。
基本的な使い方
Kuroco Skills をインストールすると、Claude Code で Kuroco に関する質問をした際に、関連するスキルが自動的に呼び出されます。 特別なコマンドや操作は必要ありません。
Kurocoに関する質問をする
以下のように Claude Code に質問すると、関連するスキルが自動的に使用されます。
| 質問例 | 使用されるスキル |
|---|---|
| 「Kuroco の API でログインを実装したい」 | api-content |
| 「Nuxt3 で Kuroco のコンテンツを表示したい」 | frontend-integration |
| 「バッチ処理で Slack 通知を送りたい」 | server-processing |
| 「Smarty のプラグインの使い方を知りたい」 | server-processing |
| 「サイトを KurocoFront にデプロイしたい」 | frontend-integration |
| 「Kuroco でアプリを丸ごと作りたい」 | app-builder |
| 「まず動く画面（プロトタイプ）を見せて」 | app-builder |
| 「管理画面からコンテンツを作成したい」 | admin-mcp |
| 「Claude Desktop から Kuroco を操作したい」 | admin-mcp |
| 「コンテンツ定義を新しく作りたい」 | content-structure-creation |
| 「Kuroco の利用料が増えた原因を調べたい」 | api-performance-review |
| 「セキュリティ設定に問題がないか確認したい」 | security-audit |
| 「Kuroco のドキュメントでエンドポイント設定を調べたい」 | kuroco-docs |
Claude に Kuroco の管理操作をさせる（Admin MCP）
Model Context Protocol にネイティブ対応するクライアント（Claude Code、Claude Desktop、Codex CLI など）向けに、Kuroco は Admin API を Admin MCP サーバとして直接公開しています。接続すれば、Claude Code に自然言語で指示するだけで管理操作を実行できます。
「ブログの記事を3件作成して」
「コンテンツ定義の一覧を確認したい」
「会員情報を取得してリストアップして」
エンドポイントは /direct/rcms_api/admin_mcp/ にマウントされ、HTTP POST + JSON-RPC 2.0 を受け付けます。ホストに応じて 2 種類の認証方式に対応します。
| ホスト | 認証方式 |
|---|---|
管理画面 URL（ROOT_MNG_URL） | 管理セッション Cookie（管理画面ログインと同じ） |
API URL（ROOT_API_URL） | Authorization ヘッダの Bearer トークン |
Bearer トークンは 2 種類を受け付けます。
- OAuth Authorization Server アクセストークン:
/direct/login/oauth_idp/{idpid}/tokenからtarget_domain=AdminMCPで発行。RFC 8707 / RFC 9728 に準拠した audience 拘束あり。エンドユーザー認可フロー向けの推奨方式です。 - 特権 static トークン（
api_id=-1）: 有効な管理セッションからAdminMCPServer::generateToken()で発行する Bearer。OAuth ハンドシェイクを張れないツール（プログラム的にトークンを取得して使うスクリプト、対話ログインを伴わない CI など）向けの経路です。
モジュールスコープ付き URL（/x/<csv>/readonly）の指定方法、認識される CSV エントリ、ツール名の規則などの詳細は MCP サーバ リファレンス を参照してください。
Claude Code への登録例
# OAuth Authorization Server 認可（エンドユーザー向けの推奨）
claude mcp add --transport http kuroco-admin \
https://example.g.kuroco.app/direct/rcms_api/admin_mcp/x/topics_group_1,member/readonly
# Static Bearer トークン（CI／無人エージェント向け）
claude mcp add --transport http kuroco-admin \
https://example.g.kuroco.app/direct/rcms_api/admin_mcp/x/topics_group_1,member \
--header "Authorization: Bearer <privileged-static-token>"
他クライアント別の設定方法や、ヘッダ受け渡しの詳細は MCP クライアント設定 を参照してください。
/direct/rcms_api/admin_mcp/ 配下のリクエストは /direct/ 経由として Kuroco の課金対象となります。AI エージェントが自律的に操作を繰り返すと意図せず多数のリクエストが発生する可能性があるため、読み取り中心のエージェントには /readonly、CSV のモジュール指定は本当に必要な範囲に絞ることを推奨します。
更新方法
Claude Code コマンドで追加した場合は、マーケットプレイスとプラグインの両方を更新します。
/plugin marketplace update diverta-kuroco-skills
/plugin update kuroco-skills
更新の反映には Claude Code の再起動が必要です。
/plugin marketplace add は登録のみを行うコマンドで、すでに登録済みのマーケットプレイスに対して実行しても最新版は取得されません（already on disk と表示されます）。更新には /plugin marketplace update を使用してください。
手動でクローンした場合は、git pull で更新します。
cd ~/.claude/skills/kuroco-skills
git pull origin main
リポジトリ構成
kuroco-skills/
├── .claude-plugin/
│ └── plugin.json # プラグインメタデータ
├── skills/
│ ├── kuroco-docs/ # ドキュメント検索 + 公式ドキュメント（同梱）
│ ├── app-builder/ # アプリ・サイトの構築ワークフロー（フロントエンド先行）
│ ├── api-content/ # API パターン + コンテンツ CRUD
│ ├── frontend-integration/ # Vite/Nuxt/Next.js 統合 + KurocoFront デプロイ
│ ├── server-processing/ # Smarty プラグインリファレンス + バッチ & Webhook
│ ├── admin-mcp/ # Admin MCP 接続、OAuth/CIMD、スコープ
│ ├── content-structure-creation/ # MCP によるコンテンツ定義作成
│ ├── api-performance-review/ # API パフォーマンス・コストレビュー
│ └── security-audit/ # セキュリティ設定チェック
├── scripts/
│ └── consolidate_docs.py # 同梱ドキュメントの統合ファイル再生成（メンテナ向け）
└── README.md
関連ドキュメント
サポート
お探しのページは見つかりましたか？解決しない場合は、問い合わせフォームからお問い合わせいただくか、Slackコミュニティにご参加ください。