StudioからmicroCMSへ移るとき、サイトのフロントエンド(表示側)はどう作りますか?

結論

microCMSは記事や画像などのデータを管理する仕組みのため、画面を表示するフロントエンドはNext.jsやAstroなどの技術を使って自前で用意するか、Studioを表示側として残してAPIで接続する形をとります。Studioからはデザインもデータも書き出せないため、どちらを選んでもある程度の作り直しは避けられません。

microCMSへの移行更新日

microCMSは表示側(フロントエンド)を別に作らないとサイトになりませんか?

なりません。必ずしも自前でプログラムを書いて表示側の画面を用意しなければならないわけではありません。

microCMSが受け持つのは、記事やお知らせを入力して保存する管理側だけです。そのため、何らかの形で画面を表示する環境を整える準備が欠かせません。

表示側の作り方は2通りあります。ひとつはNext.jsなどで新しく組む方法です。もうひとつはStudioを表示側として残す方法で、StudioのData Connect APIでmicroCMSの記事を取り込み、一覧ページや詳細ページに並べます。ただし、この方法が使えるStudioの料金プランには条件があります。Studioの正式版API機能は2026年4月17日に始まり、microCMSも2026年6月9日につなぎ方を公開しました。

ちなみに、Studioを残す場合は2026年10月の不正アクセスも関係してきます。Data Connect APIやAPI連携(Beta)に登録した外部サービスのAPIキーやトークンは、内容を知られた可能性があります(Studioの不正アクセスのお知らせ)。該当する場合は、microCMSで新しいキーを発行し、Studioの設定を新しいキーに書き換えてから、古いキーを無効にしてください。古いキーを先に止めると、サイトに記事が出なくなることがあります。

StudioからmicroCMSとNext.jsでサイトを作り直す手順は?

Studioで作ったサイトを、Next.jsとmicroCMSの組み合わせへ移行するにはどのような段取りが必要になるのでしょうか。StudioにはサイトのHTMLコードを丸ごと書き出す機能が備わっていません。今のサイトを見ながら、ページと記事を手で拾い直すところから始まります。

おおまかな流れは次のとおりです。

  1. 今のサイトのページと記事を一覧にし、残すもの・やめるものを決める
  2. microCMSでリスト形式のAPIを作り、記事の入力項目を決める
  3. 画像をmicroCMSにアップロードし、配信用のURLを控える
  4. サンプルCSVに記事を記入し、登録時の公開状態(下書き中か公開中)を選んでインポートする
  5. Next.jsで一覧ページと記事ページを作る
  6. 公開先とつなぎ、記事を更新したときに作り直しが走るよう設定する

記事コンテンツの移行では、microCMSのCSVインポート機能の仕様に沿ってデータを移し替えます。注意したい点として、CSVで流し込む本文HTMLはリッチエディタが解釈できるタグに限られます。画像の項目にはmicroCMSが配信する画像のURLを入れるため、Studioの画像URLをそのまま貼ることはできません。使えるのはリスト形式のAPIだけで、ファイルはUTF-8(BOMなし)で保存します。一度に取り込める件数の上限はプランで変わるので、記事が多いサイトは分けて入れる場面が出てくるでしょう。

フロントエンド側は、公式チュートリアルを参考にしながらNext.jsのApp Routerで記事一覧や詳細ページの表示ロジックを組み上げます。公開環境にVercelを採用する場合は、Deploy Hooksを設定しておくと便利ですね。記事の公開や更新に合わせてmicroCMSから通知を送り、サイトの再デプロイを自動で走らせる仕組みを整えられます。もっとも、CSVで追加したコンテンツではWebhookが送られないため、初回の取り込み後は手動でデプロイしてください。

Next.js・Nuxt・Astroのどれでフロントエンドを作ればいいですか?

