<p>microCMS公式のMCP（Model Context Protocol）サーバーを活用し、既存記事の再編集にトライしました。</p><p>以前は新規記事の入稿を試しましたが今回は、メタディスクリプションをAIに生成させ、直接microCMSへ書き込む仕組みを構築した記録です。</p><div class="iframely-embed"><div class="iframely-responsive" style="height: 140px; padding-bottom: 0;"><a href="https://841-biboroku.info/entry/microcms-mcp-server-hands-on/" data-iframely-url="https://cdn.iframe.ly/api/iframe?card=small&amp;url=https%3A%2F%2F841-biboroku.info%2Fentry%2Fmicrocms-mcp-server-hands-on%2F&amp;key=c271a3ec77ff4aa44d5948170dd74161"></a></div></div><script async src="https://cdn.iframe.ly/embed.js" charset="utf-8"></script><h2 id="ha9ea0715ee">試した環境</h2><ul><li>Claude Desktop Claude Sonnet 4.6</li><li>microCMS（Hobbyプラン）</li></ul><h2 id="ha8bc14ce49">なぜディスクリプションを再編集しようと思ったか</h2><p>このブログではNext.js側でデフォルト設定として「タイトル＋固定文」を結合してディスクリプションを動的生成し、microCMSのフィールドでユニーク設定できるようにしています。</p><p>せっかく作ったフィールドも使っていない...</p><h3 id="h0f1dca437b">ふと気になった</h3><p><strong>📝ブログカードの見た目</strong></p><p>記事内でリッチエディタの埋め込み（ブログカード）を使ったとき、タイトルと説明文に同じテキストが並んでしまう。</p><p><strong>🚀MCPの練習</strong></p><p>既存記事の再編集（PATCH）を試すのに、ディスクリプションはちょうどよかった。</p>

<p><span class="txt-small">▲ ブログカード表示のイメージ</span></p><h2 id="h6a394f774f">1. microCMS側の設定</h2><h3 id="had3fd3fc62">1-1. API権限の設定</h3><p>API設定からPATCH権限を有効にします。</p><p>設定しないと読み取りはできても書き込みでエラーになります。</p><h3 id="hb78c7c7f54">1-2. フィールドの確認</h3><p>過去に作成していたメタディスクリプションのフィールドをそのまま利用します。</p><h2 id="he9d930a6a9">2. Claudeでの実行プロセス</h2><p>※事前にmicroCMS公式の「<a href="https://blog.microcms.io/microcms-mcp-server/" target="_blank" rel="noopener noreferrer nofollow">microCMSのMCPサーバーをリリースしました</a>」記事を参考にmicroCMS MCP Serverの設定をしておきます。</p>

<h3 id="h2738dab2dc">2-1. AIへの指示</h3>

microCMSの以下条件の記事の内容を確認し記事ページに設定するメタディスクリプションを考え、要約した内容を該当記事の指定フィールドに入稿・登録してください。

## 対象コンテンツAPI
{対象コンテンツAPIを記載}

## 条件
- ステータスが公開中のみを対象
- 要約する文章は80～100文字

## 要約するためのAPIスキーマ
- フィールドIDが{FIELD_ID}に登録されている本文情報

## 要約したディスクリプションの登録先
- フィールドIDが{FIELD_ID}に登録してください。

## 流れ
- まずは、試しに１つ対応してください。
- 確認したあとに問題なければ残りの要約を依頼します。

<h3 id="h1f8ce835a8">2-2. Claudeの自動稼働と提案</h3><p>指示を受けると、ClaudeはMCP経由でスキーマと公開記事を確認。内容を読み取って以下のような案を出してくれました。</p>

メタディスクリプション案（80〜100文字）：
「Astro v5のContent Layer APIを使った記事詳細ページの実装手順を解説。getStaticPathsやgetCollectionでデータを取得し、Zodの型定義を再利用してシンプルに実装する方法をまとめます。」

<h3 id="h1b5ced284a">2-3. microCMSへの書き込み</h3><p>内容を確認して問題なければ実行！</p><p><code>microcms_patch_content</code>が実行され、管理画面側で正しくテキストが登録されていることが確認できました。</p>

