Claude Code×microCMSで、ヘッドレスCMS導入を受託メニューに──スキーマ設計、APIキーの分け方、範囲と見積もりの計算例

この記事は、Claude Code×microCMSで、ヘッドレスCMSの導入を「一式」ではなく範囲の決まった受託メニューにする方法を扱います。

「CMSを入れておいて」で受けると、どこまでも終わらない

「更新しやすいように、CMSを入れておいてください」

この一言で受けたヘッドレスCMSの導入は、たいてい赤字になります。
どの項目を入力欄にするのか、下書きを誰が確認するのか、公開したら何秒で反映されるべきか。何も決まっていないからです。

Claude Codeを使えば、取得のコードや型の定義は速く書けます。
けれど、速くなるのは実装の一部だけです。範囲を決めないまま受ければ、浮いた時間は打ち合わせと手戻りに消えます。

microCMSの導入支援とは、入力する人の作業を項目に分け、権限と反映の流れまで決めて渡す仕事である

黒字化の外科医です。microCMSの導入を、売れる受託メニューにする線の引き方を解剖します。

範囲を決めるべき理由は、三つあります。

第一に、価値の中心は「スキーマ設計」だから。
入力欄の分け方を誤ると、納品後に「この欄がない」「ここは自由に書かせて」が続きます。コードより先に、入力する人の作業を聞き取る時間を見積もりに入れます。

第二に、APIキーは顧客の資産を動かす鍵だから。
microCMSの公式ドキュメントは、APIキーを知られるとコンテンツを操作されるおそれがあるため、秘匿するよう求めています（microCMS公式ドキュメント、2026年11月2日確認）。キーの発行と権限の設計は、作業ではなく責任の範囲です。

第三に、公開してから表示されるまでの流れが、問い合わせの数を決めるから。
「公開したのに変わらない」は、納品後に一番多い連絡です。Webhookで再ビルドする設計にするのか、表示のたびに取得するのかを、先に決めます。

公式ドキュメントで確かめた、microCMSとClaude Codeの事実

以下は、microCMSとClaude Codeの公式ドキュメントで確かめた範囲です（2026年11月2日確認）。

• コンテンツの取得は `X-MICROCMS-API-KEY` ヘッダーで認証し、下書きは `draftKey` を指定して取得できる
• Webhookは、公開・非公開・下書き保存・削除などをきっかけに、Vercel、Netlify、Cloudflare Pages、GitHub Actionsなどへの再ビルドや、任意のURLへの通知を送れる。失敗した通知は再送されない
• 任意のURLへの通知では、シークレットを設定すると署名のヘッダーが付き、受け側で検証できる
• 公式のMCPサーバーがあり、ベータ版と明記されている。認証はAPIキーで、AIの操作には本番とは別の専用キーを、必要な権限だけで発行するよう案内している

MCPを使うなら、読み取りだけのキーから始めるのが安全な順番です。

▶ Claude CodeのMCPで社内ツールをつなぐ前に──信頼できるサーバーか、どこまで許すか、どの情報が流れるかの点検表

今すぐ試せる：microCMSのスキーマ案を下書きするプロンプト

私はWeb制作会社のディレクターです。顧客のサイトにmicroCMSを導入します。
入力する人の作業から、APIとスキーマの案を作ってください。

【前提】
・サイトの種類とページ構成：〔記載〕
・更新する人と、その人のITの得意さ：〔記載〕
・更新する頻度と、更新する箇所：〔お知らせ週1回、採用情報 月1回 など〕
・下書きを確認する人：〔記載〕

1. リスト形式とオブジェクト形式のどちらにするか、API単位で案を出す。
2. 各APIのフィールド（名前、種類、必須かどうか）を表で出す。
3. 「自由に書ける欄」を増やしすぎていないか、理由とともに指摘する。
4. APIキーを、表示用（読み取り）と入稿の補助用に分ける案を出す。
5. 決めきれない点を、顧客への質問として5つ書き出す。