React系で広く普及しているNext.js、VueをベースにしたNuxt、コンテンツ配信に特化したAstroでは、それぞれ得意とする設計思想がはっきりと分かれています。どれを選んでもmicroCMSとはつなげるので、違いは作る人の慣れと、サイトの更新の仕方で考えます。

土台になる技術向いている場面
Next.jsReact記事が多く、更新をこまめに反映したいサイト
NuxtVue 3Vueで作った経験がある人が組む場合
Astro独自(React・Vueの部品も追加可)ブログや会社案内など読ませる内容が主のサイト

Next.jsにはISRという仕組みがあり、サイト全体を作り直さずに静的なページを更新できます。アクセスが来たときに裏でページを確かめ直す方式なので、決まった時間ごとに必ず作り直されるわけではありません。

一方で、社内ですでにVue.jsを使った開発経験があるならNuxtが適しています。NuxtはVue 3を統合しており、単一ファイルコンポーネントの記述方法をそのまま活かして直感的に画面を組み上げられます。

Astroはブログやマーケティング用のサイトなど、読ませる内容が中心のサイトを作るためのものです。前もってページを作っておくことも、アクセスのたびに作ることもでき、動きのある部品が要る所だけブラウザ側で動かせます。静的なサイト専用というわけではありません。

Studioで作っていたのが会社案内とお知らせくらいならAstro、記事の量が多くReactを書ける人がいるならNext.jsが、作り始めてから困りにくい選び方かもしれません。

AIやClaude CodeでmicroCMSのフロントエンドを作れますか?

AIコーディングツールやClaude Codeを活用して、microCMS向けのフロントエンドを自前で構築することはできるのでしょうか。microCMSはClaude Code向けの公式スキルを出していて、Next.jsとの連携づくりを手伝わせられます。App Routerでのデータ取得、キャッシュやISR、Draft Mode、画像の最適化まで扱い、「microCMSの更新をWebhookから反映したい」といった頼み方にも対応しています。

ただし、AIにコードを書かせるときには、安全面の設定を自分で点検しなければなりません。とりわけNext.jsにおける環境変数の扱いは見落としやすい部分です。Next.jsでは環境変数は基本的にサーバー側でのみ読み込まれますが、先頭にNEXT_PUBLIC_というプレフィックスを付けると、ブラウザ側に値がそのまま渡ってしまいます。単に環境変数の設定ファイルに書き込んだだけでは非公開が保たれないため、非公開にすべきAPIキーが公開変数に混ざっていないか入念に確認しておきたいところですね。

Studio時代と記事のURLが変わるなら、旧URLから新URLへの転送をサーバー側で恒久的に設定します。AIに作らせると新しい構成に合わせた別のURLになりがちなので、旧URLの一覧を先に渡しておくと手戻りが減ります。

エンジニアがいない会社でもmicroCMSを運用できますか?

日々の更新なら、エンジニアでなくても担当できます。管理画面が完全に日本語で作られていることに加え、操作に困ったときも日本語でサポート窓口に問い合わせができるため、海外製CMSのような言葉の壁を感じずに済むのが大きな理由です。

外部の制作会社に初期制作を任せて、社内では日々の更新に専念するという体制も定番の運用パターンですね。個別のページは形式を決めておき、差し替えられるのを文字と画像だけに絞る分け方もあります。新しい種類のページを増やしたり、デザインや入力項目を変えたりするときは、作った側に頼むことになるでしょう。

こうした分業体制を整えるうえでは、誤操作を防ぐ権限管理も役立ちます。microCMSの上位プランであるBusinessプランやEnterpriseプランにはロール機能が備わっており、メンバーごとに管理画面で操作できる権限を細かく切り分ける設定が可能です。それより下のプランでは、全員が同じ権限で触る前提になります。

まとめると、記事やお知らせの更新は社内で、表示側の作成と手直しは制作会社などに頼む、という分け方なら無理なく続きます。

microCMSを運用するとき、セキュリティ面で気をつけることは?

