コンテンツにスキップ

EmDash:Cloudflare で動く WordPress 代替の CMS

⚠️ 導入と運営の手順、画面写真は 2026-10-14 時点(EmDash 1.2.0)で確かめたもの(R2 の有効化の画面だけは 2026-06-13 時点)。実際に試すときは最新の公式ドキュメント(docs.emdashcms.com)も確認すること。

「ブログを作るなら WordPress」という人は多い。その WordPress を Cloudflare の上で置き換える、というアプローチが EmDashエムダッシュ。Cloudflare 自身が出したオープンソースの CMS で、「WordPress の精神的後継」を掲げている。

このサイトのハンズオン(AST / ASB)では Astro でブログを 自分で作る 道を扱ってきた。EmDash はその対極で、CMS に運用を任せる 選択肢。ここでは EmDash の紹介と、導入・運営のおおまかな流れをまとめる。

EmDashのブログテンプレートで作ったサイト

EmDash のブログテンプレート(Blog)で作ったサイト(見てみる)

▶ 完成版を見てみる: emdash-sample.vibecodingnotes.com:EmDash のブログテンプレートで作った公開サイトの例。実際の表示を確かめられる。

先に結論(2026-10-14 時点のスタンス): EmDash は 2026年9月末に 1.0 が出て、beta(開発者プレビュー)を卒業した。公式は「本番で使える安定版」としている。ただし公式プラグインとプラグインの開発道具はまだ 0.x で、テーマやプラグインの数も WordPress とは比べものにならない。まずは試して評価し、本番のブログに使うかはそのうえで決める、という段階。

  • Cloudflare が 2026年4月 に発表したオープンソース CMS(MIT ライセンス、GitHub emdash-cms/emdash)。2026-09-28 に 1.0(1.0.1)が出て、2026-10-14 時点の最新は 1.2.0
  • TypeScript + Astro ベース。本番は Cloudflare ネイティブ(Workers=実行、D1=データベース、R2=メディア、KV=セッション)で動くサーバーレス構成。DB やストレージは SQLite / Postgres / S3互換などに差し替えも可能
  • 管理画面つき: ビジュアルなスキーマビルダー、メディアライブラリ(ドラッグ&ドロップ)、メニュー、タクソノミ、ウィジェットなど、WordPress 的な運用に必要なものが一通り揃う
  • AIネイティブ: 内蔵の MCP サーバ・AI支援用の スキル・CLI を備え、Claude Code のような AI エージェントから記事の作成・管理ができる。プロジェクトを作ると、スキルと公式ドキュメントの MCP の設定が最初から入っている
  • プラグインをサンドボックス実行: 各プラグインを Worker isolate 内で隔離し、マニフェストで宣言した権限しか使えない
WordPressEmDash
実行基盤PHP + MySQL のサーバーCloudflare のエッジ(Workers + D1 + R2)
プラグイン強力だが脆弱性の温床になりがちWorker isolate でサンドボックス化、権限を宣言制に
AI連携後付け最初から MCP / Skill / CLI を内蔵
構成テーマ・プラグインのエコシステムが巨大OSS だがエコシステムはこれから

「PHP を立てずに、Cloudflare の世界で完結する WordPress 的運用」 が EmDash の立ち位置。とくに AI(Claude Code)から記事を書き・管理できる のは、このシリーズ(Claude Code × Cloudflare)と相性がよい。

WordPress からの移行もできる。WordPress の管理画面で書き出した引っ越しデータ(WXR ファイル)を、EmDash の管理画面の Import に読み込ませると、投稿・固定ページ・カテゴリ/タグ・著者が取り込まれる。画像は取り込みのあとに元のサイトからダウンロードされ、R2 のメディアライブラリに入る(要 R2 有効化。移行が終わるまで旧サイトは残しておく)。コメント・メニュー・サイト設定まで移したいときは、WordPress 側に専用のプラグイン(EmDash Exporter)を入れる方法もある(2026-10-14 時点の公式ドキュメント)。