<h2 id="h72b0258126">3. 残り記事の更新</h2><h3 id="hec5c0e2756">あえて「1件ずつ」選んだ理由</h3><p>最初のテストが成功したあと、残りの全記事（約50件）も実行するように指示しました。</p><p>ここでうまくいかず...</p><p><strong>最初は一括処理で失敗</strong></p><p>まとめて処理させようとすると、複雑なスクリプトを組もうとして途中で止まったり、APIの制限でエラーが出たりと、かえって時間がかかってしまいました。</p><p><strong>1件ずつの繰り返しへ変更</strong></p><p>指示を「1件ずつ内容を確認し、生成・書き込みを繰り返して」と変更。</p><p><strong>結果</strong></p><p>Claudeが <code>microcms_patch_content</code> を淡々と繰り返し、途中で止まることもなく約50件の記事が10〜15分ほどで完走。 </p><h2 id="h47069e2352">4. 文章校正</h2><p>確認する前にAIによるセルフ校正チェックを挟みます。</p><h3 id="h38e9ee296d">4-1. 校正ルールの提示</h3><p>いきなり校正チェック～修正を実行せず、どのような基準でチェックすべきかをClaudeに提示させました。</p><h4 id="h56d3a5223d">👉提案された内容</h4><ul><li>ネガティブワード — 「つらい」「失敗」「苦労」「問題」「エラー」「悩み」など、読者に不安や苦労を想起させる表現</li><li>自信のなさを示す表現 — 「〜してみた」「〜試した」など、権威性・信頼性を下げる可能性のある表現（ただしブログの性質上許容範囲もある）</li><li>曖昧・冗長な表現 — 「〜をまとめた備忘録です」の繰り返しによる単調さ</li><li>読者メリットが不明瞭 — 何が得られるか伝わらない説明文</li><li>日本語の不自然さ — 助詞の誤り、文末の不統一、句読点の問題など</li></ul><h3 id="h8656e9c4d2">4-2. 校正後の修正PATCH</h3><p>どこをどのように修正するかを提示してくれます。</p><p>内容を確認し、提示された箇所を再度PATCHで上書き修正してもらいます。</p><p>完成です。</p><h2 id="h2e7eae0659">つまづきポイント</h2><h3 id="h3844e7f9e0">👿PUTとPATCHの使い分け</h3><p>前回、新規記事の入稿を試した際はPUTを使っていました。</p><p>今回もPUT権限でいいだろうと実行したところ、Claude（MCP）側は「部分更新」と判断してPATCHでリクエストを送信していたので権限不足ではじかれてしまいました🫠</p><p>自動でPUTで実行して書き込みはできたのですが、全フィールドのデータを上書きするので本文が空になってしまう危険も。</p><h4 id="h634b0ed1cb">編集ならPATCH一択</h4><p>今回のような部分更新なら安全で低負荷のPATCHが最適です。</p><h3 id="hdc770c9f35">👿一括もいいけど1件ずつの繰り返し</h3><p>最初は全件まとめてやってと指示しましたが、何度か途中で中断するはめに。</p><p>複雑なスクリプトを組もうとして環境依存（pip等）の問題にぶつかっていたとのこと。</p><p>一向に進まないので、1件ずつPATCHを叩くように変更したところ最後まで止まらず実行されました😀</p>

<h4 id="h79ee8e3598">Claudeに何があったのか質問してみた💭</h4><ul><li><strong>環境依存の壁</strong><ul><li>Pythonスクリプトの実行に pip install が必要で、ネットワーク制限などの環境トラブルに弱かった。</li></ul></li><li><strong>不透明な中間工程</strong><ul><li>「テキスト抽出 → 生成 → ファイル保存 → 読み込み → 登録」と工程が多く、どこで失敗したかの切り分けが困難だった。</li></ul></li><li><strong>リトライの負荷</strong><ul><li>処理が途中で止まると、どこまで進んだかの管理ができず、最初からやり直す必要があった。</li></ul></li><li><strong>ツールへの依存</strong><ul><li>「自動化ツールを作る」こと自体が目的化し、本来の「APIを叩いて更新する」というシンプルなゴールを複雑にしていた。</li></ul></li></ul><h3 id="h77c28c7f18">👿あくまでも自動生成</h3><p>生成されたテキストを確認していたところ「設定手順と呪った点をまとめます」と。呪った...！👀</p><p>自分で確認する前にまずはAIで校正チェックと修正をしてから確認するフローに変えました。</p>