サーバー保守をすべて提供元に任せられるStudioと比べると、microCMSを導入したサイトではAPIキーの管理やアクセス制限の設計など、自前で目を配るべき範囲が広がります。隠すべきAPIキーと、出ても困らないAPIキーを分けて考えます。

microCMSでも原則としてAPIキーは非公開にすることが推奨されており、外部に見せないようにするにはNext.jsなどのサーバー側を経由してAPIを呼び出す仕組みを作らなければなりません。GET以外の権限を持つキーが知られると、外から記事を書き換えられます。GETだけのキーでも、下書き全取得の権限が付いていれば、公開前の下書きまで読まれてしまいます。

逆に、GET以外の権限も下書き全取得も付いておらず、管理する内容がすべて公開されても困らない情報なら、キーを必ずしも隠さなくてかまいません。お知らせを表示するだけの読み取り専用キーが、これに当たります。

一般的なクラウドの運用指針でも、APIキーをブラウザ側のコードに直接書き込んだり、コードの管理リポジトリへ保存したりしないよう注意が呼びかけられています。GitHubに上げたファイルにキーが残っていないか、公開前に一度見直してください。

管理画面に入る人の側の対策は、プランで使える機能が変わります(料金プランの機能比較)。

機能使えるプラン
メンバーごとの権限(ロール)Business・Enterprise
管理画面とAPIのIP制限Business以上
監査ログEnterprise
SAMLによるシングルサインオンEnterprise
2要素認証の必須化Enterprise

社外の制作会社にも管理画面を触ってもらうなら、どこまで制限をかけたいかでプランが決まります。

こんな聞き方も

  • microcms 移行
  • studio microcms
  • microCMS フロントエンド 作り方
  • microcms フロントエンド 必要
  • microcms next.js 作り方
  • microcms nuxt 作り方
  • microCMS 非エンジニア 運用
  • StudioからmicroCMSへ移行する手順はどうなっていますか?
  • StudioのmicroCMS連携と、microCMSへの完全移行はどう違いますか?
  • AIでmicroCMSのフロントエンドを作ることはできますか?
  • Claude CodeでmicroCMSとNext.jsのサイトを作れますか?
  • microCMSの管理画面は日本語で使えますか?
  • スタジオ(STUDIO)からマイクロCMSへ移行するにはどうしますか?
  • newt microcms 移行

あわせて知りたい(関連する疑問)

QNext.jsとmicroCMSのブログテンプレートはありますか?

ゼロからコードを書かずに素早くブログを立ち上げられるテンプレートはあるのでしょうか。あります。microCMSが出している「シンプルなブログ」というNext.jsの公式テンプレートです。このテンプレートを利用すると、記事の一覧ページ、個別の記事詳細ページ、さらにはキーワードやタグで絞り込む検索結果ページまでが一通り揃ったサイトを手軽に用意できます。microCMS側で管理できる項目も、記事の本文だけでなくタグ情報やライターのプロフィールまで最初から定義されているため、設計の手間を省けます。

始め方は、テンプレートを選んでGitHubにログインするところからです。すると、microCMSのサービスとGitHubのリポジトリが新しく作られます。ここで終わりではなく、そのあと手元で開発環境を整え、Vercelで公開するならリポジトリをつないで環境変数を登録します。ボタンを押しただけでサイトが公開されるわけではありません。

動かすにはNode.js 24以上が要ります。パソコンに古いNode.jsが入っていると最初の起動でつまずくので、バージョンを先に確かめておいてください。要件は更新されることがあるため、使う時点のREADMEに合わせます。

Studioから移る人にとっては、表示側の土台を一から書かずに済むのが大きいでしょう。とはいえ、テンプレートはあくまで標準的なブログの形です。Studioで作ったデザインに寄せる作業や、Studioにあった記事の移し替えは、テンプレートとは別にやることになります。

