REST APIとMCP連携
WordPressをMCPサーバーにして、ClaudeやCursorから記事を作る・読む・直す・予約する。順位や目標の数字、サイトの情報、診断・AI推奨の結果、SNSの予約、問い合わせも。鍵ごとに権限・期限・回数の上限。claude.ai・ChatGPT からは鍵なしで(OAuth)。REST APIとAbilities APIも
WordPressがMCPサーバーになります
Pro版かクラウド版(無料のお試しを含む)を入れると、このWordPressはMCPサーバーとして動きます。Claude Code・Claude Desktop・Cursor などのMCPクライアントにURLと鍵を登録するだけで、「◯◯というキーワードで記事を作って」「先週作った記事を読んで要約して」と頼めます。追加のソフトやNode.jsのラッパーは要りません。
MCPの口は次の1本です(形式は Streamable HTTP。JSON-RPC を POST で受けます)。
https://あなたのサイト/wp-json/sorabun/v1/mcp
claude.ai や ChatGPT のコネクターのように、鍵を貼る欄の無いクライアントからは、この URL だけで、鍵を作らずにつなげます(claude.ai・ChatGPT から鍵なしでつなぐ(OAuth))。
鍵を作る
MCPクライアントやREST APIから使うには、まず鍵を作ります。
- 「Sorabun > 設定 > REST API / MCP連携」 を開きます
- 「新しい鍵を作る」 で、名前(どこで使うか。例: 自分のPCの Claude Code)・記事の権限・記事のほかの権限(すでにある記事の直し・セキュリティの状態・数字・SNS の予約・問い合わせ)・期限を選びます
- 「鍵を作る」 を押します。画面の上に鍵(
sbk_で始まる文字列)が出ます
Sorabun は鍵そのものを置かず、照合用の値(サイトの秘密を混ぜたハッシュ)だけを置きます。画面を開き直すと、もう見られません。すぐに MCP クライアントや 1Password などに写してください。無くしたときは、一覧で取り消して作り直します。
使う場所ごとに鍵を分けておくと、どこかで漏れたときに、その鍵だけを取り消せます。一覧には、名前・鍵の頭(sbk_1a2b3c4d… のように、どの設定ファイルの鍵か見分けるための部分)・権限・期限・最後に使った日・作った日と作った人が出ます。
権限
鍵ごとに、できることを選びます。記事の権限は3段で、上の段は下の段のこともできます。
| 権限 | できること |
|---|---|
| 公開済みの記事を読む | 公開済みの記事の一覧と本文、サイトの情報(list_posts / get_post / site_info)。訪問者に見えるものだけで、下書き・予約・非公開・パスワードつきは読めず、有料記事・LINE限定記事は無料の部分だけ |
| 下書きを作る | 上に加えて、記事の作成・リライト・URLから記事(下書きで)、ジョブの進み具合(create_article / rewrite_article / article_from_url / get_job / list_jobs)、下書きを直す(update_post)。見えるジョブと下書き、直せる下書きは、この鍵で作ったものだけ |
| 公開する | 上に加えて、公開まで頼める(post_status に publish)。すべての記事・ジョブを読める(前の版の鍵と同じ) |
記事の権限のほかに、次の権限を、鍵ごとに1つずつ付けられます。どれも既定では付いていません。
| 権限 | できること |
|---|---|
| すでにある記事とサイトの情報を直す・公開の日時を決める | 公開中・予約・非公開の記事と、この鍵で作っていない下書きを直す(update_post)、公開の日時を決める・予約を外す(schedule_post / unschedule_post)、サイトの情報を直す(update_site_profile)。「公開する」と一緒に付けます |
| セキュリティの状態を読む | security_status(下を参照) |
| 順位・目標などの数字を読む | 順位チェックの結果・目標(KPI)と進み具合・Search Console の要約・記事のアイデア(list_rankings / list_kpis / search_console_summary / list_article_ideas / refresh_article_ideas)。サイトの情報・テクニカル診断・リンク切れ・AI推奨・AI引用の結果と、Search Console の新しい検索語・あと少しの語(get_site_profile / get_technical_audit / list_broken_links / get_ai_recommendations / list_ai_citations / search_console_queries)。目標には、有料記事の売上や問い合わせの件数も入ります |
| SNS の予約 | X への投稿の予約を読む・足す・取り消す(list_social_posts / schedule_social_post / cancel_social_post)。管理者だけが付けられます |
| 問い合わせを読む | 届いた問い合わせの一覧と中身(list_inquiries / get_inquiry)。訪問者の名前・メールアドレス・本文を読めます。管理者だけが付けられます |
MCPクライアントには、その鍵で使えるツールだけが見えます。権限の足りない呼び出しは、HTTP 403 で断ります。
SNS に出したものは取り消せず、フォロワーにすぐ届き、サイトではなく、あなたのアカウントの名前で出ます。記事を公開してよい相手が、SNS で話してよいとは限りません(逆も同じです)。「公開する」の上の段にすると、SNS だけを任せたい AI にも記事の公開まで渡すことになるので、別の権限にしました。さらに、AI が足した SNS の予約は、「SNS自動投稿」の設定(作った下書きを確認せずに予約に入れるか。既定は確認する)どおり、人が承認してから送ります。
リライトは、下書きを作る鍵でも頼めますが、全文を読めない記事(有料記事・LINE限定記事・パスワードつき・ほかの人の下書き・予約)は頼めません。書き直しを通して、読めないはずの中身が読めてしまうためです。
期限
30日・90日・1年・無期限から選びます。期限が切れた鍵は 401 で断ります。期限の14日前から、Sorabun の画面の上でお知らせします。新しい鍵を作って差し替え、古い鍵を取り消してください。
回数の上限
1つの鍵で、1時間に600回まで、記事の作成(AIの費用がかかるもの: キーワード・URLから記事・リライト)は 1日に50本まで です。超えると HTTP 429 と Retry-After(待つ秒数)を返します。1日の数え直しは、サイトのタイムゾーンの0時です。
600回は、AIが進み具合を30〜60秒おきに確かめながら10本を同時に作っても余る回数で、暴走したエージェントが叩き続けるのを止めるための線です。50本は、一括作成で一度に頼める本数と同じです。開発者の方は、フィルター sorabun_api_key_limits で変えられます。
記録
鍵で通った呼び出しは、操作ログ の「APIの鍵」に残ります(鍵の名前・呼んだツールかルート・結果・記事やジョブのID)。キーワードや追加の指示などの中身、記事の本文、鍵の値は残しません。同じものの読み取り(30秒おきの進み具合の確かめなど)は、10分ごとに1行にまとめて回数を数えます。
鍵違い・期限切れ・権限不足・回数の上限で断った呼び出しも残します(総当たりで操作ログが埋まらないよう、10分ごとに1行にまとめます)。鍵を作った・取り消したことも、操作した人つきで残ります。
以前の鍵(前の版から更新したサイト)
前の版の鍵は1本で、何でもできました。更新しても MCP の設定や自動化が止まらないよう、前の鍵は 「以前の鍵」 として、記事の全部の権限・無期限のまま移してあります(前の版で「MCPから、セキュリティの状態を読めるようにする」をオンにしていたサイトでは、セキュリティの状態も読めます)。移すときにハッシュへ置き換えたので、前の版のように鍵の値を表示することは、もうできません。
あとから足した権限(すでにある記事の直し・数字・SNS の予約・問い合わせ)は、「以前の鍵」にも、前の版で作った鍵にも付けていません。更新しただけで、前はできなかったことができるようにはしません。要るときは、その権限を付けた鍵を新しく作ってください。
使う場所ごとに必要な権限と期限だけの鍵を作り、設定を差し替えたら、「以前の鍵」を取り消してください。
鍵の照合には、wp-config.php のソルト(AUTH_KEY・AUTH_SALT)を使います。引っ越しやソルトの作り直しで変わると、作った鍵はどれも照合できなくなり、一覧に「使えません」と出ます。鍵を作り直してください(ほかの外部サービスのAPIキーも、同じ理由で入れ直しが要ります)。
MCPクライアントに登録する
Claude Code
claude mcp add --transport http sorabun "https://あなたのサイト/wp-json/sorabun/v1/mcp" \
--header "Authorization: Bearer <作った鍵>"
Cursor / Windsurf / VS Code(URLとヘッダーを書ける設定ファイルの場合)
{
"mcpServers": {
"sorabun": {
"url": "https://あなたのサイト/wp-json/sorabun/v1/mcp",
"headers": { "Authorization": "Bearer <作った鍵>" }
}
}
}
Claude Desktop(設定画面からヘッダーを付けられないクライアントは mcp-remote 経由。Node.js 18以上)
{
"mcpServers": {
"sorabun": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://あなたのサイト/wp-json/sorabun/v1/mcp",
"--header", "Authorization: Bearer <作った鍵>"]
}
}
}
<作った鍵> のところに、作った鍵を入れます。鍵を作った直後の画面では、この例にも実物の鍵が入った形で出ます(開き直すと消えます)。
鍵を設定ファイルにそのまま書きたくないときは、1Password に置いて起動のときだけ渡せます(1Password と使う)。
MCPクライアントを使わずに、ブラウザのマイページから記事の下書きや検査を頼むこともできます(マイページ(Web版)でサイトを見る・頼む)。マイページはライセンスでつなぐ別の仕組みで、ここの鍵は使いません。
どんなツールが使える?
| ツール | すること | 要る権限 |
|---|---|---|
create_article | キーワードから記事を作る。job_id をすぐ返す | 下書きを作る(公開まで頼むなら、公開する) |
rewrite_article | 既存記事をリライトする。結果は下書きで保存 | 下書きを作る |
article_from_url | URLまたはYouTube動画から記事を作る | 下書きを作る(公開まで頼むなら、公開する) |
get_job / list_jobs | 生成の進捗を見る | 下書きを作る |
list_posts / get_post | 記事の一覧と本文を読む(本文は2万字まで) | 公開済みの記事を読む |
site_info | サイト名・版・生成の既定値・Sorabunで作った記事数 | 公開済みの記事を読む |
update_post | 記事の題名・本文・抜粋を直す。直す前の姿はリビジョンに残す | 下書きを作る(この鍵で作った下書きだけ)。ほかの記事は、すでにある記事とサイトの情報を直す・公開の日時を決める(と、公開する) |
schedule_post / unschedule_post | 記事の公開の日時を決める(予約投稿)・予約を外して下書きに戻す | すでにある記事とサイトの情報を直す・公開の日時を決める(と、公開する) |
security_status | セキュリティの状態を読む(下を参照) | セキュリティの状態を読む |
list_rankings | 順位チェックの結果(キーワードごとの順位・前回・最高・推移・AIによる概要に引用されたか・Search Console の数字) | 順位・目標などの数字を読む |
list_kpis | 目標(KPI)ごとの、いまの値・進み具合・期間の終わりの見込み・状態 | 順位・目標などの数字を読む |
search_console_summary | Search Console のクリック・表示回数・クリック率・平均の掲載順位(直近の期間とその前) | 順位・目標などの数字を読む |
list_article_ideas / refresh_article_ideas | 記事のアイデアを読む・作り直す(作り直しは1日1回まで) | 順位・目標などの数字を読む |
get_site_profile | サイトの情報(サイト診断の欄・主要ページ・競合・調査の記録)を読む | 順位・目標などの数字を読む |
update_site_profile | サイトの情報を直す(全部が通るか、何も変えないか) | すでにある記事とサイトの情報を直す・公開の日時を決める(と、公開する) |
get_technical_audit | テクニカル診断の最後の結果と、表示速度(Core Web Vitals) | 順位・目標などの数字を読む |
list_broken_links | リンクチェックが見つけた切れたリンク・転送・要確認のリンク | 順位・目標などの数字を読む |
get_ai_recommendations | AI推奨(LLMO)の最後の計測の結果 | 順位・目標などの数字を読む |
list_ai_citations | AI引用チェックの、キーワードごとの結果 | 順位・目標などの数字を読む |
search_console_queries | Search Console の、新しく出てきた検索語と、あと少しの語 | 順位・目標などの数字を読む |
list_social_posts / schedule_social_post / cancel_social_post | X への投稿の予約を読む・足す・取り消す | SNS の予約 |
list_inquiries / get_inquiry | 問い合わせの一覧(件名と日付)と、1件の中身 | 問い合わせを読む |
get_post は、公開する権限の無い鍵には、訪問者に見えるものだけを返します。有料記事・LINE限定記事は無料の部分だけで、restricted に paywall か line が入ります。
記事を作る3つのツールでは、記事ごとに作り方を指定できます。指定しなかった項目は「設定」の値が使われます。
| 項目 | 内容 | create_article | rewrite_article | article_from_url |
|---|---|---|---|---|
length | 文字数(0〜20000)。0はAIが検索意図から決める | 省略時はサイトの既定 | 省略時はサイトの既定 | 省略時はAIが元に合わせる |
tone | 文体(desumasu / dearu / casual) | ○ | ○ | ○ |
diagrams | 図解の数(0〜5。-1はAIが必要な箇所だけ) | ○ | ○ | ○ |
eyecatch | アイキャッチ画像を作るか | ○ | 今の画像を残す | ○ |
custom_prompt | その記事だけの追加の指示(2000字まで) | ○ | ○ | ○ |
文字数は構成を作るときの目安で、ぴったりその字数にはなりません。「約6000字で」「です・ます調で、図解は入れずに」のように頼めば、AIがこれらの項目に直して渡します。
記事生成は非同期です。ツールは job_id をすぐ返し、記事は数分かけて出来上がります。サーバー側からAIに「get_job を30〜60秒おきに確認する」「頼まれない限り公開ではなく下書きにする」と伝えてあるので、ふつうは何も指示しなくてもそのとおり動きます。
MCP経由でできるのは、上のツールのうち、鍵の権限で許したものだけです。設定の変更・記事の削除・鍵の操作はできません。記事を公開に進められるのは、create_article と article_from_url の post_status と、schedule_post(予約)だけで、どれも「公開する」の権限が要ります(schedule_post は「すでにある記事とサイトの情報を直す・公開の日時を決める」も)。既定は下書きです。
記事を直す・予約する(update_post / schedule_post / unschedule_post)
update_post は、記事の題名(title)・本文(content、HTML)・抜粋(excerpt)のうち、渡したものだけを直します。本文は全体を置き換えるので、AI はまず get_post(format に html)で読んでから直します。
- 直す前の姿は、WordPress のリビジョンに残します(
revision_id)。管理画面の「リビジョン」から、元に戻せます。リビジョンを止めているサイトでは、公開中・予約・非公開の記事は直しません(元に戻せないため。下書きは直せます) - 鍵で直せるのは、その鍵で作った下書き(とレビュー待ち)だけです。公開中・予約・非公開の記事と、管理画面やほかの鍵で作った下書きを直すには、「すでにある記事とサイトの情報を直す・公開の日時を決める」の権限(「公開する」と一緒に付けます)が要ります。前の版の「公開する」の鍵と「以前の鍵」には、この権限を付けていません(前は、すでにある記事に好きな本文を書き込めなかったため)
- 本文が2万字を超える記事は、本文の置き換えを断ります。
get_postが本文を2万字で切って返すため、そのまま書き戻すと後ろが消えるからです。題名と抜粋は直せます - だれかが管理画面の編集画面で開いている記事は、直しません(あとから人の保存で、どちらかの直しが消えるため)
schedule_post は、下書き・レビュー待ち・予約中の記事を、決めた日時に公開する予約投稿にします(「すでにある記事とサイトの情報を直す・公開の日時を決める」と「公開する」の権限が要ります)。日時(publish_at)は、サイトの時刻で 2026-12-01 09:00 のように、または時差つきの ISO 8601 で渡します。いまより1分以上先でないと断ります(WordPress は、過ぎた日時の予約を、その場の公開に変えるため)。記事を作るときの公開と同じく、次の記事は予約しません。
- 品質検証の途中の記事と、品質検証で公開を止めた記事
- 本文に、人の手が要る指示(撮影スロットや作業の指示)が残っている記事
公開中の記事を予約し直すことはできません(公開を止めるのは管理画面から)。unschedule_post は、予約中の記事を下書きに戻します。
数字を読む(順位・目標・Search Console・記事のアイデア・診断・AI推奨・AI引用)
鍵に 「順位・目標などの数字を読む」 を付けると、「先月より順位は上がった?」「今月の目標に届きそう?」と聞けるようになります。
list_rankings: 順位チェック の結果。記事の ID は、訪問者に見える記事のときだけ返しますlist_kpis: 目標とレポート の目標ごとの進み具合(画面と同じ数え方)search_console_summary: Sorabun が毎日 Site Kit から控えた Search Console の数字を足したものです。Google には聞きに行かないので、直近の2〜3日は入っていないことがありますlist_article_ideas/refresh_article_ideas: 「SEOインサイト」の、次に書く記事のアイデア。作り直しは AI と検索の費用がかかるので、鍵からは1日1回までです(それより新しいときは、保存してあるものを返します)get_technical_audit: テクニカル診断 の最後の結果(項目ごとの判定・説明・関係する記事の ID)と、トップページの表示速度。診断し直しはしませんlist_broken_links: リンクチェック の結果。切れたリンク(broken)・転送(redirect)・要確認(warning)を選べます。開き直しはしませんget_ai_recommendations: AI推奨(LLMO) の最後の計測の結果(推奨された割合と幅・AI ごと・比べた基準・ほかに推奨された名前・出典・引用された自サイトのページ・根拠の照らし合わせ・推移・問いごとの数)。答えの本文は返しませんlist_ai_citations: AI引用チェック のキーワードごとの結果(AI ごとの印・出典のホスト・推移)search_console_queries: 「SEOインサイト」の 新しく出てきた検索語とあと少しの語。結果は1日控え、古ければ Site Kit から取り直します(Search Console の API は無料)。鍵からは、Site Kit を接続した管理者として読みます
どれも読むだけです。お金のかかる実行(AI推奨を今すぐ測る・AI引用を調べる)のツールはありません。Gemini と ChatGPT への質問は、選んでいるモデルで単価が変わり、Sorabun は1回の費用の目安を持っていないため、「上限額を決めて実行する」を約束できないからです。測るのは管理画面からです。
記事の ID と題名は、訪問者に見える記事(公開中・パスワードなし)のときだけ返します。リンク切れも、訪問者に見える記事で使っているものだけです(「公開する」の鍵には、全部を返します)。
サイトの情報を読む・直す(get_site_profile / update_site_profile)
サイト診断 で書いたサイトのこと(テーマ・読者・地域・狙い・目標・扱わない話題)と、主要ページ・競合・調査の記録 を、AI が読み書きできます。SEO の作業の前に読ませると、あなたがすでに Sorabun に伝えたことを踏まえて動き、調査の記録を見て、同じ調べもの(費用のかかるもの)をくり返さなくなります。
- 読む(
get_site_profile)には 「順位・目標などの数字を読む」 が要ります。競合や調べたことは、サイトの外に出していない運営の情報なので、「公開済みの記事を読む」の鍵には見せません - 直す(
update_site_profile)には 「すでにある記事とサイトの情報を直す・公開の日時を決める」(と「公開する」)が要ります。サイトの情報と主要ページは、これから書く記事の全部に渡るので、すでにある記事を直すのと同じ重さの権限にしました - 1回で、欄(
fields)・主要ページ・競合・調査の記録をまとめて直せます。全部が通るか、何も変えないか のどちらかで、駄目な変更があれば、何番目の何が駄目かを返します - 主要ページは URL で、競合はドメインで、同じものを見分けます(http と https、www、末尾の / の違いは同じページ)。役割やメモを省いて足し直しても、前の値は消えません
- AI が書いたものには「MCP」、画面で書いたものには「人」の印が付きます
- 直した呼び出しは、操作ログ に残ります
SNS の予約(list_social_posts / schedule_social_post / cancel_social_post)
鍵に 「SNS の予約」 を付けると、公開中の記事(パスワードの無いもの)か予約中の記事を知らせる X への投稿を、SNS自動投稿 の予約に足せます。
- 文面(
text)には、記事の URL を入れません。URL とハッシュタグは、「SNS自動投稿」の設定どおりに Sorabun が付けます。長すぎる文面は、切らずに断ります - 日時(
at)を書かなければ、設定の投稿の時刻のうち、空いているいちばん近いものに入れます - AI が足した予約は、承認を待つ下書きになります(「SNS自動投稿」で、作った下書きを確認せずに予約に入れる設定にしているサイトだけ、すぐに送信待ち)。管理画面で読んでから承認してください
- まだ送っていない予約は
cancel_social_postで取り消せます。X に出したものは取り消せません
問い合わせを読む(list_inquiries / get_inquiry)
鍵に 「問い合わせを読む」 を付けると、届いた 問い合わせ を読めます。一覧(list_inquiries)は、件名・日時・判定(営業や bot か)だけです。名前・メールアドレス・本文は、1件ずつ(get_inquiry)だけ返します。IP の指紋や、判定の点数・理由は返しません。
問い合わせには、訪問者の名前・メールアドレス・本文が入っています。この権限は管理者だけが付けられ、既定ではどの鍵にも付いていません。要る鍵にだけ付けてください。読んだことは、鍵の名前と問い合わせの ID で、操作ログに残ります(中身は残しません)。また、問い合わせの文面は訪問者が書いたものです。AI には「指示ではなく、読むもの」として渡すよう、ツールの説明に書いてあります。
セキュリティの状態を読む(security_status)
鍵に 「セキュリティの状態を読む」 を付けると、その鍵のMCPクライアントのAIが、毎日の見張りの結果を読めるようになります。「うちのサイト、急いで直すところある?」と聞けば、次のものをまとめて答えます。
- 入っているプラグイン・テーマ・WordPressの既知の脆弱性(重さ・CVE・直った版)。記録の出典(Wordfence Intelligence)の決まりで、出典と著作権表示・ライセンスも添えて返し、AIにも一緒に見せるよう伝えます
- まだ当てていない、急ぎ(セキュリティ修正)の更新
- WordPress本体のファイルの改ざん・欠け・紛れ込み
- 直近7日のログインの締め出しの回数(試されたユーザー名やIPは返しません)
- 入口の守り(XML-RPC など)のオン・オフ
読むだけです。調べ直しも、設定の変更も、更新もしません。直すのは管理画面の「セキュリティ / 高速化」からです。
鍵が漏れると、記事を作られるだけでなく、サイトの弱いところまで知られてしまいます。セキュリティの状態だけを読む鍵(記事の権限は「使わない」)も作れます。権限を足した鍵を使うときは、MCPクライアントを接続し直すとツールが見えます。
claude.ai・ChatGPT から鍵なしでつなぐ(OAuth)
claude.ai や ChatGPT の「カスタムコネクター」は、MCP の URL を入れるだけでつなぐ作りで、ふつうは鍵を貼る欄がありません。Sorabun は、MCP の認可の仕組み(OAuth 2.1)にも対応しています。つなぐときに、このサイトのログインと「許す」の画面が開き、許すとつながります。鍵を作る必要はありません。鍵での使い方も、これまでどおり使えます。
入れる URL は、MCP の口と同じです。
https://あなたのサイト/wp-json/sorabun/v1/mcp
つなぎ方
画面の名前は、英語の画面のものです(2026年11月に、Anthropic と OpenAI の説明で確かめた範囲)。
claude.ai(Free・Pro・Max)
- Customize > Connectors を開き、Add から Add custom connector を選びます
- 名前と、上の URL を入れて Continue を押します
- 認証の設定は、Claude が読み取って Detected と出たものをそのまま使い、Add を押します
- Connect を押すと、このサイトのログインと「許す」の画面が開きます
Team・Enterprise では、Owner が Organization settings > Connectors で Add から Custom を選んで足し、各自が Customize > Connectors で Connect します。
ChatGPT
- ChatGPT Plugins(chatgpt.com/plugins)を開き、+ から Add custom MCP server を選びます
- 名前と説明を入れ、Connection に上の URL を入れます
- 認証を選び、注意を読んで I understand and want to continue を押し、Create as a plugin を押します
使えるプランやワークスペースの決まりは、OpenAI の説明をご確認ください。
Claude Code
claude mcp add --transport http sorabun "https://あなたのサイト/wp-json/sorabun/v1/mcp"
見出し(--header)は付けません。足したら、Claude Code の中で /mcp を開いて認証します。
claude.ai・ChatGPT は、https のサイトにしかつなげません。また、Anthropic・OpenAI の側からつなぐので、手元のパソコンの中だけで動いているサイトにはつなげません(Claude Code は手元からつなぐので、http://127.0.0.1 のサイトでも試せます)。
許可の画面
ログインしていなければ、まずログインの画面が出ます。ログインすると、次のものを出します。
- アプリの名乗り: アプリの情報の置き場所(Client ID Metadata Document)があれば、その場所も出します(claude.ai・chatgpt.com など)。動的な登録のアプリの名前は、アプリが自分で名乗ったもので、確かめようがありません
- 許したあとに戻る先: claude.ai・chatgpt.com などの場所を、大きく出します。名前ではなく、ここで見分けてください。戻る先がこのパソコンの中(127.0.0.1・localhost)のときは、注意も出します
- だれとして動くか: ログインしている人
- 許す権限: 鍵と同じ4つ。アプリが求めた権限に、はじめから印が付いています。外した権限は許しません
- 期限: 30日・90日・1年
許せる権限は、その人の WordPress の権限の範囲までです。
| 権限 | 許せる人(WordPress の権限) |
|---|---|
| 公開済みの記事を読む | ログインできる人(read) |
| 下書きを作る | 寄稿者以上(edit_posts) |
| 公開する | 編集者・管理者(publish_posts と edit_others_posts。公開できる鍵は、ほかの人の下書きも含めて、すべての記事を読めるため) |
| セキュリティの状態を読む | 管理者(manage_options) |
鍵の権限に、ほかの権限が足されているときも、許せる人は鍵と同じ線で決まります(管理者だけが鍵に付けられる権限は、OAuth でも管理者だけ)。すでにある記事を直す権限は、「公開する」と一緒にだけ許せます。アプリが求めていない権限には、はじめから印を付けません。
許したあとに、その人の WordPress の権限が下がると、つながりの権限も下がります。その人のユーザーを消すと、つながりは止まります。
claude.ai は、はじめは「公開済みの記事を読む」と「下書きを作る」を求めます。あとで公開を頼まれると、claude.ai が許可をもう一度求めます(許可の画面で、はじめから「公開する」に印を付けておくこともできます)。
トークンと期限
- アクセストークンは1時間で切れ、アプリが自分で入れ替えます(リフレッシュトークン)
- リフレッシュトークンは、使うたびに新しいものに入れ替えます。入れ替えたあとの古いものが使われたら、盗まれた恐れがあるので、そのつながりのトークンを全部止めます(操作ログ に「OAuth のつながりを止めた(盗まれた恐れ)」と残ります)。認可コードの使い回しも同じです
- 使わない日が30日続くか、許すときに選んだ期限が来ると、つながりは切れます。つなぎ直すには、もう一度「許す」を押します
- 同じアプリを同じ人がつなぎ直すと、前のつながりは新しいものに入れ替わります
- トークンは、MCP の口でだけ使えます(REST API の
/articlesなどには使えません) - つないだあとは、鍵と同じ扱いです。1つのつながりで1時間に600回、記事の作成は1日に50本まで。呼び出しは操作ログの「APIの鍵」に、「OAuth「アプリ(人)」」の名前で残ります
- Sorabun は、トークンと認可コードの値を置きません。置くのは、サイトの秘密を混ぜたハッシュだけです
つながっているアプリと取り消し
「Sorabun > 設定 > REST API / MCP連携」 の つながっているアプリ に、アプリ・許した人・権限・最後に使った日・期限が並びます。つながりを取り消す を押すと、そのアプリはすぐに使えなくなります。管理者でない人も、自分が許したものは、プロフィールの画面の「Sorabun: つながっているアプリ(OAuth)」で取り消せます。
OAuth でのつなぎ全体を止めるときは、同じ欄の 止める を押します。OAuth でつないだアプリは使えなくなります(つながりは残り、使う に戻すと、また使えます)。鍵での使い方は止まりません。
つながらないとき(/.well-known/ が届かない)
claude.ai・ChatGPT は、https://あなたのサイト/.well-known/oauth-authorization-server を読んで、つなぎ方を知ります(仕様で、この場所に決まっています)。設定の欄に 届いています と出ていれば大丈夫です。届いていません と出たら:
- パーマリンクが「基本」なら、「設定 > パーマリンク設定」で「基本」以外にします
- WordPress をサブディレクトリ(
https://example.com/blog/など)に置いているときは、サイトのいちばん上(https://example.com/)が WordPress ではないため、そのままでは届きません。サーバーの設定で、/.well-known/oauth-で始まる要求を WordPress のindex.phpへ渡してください。設定の欄に、そのサイト用の書き方の例(Apache・nginx)が出ます
もう1つの情報(保護されたリソースの情報)は、MCP の口が鍵なしの呼び出しに 401 を返すとき、見出し(WWW-Authenticate)で REST の場所(/wp-json/sorabun/v1/oauth/protected-resource)を知らせるので、/.well-known/ が届かなくても読めます。
MCP の認可の仕様(2026-07-28 版。2025-11-25 版のクライアントにも合わせています)に合わせています。アプリの登録は、Client ID Metadata Document(client_id が https の URL。claude.ai と ChatGPT はこちらを先に使います)と、動的な登録(RFC 7591)の両方に対応しています。PKCE は S256 だけ、戻る先は https か、この端末の中(127.0.0.1・localhost)だけです。独自の形の戻る先(cursor:// など)を使うクライアントは、鍵でつないでください。
REST APIとしても呼べます
同じ鍵で、ZapierやMake、自作スクリプトからも記事生成を実行できます。
認証
作った鍵を、リクエストヘッダーに付けます(Authorization: Bearer <作った鍵> でも通ります)。
X-Sorabun-Key: <作った鍵>
エンドポイント
| メソッド | パス | 用途 | 要る権限 |
|---|---|---|---|
| POST | /wp-json/sorabun/v1/articles | 記事生成を開始する | 下書きを作る(post_status が publish なら、公開する) |
| GET | /wp-json/sorabun/v1/jobs/<id> | ジョブの状態を見る | 下書きを作る(この鍵で作ったジョブだけ。公開する権限なら全部) |
| GET | /wp-json/sorabun/v1/jobs | 直近のジョブ一覧 | 下書きを作る(同上) |
記事生成のリクエストで渡せる項目は次のとおりです。
keyword(必須)type— 最適化タイプlength— 文字数post_status—draftまたはpublishcustom_prompt— 追加の指示tone— 文体(desumasu/dearu/casual)diagrams— 図解の数(0〜5。-1はAIが必要な箇所だけ)eyecatch— アイキャッチ画像を作るか(true/false)
REST APIでは、length を省略するとAIが検索意図から字数を決めます(MCPの create_article は、省略するとサイトの既定です)。それ以外の省略した項目は、設定の値が使われます。
エラー
| HTTP | code | 原因と対処 |
|---|---|---|
| 401 | sorabun_no_key / sorabun_bad_key | 鍵が付いていない、または違う(取り消した鍵も、ここになります) |
| 401 | sorabun_key_expired | 鍵の期限が切れています。新しい鍵を作ってください |
| 403 | sorabun_forbidden | 鍵に、その操作の権限がありません(data.required_scope に要る権限) |
| 403 | sorabun_not_your_job | ほかの鍵や管理画面で作ったジョブです |
| 429 | sorabun_rate_limited / sorabun_article_limit | 1時間の呼び出し、または1日の記事の作成の上限を超えました。Retry-After の秒数だけ待ってください |
MCPの口では、権限の不足は HTTP 403(JSON-RPC のエラー -32003)、1日の記事の上限は HTTP 429(-32029)と Retry-After で返します。
鍵があれば、その鍵の権限で、だれでも操作できます。外部サービスに登録する場合は、そのサービスの権限管理をご確認ください。漏れた疑いがあるときは、設定画面の一覧で、その鍵を取り消してください。
WordPress の Abilities API からも使えます(WordPress 6.9 以降)
WordPress 6.9 から、プラグインの機能を「能力(ability)」として本体に登録できるようになりました。Sorabun は、上のMCPのツールと同じ中身を、カテゴリ sorabun の能力として登録します(WordPress 6.8 以前では何もしません)。
| 能力 | 中身(MCPのツール) | 要るWordPressの権限 |
|---|---|---|
sorabun/create-article | create_article | edit_posts(公開まで頼むなら publish_posts) |
sorabun/rewrite-article | rewrite_article | edit_posts(その記事を編集できること) |
sorabun/article-from-url | article_from_url | edit_posts(公開まで頼むなら publish_posts) |
sorabun/get-job / sorabun/list-jobs | get_job / list_jobs | edit_posts(編集者より下の人は、自分で頼んだジョブだけ) |
sorabun/list-posts / sorabun/get-post | list_posts / get_post | read(編集できない記事は、訪問者に見えるものだけ) |
sorabun/site-info | site_info | read |
sorabun/security-status | security_status | manage_options |
sorabun/update-post | update_post | edit_posts(公開中・予約・非公開の記事は publish_posts)と、その記事を編集できること |
sorabun/schedule-post / sorabun/unschedule-post | schedule_post / unschedule_post | publish_posts と、その記事を編集できること |
sorabun/list-rankings / sorabun/list-kpis / sorabun/search-console-summary | list_rankings / list_kpis / search_console_summary | edit_posts(順位チェック・目標とレポートの画面と同じ) |
sorabun/list-article-ideas / sorabun/refresh-article-ideas | list_article_ideas / refresh_article_ideas | edit_posts |
sorabun/get-site-profile / sorabun/list-ai-citations / sorabun/search-console-queries | get_site_profile / list_ai_citations / search_console_queries | edit_posts(サイト診断・順位チェック・SEOインサイトの画面と同じ) |
sorabun/update-site-profile | update_site_profile | publish_posts |
sorabun/list-broken-links | list_broken_links | edit_others_posts(リンクチェックの画面と同じ) |
sorabun/get-technical-audit / sorabun/get-ai-recommendations | get_technical_audit / get_ai_recommendations | manage_options(テクニカル診断・AI推奨の画面と同じ) |
sorabun/list-social-posts / sorabun/schedule-social-post / sorabun/cancel-social-post | list_social_posts / schedule_social_post / cancel_social_post | manage_options |
sorabun/list-inquiries / sorabun/get-inquiry | list_inquiries / get_inquiry | manage_options |
能力は、ここの鍵ではなく、WordPressにログインした人の権限で動きます。管理画面と同じ線を引いているので、鍵の回数の上限は掛かりません。
- 本体の REST:
/wp-json/wp-abilities/v1/abilities?category=sorabunで一覧、/wp-json/wp-abilities/v1/abilities/<能力>/runで実行できます(アプリケーションパスワードなどでログインして呼びます)。読むだけの能力は GET(入力はinputのクエリー)、sorabun/cancel-social-post(取り消し)は DELETE(同じくinputのクエリー)、ほかは POST(本文のinput)です。いまの状態では受けられない呼び出し(人が開いている記事・検証の途中・送ったあとの取り消しなど)は 409 で返します - MCPのアダプター: WordPress の MCP アダプター(mcp-adapter)を入れたサイトでは、Sorabun の能力も、アダプターの既定のサーバーから使えます(Sorabun の能力は、どれも公開の印を付けています)
- 入力と出力: どの能力にも、入力と出力の JSON Schema と、「読むだけ」「壊さない」「同じ結果」の印を付けています