運用の入り口は3つ(詳しくは「7. 運営の流れ」で)。

  • Web 管理画面から: ブラウザの管理画面(/_emdash/admin)で、記事を書き、コンテンツの型(スキーマ)やメディアを管理する。WordPress の管理画面に近い使い心地
  • Claude Code(CLI)から: 同梱の CLI を Claude Code が呼び出し、自然文の依頼で記事の作成・下書き・公開・画像アップまで行う。AI から運営するなら現時点はこれが手軽
  • MCP から: 内蔵の MCP サーバに Claude.ai などを繋いで、チャットで記事を書き・直し・公開する。プロジェクトのフォルダや CLI が無くても使える。画像のアップロードには向かない
  • 1.0 で安定版になった(2026-09-28)。中核のパッケージはセマンティックバージョニングに従うので、1.x の間は大きく壊れる変更は入らない建前。1.0 では beta の間に非推奨になっていた機能が消えた
  • プラグインまわりはまだ 0.x: 公式プラグインとプラグインの開発道具は、マイナーバージョンが上がるだけでも変わることがある
  • エコシステムが小さい: WordPress のような豊富なテーマ・プラグインはまだ無い

Cloudflare の 無料プランでも EmDash は動かせる。ただし大きな制約が1つある。プラグイン。

EmDash の中核機能は Cloudflare の無料枠で動く。

  • 記事の作成・公開、Web 管理画面、メディア管理、スキーマ(コンテンツの型)、メニュー、タクソノミなど、CMS の基本はひととおり無料
  • 使う Cloudflare サービスは Workers(実行)・D1(データベース)・R2(メディア)。いずれも個人ブログ規模なら無料枠で足りる

サイトの見た目(テーマ)も無料の範囲。EmDash のテーマ=最初に選んだテンプレート(中身は普通の Astro プロジェクト)で、レイアウトやページを Astro として自由にカスタマイズできる。ただし WordPress のような「管理画面でテーマをワンクリック着せ替え」「巨大なテーマストア」はまだ無く、別のテーマにしたいときは別テンプレートで作り直す形になる。

5-2. 有料が必要なこと(プラグインのサンドボックス)

Section titled “5-2. 有料が必要なこと(プラグインのサンドボックス)”

EmDash の プラグインは1つずつ Dynamic Worker という隔離環境(サンドボックス)で動く。これが EmDash のセキュリティの肝で、プラグインはマニフェストで宣言した権限しか使えない(=WordPress でプラグインが脆弱性の温床になりがちな問題への回答)。

ところが、この Dynamic Workers は有料アカウント(Workers Paid、月 $5〜)限定。つまり:

  • プラグインを使いたいなら有料
  • 無料で使うなら、プラグイン機能はオフのままにする。プラグインの正体は wrangler.jsonc の worker_loaders という設定で、今のテンプレートでは最初からコメントアウトされている(無料アカウントでもそのままデプロイできる)。中核機能はそのまま無料で使える

有料にしてプラグインを有効にすると、管理画面からプラグインを導入できる(インストール時に「このプラグインが何にアクセスできるか」の権限同意ダイアログが出る)。用意されているのはフォーム・SEO・埋め込み・Webhook 通知・監査ログ・AIモデレーション・WordPress 移行など、WordPress のプラグイン的なもの一通り。無料のままなら、これらは使わずコア機能だけで運用する割り切りになる。

ハマりどころ: プロジェクトを作るときにプラグインを有効にする(「Enable sandboxed plugins?」に Yes と答える)と、無料アカウントではデプロイの最後で「Dynamic Workers requires paid plan」(エラー 10195)が出て失敗する。2026-06 の beta のころはテンプレートの既定がこの状態で、何もしないと失敗していた。今は既定がオフなので、Yes にしなければ起きない。

メディア保存に使う R2 は無料枠があるものの、有効化の際に支払い方法(クレジットカード)の登録を求められることがある(Cloudflare の公式表記は「no credit card required」だが、実際にはカード登録を促される報告がある)。登録しても無料枠内なら課金されないが、カード登録に抵抗がある場合は念頭に置いておく。

6. 導入(インストール)の流れ

Section titled “6. 導入(インストール)の流れ”

ここからは実際に作る。プロジェクトを生成したら、すぐ Cloudflare に公開して本番で使い始める。WordPress と同じで、記事はローカルではなく本番の管理画面で下書き→公開していくので、ローカルで動かすのは任意(後述)。プロジェクトの作成からデプロイまで、Claudeデスクトップアプリの Claude Code に頼んで進める。作成とデプロイのためにターミナルのアプリを開く必要はない(ログインのときは、Claude Code がアプリの中にターミナルのタブを開く)。

まず、新しく作った空の作業フォルダ ~/claude/my-emdash-site を Claudeデスクトップアプリで開く。

