Webharu CMS 開発者ドキュメント

Webharu CMSとは

Webharu CMSは、株式会社Web春が運営するサイト運用基盤のヘッドレスCMSです。ブラウザの記事エディタ（noteライクなWYSIWYG）に加えて、この開発者向けAPIとMCPサーバーを提供します。

• 公開まで全自動 — APIで status: "published" にした瞬間、サイトのビルド・デプロイが走り、数分で本番URLに反映されます（Git連携テナント）。Webhookの組み立てやCI設定は不要です。
• Markdownファースト — 本文は body_md（Markdown）だけ送ればOK。HTML変換はサーバー側で行います。
• AI最適化 — MCPサーバー同梱・llms.txt 提供・削除やレート等の安全設計込み。AIエージェントがそのまま運用に参加できます。
• エディタと同一パイプライン — API経由の操作もブラウザのエディタと同じ検証・履歴・監査ログを通ります。どちらで編集しても一貫します。

クイックスタート

APIキーを発行してから、最初の記事を公開するまでの最短手順です。

0. APIキーを発行する

マイページ（cms.webharu.com/my/）にログイン →「AIツール連携（APIキー）」→ 用途がわかる名前を入れて発行。 キーの値が表示されるのは発行時の一度だけです（サーバーにはハッシュのみ保存）。1サイトあたり5本まで発行でき、停止・削除も同じ画面からいつでもできます。

1. 接続を確認する

コピーcurl https://cms.webharu.com/api/ext/v1/me \
  -H "Authorization: Bearer whk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

コピーconst BASE = "https://cms.webharu.com/api/ext/v1";
const KEY = process.env.WEBHARU_API_KEY;

const res = await fetch(`${BASE}/me`, {
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(await res.json());

コピーimport os, requests

BASE = "https://cms.webharu.com/api/ext/v1"
KEY = os.environ["WEBHARU_API_KEY"]

r = requests.get(f"{BASE}/me", headers={"Authorization": f"Bearer {KEY}"})
print(r.json())

コピー// レスポンス
{
  "ok": true,
  "data": {
    "tenant_name": "あなたのサイト名",
    "site_url": "https://example.com",
    "collections": [{ "key": "news", "label": "お知らせ" }]
  }
}

2. 下書きを作る

コピーcurl -X POST "$BASE/posts" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "夏季休業のお知らせ",
    "body_md": "## 休業期間\n\n8月13日〜16日はお休みをいただきます。",
    "category": "お知らせ"
  }'

status を省略すると必ず下書き（draft）として作成されます。サイトには載りません。

3. 公開する

コピーcurl -X PUT "$BASE/posts/夏季休業記事のidまたはslug" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "published" }'

認証とAPIキー

すべてのリクエストに以下のヘッダーが必要です。

キーの性質

• キーはサイト（テナント）ごとに発行され、そのサイトのコンテンツだけを操作できます。
• サーバー側にはキーのハッシュのみ保存されます。値が見られるのは発行時の一度だけです。紛失した場合はマイページで削除して再発行してください。
• キーの停止・削除は即時に反映されます（停止後の全リクエストは 401）。
• すべての操作は監査ログに記録されます（いつ・どのキーが・何をしたか）。

コンテンツモデル

Webharu CMSのコンテンツは「記事（post）」です。記事は「コレクション」に属します（例: news = お知らせ、blog = ブログ）。使えるコレクションは GET /me で確認できます。

記事のフィールド

公開ステータスの遷移

公開中の記事を draft に戻すと、サイトからも取り下げられます。

エラーとレート制限

エラーは共通フォーマット { "error": "日本語のメッセージ" } で返ります。

レート制限

APIキーごとに 120リクエスト/分 です。超過すると 429 が返ります。バッチ処理は1秒に1〜2リクエスト程度に抑えるのが安全です。

MCPサーバー

MCP（Model Context Protocol）は、AIアシスタントに外部ツールを安全に接続するための標準プロトコルです。Webharu CMSはリモートMCPサーバーを同梱しており、Claude・Cursor等のAIから記事の作成・公開を直接指示できます。コードを書く必要はありません。

Claude Code（CLI）

コピーclaude mcp add --transport http webharu-cms \
  https://cms.webharu.com/mcp \
  --header "Authorization: Bearer whk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

登録後、Claudeに「サイトにお知らせを1本書いて下書きにして」のように話すだけで動きます。

Claude Desktop

設定 → コネクタ → 「カスタムコネクタを追加」で上記URLを入力し、ヘッダーに Authorization: Bearer whk_... を設定します。

Cursor / その他のMCPクライアント

コピー// mcp.json（Cursor: .cursor/mcp.json）
{
  "mcpServers": {
    "webharu-cms": {
      "url": "https://cms.webharu.com/mcp",
      "headers": { "Authorization": "Bearer whk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

MCPツールリファレンス

安全設計

• 既定は下書き — status を明示しない作成は必ず下書きになります。AIが会話の流れで勝手に公開することはありません。
• スコープはサイト単位 — キーは1サイト分の権限しか持ちません。他サイト・管理機能には一切アクセスできません。
• 全操作が監査ログに記録 — いつ・どのキーが・どの記事に何をしたかをサイト担当者が確認できます。
• 即時失効 — キーを停止すればその瞬間からすべての操作が拒否されます。

AIエージェントで導入する

このドキュメントの全文はAIが読み込みやすいプレーンテキストでも提供しています。AIエージェント（Claude Code等）に以下を渡すだけで、連携コードの実装やMCPセットアップを自動で行えます。

コピーhttps://cms.webharu.com/docs/llms-full.txt を読んで、
Webharu CMSとの連携をセットアップしてください。
APIキー: （発行されたキーを環境変数 WEBHARU_API_KEY に設定済み）
やりたいこと: （例）毎週月曜にブログ下書きを自動生成する

例えばこんな依頼がそのまま動きます:

• 「MCPで接続して、今公開中の記事一覧を見せて」
• 「この議事録を要約してお知らせ記事の下書きにして」
• 「予約投稿で来週月曜9時に公開される記事を作って」
• 「Webhookは無いので、RSS代わりに published 一覧をポーリングするスクリプトを書いて」

llms.txt

AI向けのドキュメントインデックスと全文を公開しています。

FAQ

Webhookはありますか？

ベータ版では未提供です。公開済み記事の検知は GET /posts?status=published のポーリング（数分間隔）で代替できます。要望が多ければ正式版で検討します。

記事の取得だけしたい（読み取り専用キー）

ベータ版のキーは読み書き両方の権限を持ちます。読み取り専用スコープは今後のロードマップにあります。取得だけの用途でも現状のキーをそのまま使えます。

body_htmlを直接送ってもいい？

可能ですが推奨しません。body_md だけ送る方が、エディタとの相互編集・将来のデザイン変更に強くなります。

予約公開の精度は？

5分間隔のスケジューラが処理するため、指定時刻から最大5分程度の遅延があります。

1つのキーを複数のツールで使い回してもいい？

動作はしますが、ツールごとにキーを分けることを推奨します（監査ログでの区別・漏えい時に該当ツールだけ止められるため）。マイページから5本まで発行できます。

料金は？

ベータ期間中、契約クライアントは追加費用なしで利用できます。

変更履歴