打ち合わせで直す前提の案として出すこと。

microCMS導入工場：範囲、見積もり、権限の型

範囲の型（見積書に書く）

【含む】
・更新作業の聞き取りと、スキーマ設計（API〇本まで）
・microCMSのAPI設定と、メンバーの権限設定
・サイト側の取得処理と、下書きのプレビュー
・公開時の再ビルド（Webhook）の設定
・既存記事の移行（〇本まで）
・入稿マニュアルと、操作説明（〇時間）

【含まない】
・公開後のスキーマ追加（別途お見積り）
・記事の原稿作成と、画像の加工
・microCMSの利用料（お客様のご契約）

見積もりの計算例

（例：時間単価8,000円、API4本、既存記事100本）
聞き取りとスキーマ設計　　　12時間
microCMSの設定と権限　　　　 4時間
取得処理と下書きプレビュー　16時間
Webhookと再ビルド　　　　　　4時間
既存記事の移行　　　　　　　 8時間
入稿マニュアルと操作説明　　 6時間
確認と修正　　　　　　　　　 6時間
合計　　　　　　　　　　　　56時間 × 8,000円 ＝ 448,000円

Claude Codeで短くなるのは、主に「取得処理」と「移行のスクリプト」です。
短くなった分は値下げにせず、スキーマ設計の聞き取りと、入稿の練習に回します。そこが納品後の問い合わせを減らします。

アカウントと鍵の分担表

□ microCMSのサービスは、お客様の名義で契約する
□ 制作会社は、メンバーとして招待を受ける（必要な権限だけ）
□ 表示用のAPIキーは、GETだけの権限で発行する
□ AIやMCPで使うキーは、別に発行し、作業が終わったら削除する
□ キーはリポジトリに書かず、ホスティングの環境変数に置く
□ Webhookの通知先と、シークレットの保管場所を記録する
□ 納品時に、発行したキーと招待の一覧をお客様に渡す

APIキーの扱いは、契約書か覚書で範囲を決め、お客様の同意を得てから発行します。
なお私は弁護士ではありません。実務の指針として読み、個別の判断は専門家や公的な窓口に確認してください。

▶ APIキーの漏洩対策、制作会社は「書かない仕組み」と「漏れたら止める初動」──Git・.envの置き方、シークレットスキャン、鍵の無効化と再発行

構造的なリスク

逆説を指摘しておきます。

ヘッドレスCMSは、サイトとCMSの2つを守る構成です。
CMSの画面は使いやすくなっても、表示側の保守が残ります。導入費だけで受け、保守の月額を決めないと、2つ目のシステムを無償で守ることになります。

▶ ヘッドレスWordPressを提案する条件──「速くて新しい」で選ぶと保守が倍になる、採用してよい5つの条件と、2つのシステムを守る保守料の計算例

よくあるQ&A

Q. WordPressとどちらを勧めるべきか？

更新する人と頻度で決めます。プラグインで機能を足したいならWordPress、決まった項目を決まった人が入れるならヘッドレスが向きます。

Q. MCPで記事の入稿まで任せてよいか？

公式もベータ版としています。まずは読み取りから試し、書き込みは下書き保存までにして、公開は人が押す形にしてください。

Q. 既存記事の移行は、どこまで約束するか？

本数と、本文の中の画像やリンクの扱いを、範囲に書きます。崩れた記事の手直しは、時間単価で別にします。

最後に

microCMSの導入で売れるのは、APIをつなぐ作業ではなく、入力する人の作業を項目に分ける設計です。

スキーマと鍵と反映の流れまで範囲に書いた会社だけが、ヘッドレスCMSの導入を、赤字にならない受託メニューにできるのです。

これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。

#Web制作会社 #microCMS #ClaudeCode #ヘッドレスCMS #見積もり #受託開発 #制作会社経営 #中小企業 #APIキー #Jamstack