フォルダ名は my-emdash-site にしておく。EmDash のテンプレートは、Cloudflare 側の名前(Worker 名と D1 のデータベース名)が my-emdash-site で入っているので、フォルダ名と揃って分かりやすい。

EmDash は Node.js 22.16 以上で動く。Node.js がまだなら、Wranglerハンズオンの1章で入れておく。

モデルは Sonnet 5.5 にしておく(入力欄の下の右端のボタンで選ぶ。→ Claudeデスクトップアプリの4-2)。EmDash は2026年4月に発表されたばかりで、それより前に出たモデルは知らないことがある。2026-10-26 のククデ会では、以前のモデルの Sonnet 5 のまま頼んだ人のところで、EmDash ではなく Astro のブログが作られた。

テンプレートは4つあり、作るときに1つ選ぶ。この記事ではブログを作るので Blog にする。作ったあとに管理画面で別のテンプレートへ切り替えることはできない(→ 5章のテーマの話)ので、作りたいサイトに近いものを選び、色やフォントなどの細かい見た目は Claude Code に頼んで直していく。テンプレートは、色・フォント・角の丸みを src/styles/theme.css にまとめて上書きできる作りになっている。

  • Blog:記事・固定ページ・カテゴリ/タグのあるブログ。デモサイトもこれ
  • Starter:デザインがほぼ無い、素の土台。見た目を一から作るとき
  • Marketing:会社や製品の紹介サイト。料金・問い合わせのページもある
  • Portfolio:作品を写真つきで並べる作品集

EmDash の4つのテンプレートの比較。上の段がトップページ、下の段が Blog の記事、Starter の記事、Marketing の料金、Portfolio の作品のページ

4つのテンプレートを、サンプルの中身を入れて手元で動かしたところ(2026-10-20、EmDash 1.3.1)。上がトップページ、下が記事・料金・作品のページ。公式にはデモのサイトが無い

あとは、何を作りたいかを伝える。

プロンプト
このフォルダに EmDash のブログを作って。
Cloudflare Workers で動かす前提で、テンプレートは Blog、パッケージマネージャは npm にして。

Claude Code は、フォルダの中身と Node.js のバージョン、EmDash の作成ツールの使い方を確かめてから、作成ツールを実行する。コマンドを実行するたびに許可を求められるので、内容を見て 一度だけ許可 を押す。許可は何度か求められる。

Claudeにrunを許可しますか、と聞く画面。コマンドは npm create emdash@latest . -- --template cloudflare:blog --pm npm --install --yes

EmDash の作成ツールを実行してよいかの確認

作成ツールはふつう質問に1つずつ答えていく対話形式だが、答えを引数で渡せば質問なしで進む。Claude Code はその形で実行する。. は「今のフォルダに作る」、--yes は「残りの質問は既定値で答える」の意味。プロジェクト一式の生成と依存関係のインストールまで、1分ほどで済む。

Claude Code の報告。Blog テンプレートを作成して依存関係のインストールまで済ませた、設定ファイルは wrangler.jsonc など、と書かれている

作り終えたときの Claude Code の報告

報告の中に、インストール時の警告(workerd と esbuild の postinstall が allowScripts に未登録)が出ることがある。2026-10-14 に試したときは、そのままでビルドも開発サーバーも動いた。報告の最後で、開発サーバーを起動して確かめるかを聞かれることもある。ブログを書くだけなら要らないので、起動しないと答えて 6-2 に進む(→ 6-4)。2026-10-26 のククデ会では、ローカルの開発サーバーの画面を本番の管理画面と思って、記事をそちらに書いていた人がいた。

できあがったフォルダには、次のようなものが入っている。

  • wrangler.jsonc:Cloudflare 向けの設定。D1(データベース)の DB、R2(メディア)の MEDIA が入っている。プラグイン用の worker_loaders は最初からコメントアウトされているので、無料アカウントのままデプロイできる(→「5. 無料でできる範囲」)
  • .env:暗号鍵 EMDASH_ENCRYPTION_KEY(.gitignore 済み)
  • AGENTS.md:AI エージェント向けの説明書。Claude Code は起動時にこれを読む。ただし、このフォルダに CLAUDE.md ができると、Claude Code は AGENTS.md を読まなくなる。自分のルールを足すときは AGENTS.md に書いてもらう(→ CLM 3)
  • .agents/skills/:EmDash 用のスキル3つ(サイトの作り方、プラグインの作り方、CLI の使い方)。.claude/skills はここへのリンク
  • .mcp.json:EmDash 公式ドキュメントを引ける MCP の設定