<h2 id="hba9913274f">microCMSの履歴はどうなる？</h2><p>MCP経由で編集した場合、管理画面の履歴はどうなるのか確認してみました。</p><h3 id="hdf97d4592e">最終更新</h3><p>通常はアカウント名が出ますが、MCP経由（API）の場合は「API」と記録されます。</p><h3 id="h1345e787e1">過去の編集履歴</h3><p>編集履歴にも更新者が「API」として残っていることを確認できました。</p><p></p>

<p><span class="txt-small">※次に保存されたタイミングで現在のデータが履歴に残るので、MCPで書き換えた直後のログは、次に更新（保存）を行った際に一つ前の履歴として確認できるようになります。</span></p><h3 id="h22583e3de8">ブログカードの見え方</h3><p>これまではタイトルと説明文に同じテキストが並んでいましたが、要約が入ることでブログカードの情報の密度が上がり、パッと見の印象がぐっと良くなりました👍</p>

<h2 id="ha214098e44">まとめ</h2><p>今回はディスクリプションということで、文脈の作り込みよりも要約の自動化に重きを置きましたが、タイトルや本文から要点をまとめてくれて、運用の負担が軽減されました。</p><p>長らく空欄のままだったディスクリプションのフィールドも、ようやく日の目を見ることができてうれしい限りです✨</p><p>今回のように既存記事に対するアクションを実践してみて、記事内容を理解させた上でのタグ付けや、アイキャッチ画像の自動生成なども現実的だと感じました。</p>

microCMS MCP×Claudeで実現。AIによるメタディスクリプション自動生成とPATCH更新の実践ログ

<p>microCMS MCP Serverを使ってClaude Desktopからブログ投稿を自動化する実践記事です。</p>