QNext.jsでmicroCMSの記事ごとにtitleやdescriptionを設定できますか?

できます。たとえば、microCMSの記事に「メタ情報」というカスタムフィールドを作り、タイトル・概要・OGP画像の3つを入れる欄を用意します。書き手は記事の編集画面で、本文と一緒にこの欄を埋めるだけです。

Next.jsのApp Router側では、generateMetadataという関数で記事のデータを取り、メタ情報の中のタイトルと概要をtitleとdescriptionとして返します。URLの末尾にある記事IDでmicroCMSから記事を1件取ってくれば、記事ごとに違うtitleとdescriptionがページに入ります。この関数はServer Componentsでしか使えないため、ブラウザ側で動く部品の中に書くと動きません。

記事タイトルや説明文のように改行を含まない文字列であれば、テキストフィールドを配置することでAPIから扱いやすいプレーンな文字列データとして保持できます。descriptionも1行で書く運用にするなら同じでかまいません。

Studioでは記事ごとのSEO設定を画面で入れていた人も多いはずです。microCMSに移っても、入力する欄を作り、表示側でそれを読む処理を書いておけば、同じように記事単位で設定できますね。

QmicroCMSのプレビューをNext.jsのDraft Modeでつなげますか?

「公開前に実際のレイアウトで記事の見栄えを確かめたいけれど、ヘッドレスCMSだと画面の確認が難しいのではないか」と不安に感じるかもしれません。microCMSの画面プレビューとNext.jsのDraft Modeはつなげますが、URLを登録するだけでは動かず、表示側の実装が要ります。

つなぎ方の流れは次のとおりです。

  1. microCMSで対象APIの「API設定」から「画面プレビュー」を開き、「遷移先URL」を設定する
  2. Next.jsに入口用のルートハンドラを作り、シークレット値と記事IDを確かめてDraft Modeを有効にする
  3. 確認が取れたら、その記事のページへ転送する
  4. 記事ページでDraft Modeが有効なら、下書きを取る処理に切り替える

遷移先URLには{CONTENT_ID}と{DRAFT_KEY}を、それぞれ1つだけ入れられます。2つ目以降は置き換わりません。

Draft ModeはCookieで有効になるので、入口のルートハンドラと表示ページの両方を作って初めて下書きが見えます。組み合わせとしてはNext.jsとVercelが推奨されていますが、SSRに対応したホスティングならVercel以外でも動きます。その場合、Cookieの扱いは公開先の仕様を確認してください。

なお、現在のNext.jsではdraftMode()の呼び出しが非同期処理に変更されています。Next.js 14以前の記事は同期で呼んでいるので、使っているバージョンに合わせて書き換えます。

Q美容室のサイトをmicroCMSで運用している事例はありますか?

ここでは個別の店舗名は挙げず、美容室のサイトをmicroCMSで動かすときの考え方をまとめます。

Studioで美容室のサイトを作っている人が移る場合は、メニューや料金、スタッフ紹介、お知らせのように変わる情報をmicroCMSの入力項目にし、レイアウトは表示側で固定します。

もうひとつ、公開前に見た目を確かめたいなら、その仕組みも表示側に作っておく必要があります。microCMSのプレビューは、表示側で下書きを取ってきて画面に出す処理があって初めて使えるからです。新メニューを出す前にスマホで確かめたい、といった使い方を考えているなら、制作を頼む段階で伝えておきましょう。

Q非エンジニアがmicroCMSでLPを作ることはできますか?

マウス操作だけで自由に新しいブロックを配置してデザインを仕上げられるStudioとは異なり、microCMSだけで非エンジニアがゼロからLPの画面を組み立てることはできません。microCMSは見た目を管理しないので、表示側と公開先は誰かが作る必要があります。