作り終えたら、同じフォルダで Claude Code のセッションを新しく開き直す。AGENTS.md・スキル・MCP の設定は、セッションを始めるときに読み込まれるため。開き直したセッションの Claude Code は EmDash を理解した状態で手伝ってくれる。

ターミナルで作る場合:自分のターミナルで cd ~/claude してから npm create emdash@latest を実行すると、質問に1つずつ答える形で作れる。プロジェクト名(my-emdash-site)、デプロイ先(Cloudflare Workers)、テンプレート(Blog)、パッケージマネージャ(npm)、依存関係のインストール(Yes)、プラグイン(No)と答えると、~/claude/my-emdash-site ができる。

以降も、ファイル編集やデプロイは Claude Code に任せ、ブラウザ操作が要る箇所だけ自分で行う。

まず Cloudflare にログインする。Wranglerハンズオンなど他の Cloudflare ハンズオンを済ませていれば、すでにログイン済みのはず。

プロンプト
npx wrangler で Cloudflare にログインしているか確認して

ログイン済みなら、Claude Code がアカウント名を教えてくれて終わり。ログインしていなければ、Claude Code に頼まず、自分のターミナルで npx wrangler login を打ち、ブラウザで開いた Cloudflare の画面で Authorize を押す。流れは Wranglerハンズオンの 1-2 と同じ。

また、メディアの保存に使う R2 は、先にダッシュボードで有効にしておく(有効にする前にデプロイすると「bucket … does not exist」で失敗する)。Cloudflare ダッシュボード(dash.cloudflare.com)の Storage & databases → R2 Object Storage → Overview で Add R2 subscription を押す。Due today は $0 で、毎月 10GB のストレージまで無料。支払い方法が未登録なら、カードの登録を求められる(→ 5-3)。カードを登録したくない場合は、wrangler.jsonc の R2 バインディングを外す(メディアのアップロードは使えなくなる)。

R2 を有効化(Add R2 subscription)

R2 の有効化画面。無料枠つき・Due today $0。「Add R2 subscription to my account」で有効化

R2 有効化完了

有効化完了($0/month)。このあとデプロイすれば R2 バケットが自動作成される

あとはデプロイ。これも Claude Code に頼める。

プロンプト
このサイトを Cloudflare にデプロイして。
終わったら、管理画面のセットアップの URL を教えて。URL は開かないで

Claude Code は npm run deploy を実行する(中身は astro build && wrangler deploy)。実行してよいか聞かれるので 一度だけ許可 を押す。

Claudeにrunを許可しますか、と聞く画面。コマンドは npm run deploy

デプロイしてよいかの確認

D1 のデータベース、R2 のバケット、KV(ログインの情報を置く場所)は、初回のデプロイで自動で作られる。R2 だけは、上のとおり先にアカウントで有効化しておく。Claude Code が「デプロイの前に D1 と R2 を作る必要がある」と言うことがあるが、2026-10-14 に試したときは、先に作らずにデプロイして、すべて自動で作られた。マイグレーションと初期データは初回アクセス時に入る。

Claude Code の報告。デプロイできました、URL、D1 と R2 は初回デプロイで自動作成された、と書かれている

デプロイが終わったときの報告。公開 URL と、自動で作られたものが書かれている