<p>この記事内の「👉ここから先がClaude Desktop×microCMSのMCPサーバーで作成し自動投稿した記事」という見出し以降は自動投稿の内容となります。</p><p>前半は、実際に試した流れや発生したエラーなどを備忘録としてまとめました。</p><h2 id="ha9ea0715ee">試した環境</h2><ul><li>Claude Desktop（Freeプラン）Claude Sonnet 4</li><li>microCMS（Hobbyプラン）</li></ul><h2 id="h31fc5cbc4a">事前準備</h2><p>microCMS MCP Serverの設定については、microCMS公式の「<a href="https://blog.microcms.io/microcms-mcp-server/" target="_blank" rel="noopener noreferrer nofollow">microCMSのMCPサーバーをリリースしました</a>」記事を参考にしました。</p><p>Claude DesktopのJSONにMCPの設定を書いて再起動し、スキーマの読み込みから記事作成まで実際に試してみました。</p><h2 id="h7921b37509">試した流れ</h2><h3 id="hba26efff2d">初回指示内容</h3><blockquote><p>microCMSで作った2つのAPIのスキーマです。まずはこの内容を理解してください。（jsonファイルを添付）</p></blockquote><p>💎microCMSで構築されたブログシステムの構造を理解しました。</p><blockquote><p><a href="https://blog.microcms.io/microcms-mcp-server/" target="_blank" rel="noopener noreferrer nofollow">https://blog.microcms.io/microcms-mcp-server/</a> この記事を読んで設定を試しています。実際に使ってみてClaude Decktopのjsonに設定を書いて再起動、スキーマを読み込ませて記事を書かせてみたという記事を書きたいです。カテゴリはAIを使います。まずは記事を書いてください。</p></blockquote><p>💎記事の内容を作成させていただきます。</p><h3 id="h702129e458">1. POST権限エラー</h3><pre><code>Error: fetch API response status: 400 message is `POST is forbidden.`</code></pre><p><strong>原因</strong><br>microCMSのAPIキー設定でPOST権限が有効になっておらずエラーが発生しました。</p><p><strong>対処</strong><br>APIキー設定でPOST権限をONへ（HobbyプランはAPIキーが1つのため一時的にONにしました）</p><h3 id="hf8bed3c3d0">2. ステータスパラメータエラー</h3><pre><code>Error: fetch API response status: 400 message is Status parameter is not available in the current plan. Please upgrade your plan.</code></pre><p><strong>原因</strong><br>Hobbyプランではステータスパラメータ（下書き指定）が使用できません。</p><p><strong>対処</strong><br>下書きでの保存指示をやめて再指示へ</p><p>Claudeは状況を理解して「下書きでの保存ができないプランのようなので、公開状態で記事を作成します」と自動的に判断してくれました。</p><h3 id="h11f0ef414d"><strong>3. ネットワークエラー</strong></h3><pre><code>Error: Network Error. Details: fetch failed</code></pre><p><strong>原因</strong><br>一時的なネットワークエラーが発生したようです。</p><p><strong>対処</strong><br>Claudeが自動的に少し待ってから再トライしてくれました。</p><h2 id="h4275e6dd0e">💪指示内容を改善してみる</h2><p>Claude（Freeプラン）の文字制限に引っ掛かるためより具体的な指示に変更しました。</p><ul><li>カテゴリは登録済みの「AI」を使う</li><li>sectionというスキーマはカスタムフィールドを繰り返し使用できるようにしている</li><li>コードを書く場合はhighlight、文章を書く場合はricheditorを使う</li><li>他は今回使わなくてよい</li><li>Hobbyプランなので公開ステータスで書いてほしい</li></ul><p>追加でClaudeがカスタムフィールドの使い方を学ぶために、過去の記事データを1記事分のJSONデータとしてスキーマと一緒に渡しました。</p><h2 id="h01bdfecc91">最終的な結果</h2><p>何度か指示を書き直して試しましたが、以下の処理を自動で実行してくれて公開までたどり着けました<strong>😊</strong></p><ol><li>既存カテゴリ「AI」の確認・選択</li><li>記事内容の作成</li><li>公開ステータスでの記事作成</li><li>記事IDのレスポンス返却</li></ol><p>（最後レスポンス返却で制限に引っ掛かったのでまだ続きがったかもしれません・・）</p><h2 id="h06d13437e4">失敗したこと</h2><p>制限に引っ掛かってしまうのでスキーマのjsonを渡した際、解析と記事の作成をまとめて指示するとスキーマの解析が中途半端に。</p><p>書いた記事がカスタムフィールドの形式に合わず、過去記事を探しに行き学習したあと、書き直しをしていました。順序だてて実行することで精度があがることを忘れてはいけないなと反省しました。</p><h2 id="ha214098e44">まとめ</h2><p>有料プランであればさらに多くの状況判断ができそうで、より複雑な記事作成から公開まで自動化できる可能性を感じました。</p><p>実際に最初から最後まで1チャットで完結することはできませんでしたが、何度か試す中で以下のような処理をして柔軟に対応しようとしてくれました💡</p><ul><li>カテゴリの有無確認<ul><li>作成しようとして存在していることがわかると作成をやめて既存カテゴリを選択</li></ul></li><li>他の記事のスキーマ使用方法学習</li><li>エラー発生時の自動対処</li><li>プラン制限の理解と代替案提示<ul><li>Hobbyプランなので下書きにせず公開へ</li></ul></li></ul><p>自動化なのでもちろん楽でした🎉</p><p>装飾付けたりするのが地味に面倒なのですが、自動でリンク設定も別タブにしてくれたりかなり便利です。コードは専用のカスタムフィールドを用意しているのですが、指示したこともあり、正しい使い方で記載してくれました👏</p><p>こんな使い方もできたらいいな..という願いで、フィールド選択や装飾は十分イイ感じなので、サイトリニューアルで別CMSから記事を移行するときに、スクレイピング記事登録、画像アップロードや最適化までしてくれたらかなり楽になりそうですね！</p><p>今後も楽しみです🥳</p>

<h2 id="he1b4333ba2">👉ここから先がClaude Desktop×microCMSのMCPサーバーで作成し自動投稿した記事</h2><p>先日、microCMSからリリースされた「<a href="https://blog.microcms.io/microcms-mcp-server/" target="_blank" rel="noopener noreferrer">microCMS MCP Server</a>」を実際に導入し、Claude Desktopと連携してブログ投稿を自動化してみました。</p><p>MCP（Model Context Protocol）とは、AI アシスタントが外部システムと安全に連携するためのプロトコルで、これによりClaude DesktopからmicroCMSのコンテンツを直接操作できるようになります。</p><p>実際の設定手順から使用感まで、詳しくレポートしていきます。</p>