ただ、あらかじめエンジニアの手で表示側の枠組みを作っておけば、その後の文言修正や画像の入れ替えを非エンジニアが管理画面から行うことは十分に可能です。単なる文字の打ち替えにとどまらず、microCMSの繰り返しフィールドを活用すれば、お客様の声やキャンペーンの告知バナーといったパーツを新しく追加したり、ドラッグ&ドロップで並び順を入れ替えたりする柔軟な運用も実現できます。ただし、表示側がその並びに対応して作られていることが前提で、デザインを自由に変えられるわけではありません。

もしデザインの自由度を保ちつつコードを書かずにLPを増やしたいという希望があるなら、Studioを表示側としてそのまま使い続ける選択肢も考えられますね。Studio側でmicroCMSの認証情報と取得先を設定し、取ってきたデータをページの要素に結び付けます。StudioのData Connect APIは、Businessプラン以上で使えます(Data Connect APIの利用プラン、Connect microCMS with the API)。

Studioのプラン一覧の取得先詳細の取得先
Business1つまで利用不可
Business Plus制限なし制限なし
Enterprise制限なし制限なし

LPのように1ページで完結するなら、Businessの一覧1つでも足りる場合があります。

QmicroCMSとNewtはどう違いますか?

機能面を見ると、どちらもAPIを通じてコンテンツをやり取りする日本発のヘッドレスCMSとして設計されています。管理画面に入稿した記事や画像データをAPI経由で取得し、フロントエンド側で自由なデザインを組み立てられる点は共通しています。

ただ、いま比べる意味はあまりありません。Newtは公式からサービス提供終了の告知が出されており、2026年11月24日をもってすべてのサービス提供を終了する予定となっています。終了期日を過ぎると管理画面へのログインだけでなく、サイト側から呼び出しているAPIも利用できなくなります。新しいスペースの作成はすでに2025年5月20日で締め切られていて、これから始める人は選べません。料金表や機能を見比べて移行先を決める段階は過ぎていますね。

Newtを使っている人は、終了日までにデータを取り出しておきます。終了のお知らせには、よくある質問とデータエクスポートの案内へのリンクが載っています。書き出したデータがmicroCMSにそのまま入るかはわからないため、項目の並びを見ながらCSVに整え直す作業を見込んでおいてください。

Studioから移る人がヘッドレスCMSを探していて、比較記事でNewtの名前を見かけることもあるでしょう。古い比較記事では現役のサービスとして紹介されていますが、提供終了が決まっているので候補からは外して考えます。

QStudioからmicroCMSへ自分で移行できますか?

Web制作の基本がわかる人なら、自分で移行できます。そうでなければ、表示側だけでも外に頼むほうが早く終わります。

Studioにはサイトのデザインデータやページ情報、HTMLのソースコード、さらにはStudio CMS内の記事データを外部へ一括して書き出す機能が備わっていません。見た目をそのまま再現しようとすると、公開中のサイトを見ながら手作業でNext.jsのコードを起こし、記事も手作業やCSVで登録し直すことになります。他のプラットフォームへ移る場合は、移行先の環境でページを一から作り直す作業が発生します。

ノーコードツールとは異なり、画面の構築からエラーの解消まで自前でコードを書いて対処しなければなりません。また、Next.jsの資料はWeb開発の知識がある前提で書かれていて、HTML、CSS、JavaScript、Reactに慣れていると進めやすいとしています。

さらに、サイト移転に伴って各ページのURLが変わる場合は、検索順位の急落やリンク切れを防ぐ対応も発生しますね。URLが変わるなら、新しいサイトを十分に確かめてから旧URLと新URLの対応表を作り、旧URLから新URLへ転送する設定を入れて移転を始めます。ここを省くと、検索から来ていた人が古いURLでエラーページに行き着きます。こうした技術的な段取りを自社で引き受けられる人材がいない場合は、無理に社内だけで進めようとせず、外部の制作会社や開発パートナーへ相談することを視野に入れておきましょう。

出典

この内容をChatGPTで相談

無料診断