デプロイが終わったら、Claude Code が教えてくれたセットアップの URL(公開URLの /_emdash/admin、https://<自分のサイト>.workers.dev/_emdash/admin)を、ふだん使っている Chrome などのブラウザに貼って開き、すぐにセットアップする。最後に作るパスキーは、このブラウザに保存される。デプロイした直後は、URL を開いてもつながるまで少しかかることがある。つながらないときは、少し待ってから開き直す。

セットアップは、最初にこの画面を開いて進めた人が管理者になる。この URL は Claude Code に開かせない(6-2 のプロンプトの「URL は開かないで」はそのため)。2026-10-26 のククデ会では、Claudeデスクトップアプリの右側に出るブラウザ(アプリの中のブラウザ)で先に開いてしまい、あとから Chrome で開き直してもセットアップの画面が出なくなった人がいた。ほかの人が先に開いて進めた場合も、その人が管理者になる。そうなったときに元に戻す手順は、まだ確かめていない(管理者の情報はデータベースに入るので、デプロイし直すだけでは戻らない)。

独自ドメインで運用するつもりなら、先にドメインを設定する:セットアップの最後に作るパスキーは、そのときのアドレス(〇〇.workers.dev)に結びつき、別のドメインでは使えない。手順は独自ドメインの設定を参照。

ここからはこのデプロイ先(本番サイト)での操作。管理画面の UI はおおむね日本語(一部は英語のまま)で、ウィザードは3ステップ:

  1. サイト:サイトタイトル・キャッチフレーズを入力。How do you want to start? では Sample content を選んでおくと、見本の記事入りで始められる
  2. アカウント:メールアドレス・名前を入力
  3. ログイン:Create passkey でパスキーを作る(指紋・顔・PIN・Mac のパスワードなど)

セットアップウィザード ①サイト。サイトタイトル、キャッチフレーズ、How do you want to start? の3つの選択肢

① サイト:サイトタイトル・キャッチフレーズ・始め方(Sample content を選ぶ)

セットアップウィザード ②アカウント。メールアドレスと名前

② アカウント:メールアドレス・名前

セットアップウィザード ③ログイン。アカウントを保護、Create passkey のボタン

③ ログイン:Create passkey を押す

パスキーをどこに保存するかの画面は、使っているブラウザによって違う。Chrome なら Google パスワード マネージャー、Safari なら iCloud キーチェーンに保存される。

Chrome の画面。emdash-test.ytolabo.workers.dev にログインするパスキーを作成しますか、Touch ID で続行する

Chrome の場合。Touch ID で続行すると、Google パスワード マネージャーにパスキーが保存される

Passkey created と出たら Open the dashboard を押す。ログインの画面になるので、パスキーでログイン を押し、作ったパスキーでログインすると管理ダッシュボードに入れる。これで運用開始。パスキーは、あとから Security の設定で追加できる(別の Mac や iPhone から管理画面に入りたいとき)。

サイトにログイン。パスキーでログイン、メールリンクでログイン、言語の切り替え

作成したパスキーでログイン(メールリンクでのログインや言語の切り替えもここから)

EmDash 管理ダッシュボード。左にメニュー、右に下書き・メディアファイル・ユーザーの数と最近の更新

ログインすると管理ダッシュボード。サンプル記事も入っている(左下にバージョン v1.2.0)

暗号鍵について: .env の EMDASH_ENCRYPTION_KEY はローカル用。2026-06 と 2026-10-14 に試したときは、どちらもこの手順(デプロイ → セットアップ → パスキー → 記事の作成と公開)を、本番に鍵を登録しないまま終えられた。公式によると、この鍵はプラグインのシークレットを暗号化するのに使い、無くすと復号できなくなる。プラグインを使うなら、本番にもシークレットとして登録し、.env の値は別の場所にも控えておく(詳細は公式のCloudflare デプロイ手順)。

6-4.(任意)ローカルで動かすには

Section titled “6-4.(任意)ローカルで動かすには”

テンプレートやスキーマを手元で書き換えたい開発者向けの寄り道。ブログを書くだけなら不要。記事は本番の管理画面で下書き→公開していけばよい(次章)。

手元で動かすなら、Claude Code に開発サーバーの起動を頼む。

プロンプト
このフォルダで開発サーバーを起動してください。

(中身は npm run dev。)ブラウザで http://localhost:4321 を開けばローカルで確認できる(管理画面は /_emdash/admin。ローカルは認証不要で、CLI もトークン無しで通る)。

ここからは本番サイトで運営する(WordPress と同じく、本番の管理画面で下書き→確認→公開していく)。入り口は複数ある。Web 管理画面、Claude Code(CLI)、そして MCP。手元の PC から AI で運営するなら、CLI(7-2)が手軽でおすすめ(ローカル画像もそのまま上げられる)。MCP(7-3)は、Claude.ai のようにコマンドを打つ場所が無いところから使う。

/_emdash/admin を開き、サイドバーの Posts から新規作成(ダッシュボードの + Post からでもよい)。Title(タイトル)・Content(本文)をリッチテキストエディタで書き、必要なら Featured Image(アイキャッチ)やカテゴリ・タグを設定する。編集内容は自動保存され(「保存済み」表示)、右の 公開 パネルに今の状態(下書きなら Draft version)が出る。スラッグは URL & language の 識別名(スラッグ) で変えられる。右上の プレビュー で表示を確かめ、Publish now を押すとサイトに公開される。日時を決めて公開するなら 予約公開。公開すると、公開 パネルは Live version になり、右上のボタンは ライブビュー(サイトでの表示を開く)と Postを非公開にする に変わる。

EmDash の記事編集画面。左にエディタ、右に公開・URL & language・投稿者・分類グループ・SEO

記事の編集画面(7-2 で Claude Code に作らせた下書き)。左にエディタ、右に公開・スラッグ・投稿者・カテゴリ/タグ・SEO など。右上に プレビュー と Publish now

公開した記事「美味しいコーヒー」のサイト側の表示。トップ画像、タイトル、要約、本文、右に目次とカテゴリ

公開した記事(サイト側の表示。7-2 で Claude Code に作らせて公開したもの)。トップ画像・要約・本文が出て、右に見出しから作った目次が付く

記事以外にも、ビジュアルなスキーマビルダーでコンテンツの型(カスタム投稿タイプ)を定義したり、メディアライブラリに画像をドラッグ&ドロップしたり、メニューやタクソノミを管理したりできる。WordPress の管理画面に近い感覚。

7-2. Claude Code(CLI)で記事を書いて公開する

Section titled “7-2. Claude Code(CLI)で記事を書いて公開する”

このプロジェクトのフォルダで Claude Code を開くと、同梱の emdash-cli スキル(.claude/skills)が読み込まれるので、Claude Code は EmDash の CLI を理解した状態になる。あとは 自然文で頼むだけで、Claude Code が CLI を呼び出して記事を作成・下書き保存・公開まで やってくれる。

準備:本番サイトに一度だけログインしておく。 ログインは Claude Code に頼まず、自分のターミナルで打つ(→ WRG 1-2)。ターミナルは、Cmd + スペース で「ターミナル」と検索して開く。開いた場所(フォルダ)はどこでもよい。

Terminal window
npx emdash login --url https://my-emdash-site.〇〇.workers.dev

〇〇 には、自分の workers.dev のサブドメインが入る。6-2 のデプロイのあとに Claude Code が教えてくれた公開 URL(https://my-emdash-site.〇〇.workers.dev)を、そのまま使えばよい。分からなくなったら、Claude Code に「このサイトの公開 URL を教えて」と頼む。

ターミナルに、ブラウザで開く URL(…/_emdash/admin/device)とコード(XXXX-XXXX の形)が出て、「Waiting for authorization…」で待つ(初めてのときは、先に EmDash の CLI を取ってきてよいか聞かれることがある。y を打って Enter)。

ブラウザは自動では開かないので、URL を自分でブラウザで開き、デバイスコード にコードを入れる。求められる権限(管理者フルアクセス)が出るので、確かめて 承認 を押す。

デバイスを承認の画面。デバイスコードと、要求される権限(管理者フルアクセス)、承認と拒否のボタン

コードを入れると、要求される権限が出る。承認 を押す

デバイスを承認しました、と出た画面

「デバイスを承認しました」と出たら、ブラウザのページは閉じてよい

承認すると、ターミナルに「Logged in as (メールアドレス) (admin)」と出て、待ちが終わる。Claude Code に戻って、ログインできたか確かめてもらう。

プロンプト
EmDash の CLI で本番サイト https://my-emdash-site.〇〇.workers.dev にログインした。npx emdash whoami でログインできたか確かめて

認証情報は ~/.config/emdash/auth.json(ホーム配下・作業ディレクトリに依存しない)に保存され、期限が来ても自動更新されるので、一度やれば以降のセッションでも有効。

対話的な login を一切したくない/CI で回したいときは、API トークン方式。/_emdash/admin の 設定 → APIトークン → トークンを作成 で発行し(記事+画像なら コンテンツ読み取り/書き込み・メディア読み取り/書き込み の4スコープ)、EMDASH_TOKEN(永続させるなら ~/.zshrc に export)か --token で渡す。

準備ができたら、あとは自然文で頼むだけ。 以降のコマンドは本番サイト(ログイン先)に向く。

プロンプト
「Cloudflareで作るブログ」というタイトルで短い記事を書いて、下書きとして保存してください。

Claude Code は記事の中身を JSON のファイルに書き、npx emdash content create posts --file … --draft --url … を実行する(create は既定で即公開、--draft を付けると下書き。本文は Markdown で渡すと EmDash 側で Portable Text に変換される)。許可の画面には「Contains brace with quote character」という注意が出て、一度だけ許可 しか押せないことがある。

Claude Code の報告。下書きとして本番サイトに保存した、ID、スラッグ、内容

下書きを保存したときの報告

下書きは本番サイトの管理画面で確認でき(→ 7-1 の画面)、よければ「公開して」と頼めば公開される。日本語のタイトルだと、スラッグ(URL の一部)も日本語になる。英語にしたいときは「スラッグを cloudflare-blog に直して」のように頼む。

ローカル画像をトップ画像に使う、といった依頼もまとめてできる。

プロンプト
「美味しいコーヒー」というタイトルで短い記事を書いて、下書きとして保存してください。
~/Downloads/coffee.jpg をトップ画像(Featured Image)に使うので、いっしょにアップしてください。

Claude Code は ① npx emdash media upload ~/Downloads/coffee.jpg --alt "コーヒー" … で画像を上げて(メディアIDが返る)、② schema get posts でトップ画像のフィールド名(featured_image)と値の形を確かめ、③ そのメディアIDを featured_image に指定して npx emdash content create posts --draft … で下書きを作る。許可は何度か求められる(③はさきほどと同じく 一度だけ許可 のみ)。作業フォルダの外にある ~/Downloads の画像でも、別の許可は求められなかった。画像をローカルパスのまま渡せるのが CLI の強み。

Claude Code の報告。coffee.jpg をアップロードしてトップ画像に設定し、下書きで保存した

画像つきの下書きを保存したときの報告

「下書きで上げて」と言えば --draft、「公開して」なら content publish を Claude Code が使い分ける。書き込む先は --url で決まり、2026-10-14 に試したときは、Claude Code がログインした本番の URL を付けて実行した(ローカルの開発サーバーを動かしているなら、そちらは認証不要でそのまま操作できる)。

Claude Code が CLI で作成した下書き「美味しいコーヒー」の編集画面。Featured Image に coffee.jpg

Claude Code に CLI で作らせた下書き「美味しいコーヒー」を本番サイトの管理画面で確認したところ。Featured Image にアップした coffee.jpg が入り、本文は見出しつきで、右の 公開 は Draft version

作った下書きを直したいときも、Claude Code に頼むだけ。 タイトルで指して「こう直して」と言えば、CLI で対象を見つけて更新してくれる(裏では content get で今の内容とリビジョンを取り、content update で書き換える)。

プロンプト
下書きの「美味しいコーヒー」の本文に、淹れ方のコツをもう一段落足してください。下書きのままにしておいてください。

注意:content update は既定で「公開」してしまう。 下書きのままにしたいときは「下書きのまま」と伝える(Claude Code が --draft を付ける)。「直して公開して」と言えば、更新と公開を一度にやってくれる(2026-10-14 に試したときは、--draft を付けずに更新して、そのまま公開された)。

本文を直しても、要約(Excerpt。記事のページや一覧でタイトルの下に出る文)は別の欄なので変わらない。中身が変わる直しなら、要約もいっしょに頼む。

プロンプト
「美味しいコーヒー」の要約(Excerpt)も本文に合わせて直して、公開して

7-3. MCP で運営する(Claude.ai などから)

Section titled “7-3. MCP で運営する(Claude.ai などから)”

EmDash は記事を操作する MCP サーバも内蔵している(/_emdash/api/mcp。6-1 で設定が入る公式ドキュメント用の MCP とは別物)。Claude.ai のコネクタとして繋ぐと、プロジェクトのフォルダも CLI も無いところから、チャットで記事を書き・直し・公開できる。用意されているツールは72個で、記事の作成・更新・公開・予約公開、版の復元、カテゴリ/タグ、メニュー、サイト設定まで、CLI でできることはほぼそろっている(2026-10-20 にソースで数えた。EmDash 1.2.0 と 1.3.1 のどちらも同じ)。

使い分けは次のとおり(2026-10-20 に試した結果)。

  • 手元の PC で Claude Code を使うなら 7-2 の CLI。文章の操作は MCP でも CLI でも同じようにできた。画像は CLI でないと難しい(このあと説明する)
  • Claude.ai など、コマンドを打つ場所が無いところからは MCP。文章の作成・修正・公開に使う

Claude.ai の 設定 → コネクタ を開き、+ 追加 → カスタムコネクタを追加 を選ぶ。名前(コネクタの一覧に出る名前。例「EmDash サンプル」)と MCPサーバーURL を入れて 続ける を押す。URL はサイトの URL の後ろに /_emdash/api/mcp を付けたもの。

https://my-emdash-site.〇〇.workers.dev/_emdash/api/mcp

次の画面では、認証 の 今すぐサインイン と、OAuthクライアント の 自動的に登録 が「検出済み」で最初から選ばれている。そのまま 追加 を押す。

Claude.ai のカスタムコネクタを追加の画面。認証は今すぐサインイン、OAuthクライアントは自動的に登録が検出済みで選ばれている

サイトの設定を Claude.ai が読み取って、認証の方法を選んでくれる。そのまま 追加

連携の確認に進むと、ブラウザで EmDash の承認画面(Authorize Application)が開く。EmDash の管理画面にログインしていなければ、先にパスキーでログインする。求められる権限が並ぶので、確かめて Approve を押す。Claude.ai に戻り、コネクタの一覧にチェックマークが付けば繋がっている。

管理画面の設定にある API Tokens でトークンを作る必要はない。コネクタは、この承認の画面を通して繋がる。

EmDash の Authorize Application の画面。Signed in as と、Read content から Full administrative access までの権限が並び、Deny と Approve のボタン

EmDash の承認画面。権限は最初から全部にチェックが入っている

権限は最初から全部にチェックが入っていて、サイト全体の管理(Full administrative access)や、サイトの書き出し・取り込みまで含む。チェックを外せば絞れる。記事を書くだけなら要らないものもあるが、外したときの動きはまだ試していない。

新しいチャットで、コネクタの名前を挙げて頼む。

プロンプト
EmDash サンプルのコネクタを使って、文章だけの下書きを1件作って。
題は「Claude.ai から書いた記事」、中身はコーヒー豆の保存方法の短いメモにして。
まだ公開しないで。

Claude は記事の入れ物(posts)とその項目名を先に調べてから、下書きを作る。返事の「使用しました」を開くと、その順番が見える。見出しのある本文と要約(Excerpt)まで入った下書きが、本番サイトにできた。

Claude.ai のチャット。EmDash サンプルのツールを読み込み、posts のフィールドを確かめてから、Status: draft で作成した、と並んでいる

Claude.ai から下書きを作ったところ。入れ物の項目を確かめてから作っている

スラッグ(URL の一部)は題から自動で作られ、claudeai-から書いた記事 のように日本語が混ざった。英語にしたいときは「スラッグは英語にして」と添える。公開も「さっきの下書きを公開して」と頼めばよい(Claude Code から MCP で試したときは、15秒ほどで公開された)。

Claude Code から繋ぐときと、画像のこと

Section titled “Claude Code から繋ぐときと、画像のこと”

Claude Code からも繋げる。プロジェクトのフォルダで頼む。

プロンプト
このサイトの MCP サーバに、Claude Code から繋いで。
CLI ではなく、MCP で記事を操作できるようにしたい。

Claude Code は claude mcp add で .mcp.json に登録する。Claude Code を開き直すと、新しい MCP サーバを使ってよいか聞かれる。使うことにすると Claude Code が認証の URL を出すので、ブラウザで開いて上と同じ承認画面を通す(2026-10-20 にターミナルの Claude Code で試した。公式ドキュメントの接続手順に載っているのは Claude・ChatGPT・Codex で、Claude Code は載っていない)。

Claudeデスクトップアプリでは、ツールを使うたびに許可を求められ、渡す値が表で見える。

Claudeデスクトップアプリの許可の画面。content create を使ってよいか、Collection・Status・Slug・タイトル・アイキャッチ・本文・要約が表で並ぶ

Claudeデスクトップアプリで、MCP で下書きを作るときの許可の画面。何を送るのか確かめてから許可できる

画像を MCP で上げるのは、勧めない。 MCP の media_upload は、画像を文字(base64)にしたものを Claude が返事の中で書き写して送る。2026-10-20 に試したときは、Claude が写真を幅400px・約12KB まで縮めてから書き写したが、2分ほどかかったうえ、届いた画像は3バイト欠けて壊れていた(Claude が照らし合わせて気づき、消した)。画像は 7-2 の CLI で上げ、記事は MCP で作る、という分担なら通った。