<h2 id="h4cc8fe4c38">セットアップ手順</h2><h3 id="hfd86c073b8">1. microCMS APIキーの取得</h3><p>まず、microCMSの管理画面からAPIキーを取得します。</p><ul><li>「API キー」メニューから「作成」をクリック</li><li>「書き込み」権限を有効にして作成</li><li>生成されたAPIキーをコピーして保存</li></ul><h3 id="hf3d632d6b9">2. Claude Desktop設定ファイルの編集</h3><p>Claude Desktopの設定ファイルに、microCMS MCP Serverの設定を追加します。</p>

<h3 id="h5095390624">3. 環境変数の設定</h3><p>設定ファイルの<code>MICROCMS_SERVICE_DOMAIN</code>と<code>MICROCMS_API_KEY</code>を実際の値に置き換えます。</p><ul><li><code>MICROCMS_SERVICE_DOMAIN</code>: microCMSのサービスドメイン（例：your-blog）</li><li><code>MICROCMS_API_KEY</code>: 先ほど取得したAPIキー</li></ul><p>設定後、Claude Desktopを再起動すると、MCPサーバーが有効になります。</p>

<h2 id="hd1cdf3fdf7">実際の使用体験</h2><h3 id="h65ba23de30">スキーマの読み込み</h3><p>Claude Desktopを再起動後、まずはmicroCMSのスキーマ構造を読み込ませました。</p><p>「私のブログのスキーマを教えて」と質問すると、Claude が自動的にmicroCMSのAPIにアクセスし、以下のような情報を取得してくれます：</p><ul><li>各コンテンツタイプのフィールド構成</li><li>カスタムフィールドの詳細</li><li>必須フィールドや制約事項</li></ul>

<h3 id="hbd93833921">記事の作成体験</h3><p>実際に記事を作成してみると、驚くほどスムーズでした。</p><p>「技術記事を書いて」と依頼すると、Claude が：</p><ol><li>適切なカテゴリを自動選択</li><li>記事構成を考慮してsectionフィールドを構築</li><li>コード部分は<code>highlight</code>フィールドを使用</li><li>本文は<code>richeditor</code>フィールドで構成</li></ol><p>このように、スキーマの構造を理解した上で、適切なフィールドを選択して記事を作成してくれました。</p>

<h2 id="h7d5d0816f4">メリットと課題</h2><h3 id="h3ab24f6f50">メリット</h3><ul><li><strong>効率的な記事作成</strong>: 管理画面を開かずに記事を作成・更新できる</li><li><strong>スキーマ理解</strong>: 複雑なカスタムフィールドも適切に処理</li><li><strong>一貫性のある構成</strong>: 毎回同じような構造で記事を作成</li><li><strong>下書き機能</strong>: 公開前に内容を確認できる</li></ul><h3 id="ha60de12900">現在の課題</h3><ul><li><strong>画像アップロード</strong>: 現時点では画像の直接アップロードが必要</li><li><strong>プレビュー機能</strong>: 実際の表示を確認するには管理画面が必要</li><li><strong>権限管理</strong>: APIキーの管理に注意が必要</li></ul>

<h2 id="h8f041e8caa">今後の可能性</h2><p>microCMS MCP Serverの登場により、コンテンツ管理の自動化が大きく進歩しました。</p><p>今後期待される機能：</p><ul><li>画像生成・アップロード機能の統合</li><li>SEO最適化の自動化</li><li>複数記事の一括管理</li><li>コンテンツ分析・改善提案</li></ul><p>特に、AIによるコンテンツ生成と、headless CMSの柔軟性を組み合わせることで、新しいコンテンツ制作フローが生まれそうです。</p>

<h2 id="ha214098e44">まとめ</h2><p>microCMS MCP Serverを実際に使ってみて、技術ブログの執筆効率が大幅に向上しました。</p><p>特に、スキーマの複雑さを気にせずに記事を作成できる点と、Claude Desktopの自然な対話形式での指示が可能な点が素晴らしいと感じました。</p><p>まだリリースされたばかりのツールですが、今後のアップデートにも期待しています。headless CMSとAIの組み合わせは、コンテンツ制作の未来を大きく変える可能性を秘めていると思います。</p><p>興味のある方は、ぜひ一度試してみてください！</p>