開発者向け

AIツールからブログを管理する

Claudeなど任意のMCPクライアントから、BookatuのMCPサーバーを通じて、お店のブログ記事の一覧表示、作成、編集、公開、非公開ができます。

どんな機能か

https://bookatu.com/api/mcp にあるビジネス用MCPサーバーには、ブログ用のツールが6つあります。blog_list_posts、blog_get_post、blog_create_post、blog_update_post、blog_publish_post、blog_unpublish_post です。使えるのは、キーや接続したアプリが属するお店のブログだけです。削除するツールはないので、記事の削除はダッシュボードで行います。

どう役立つか

エディタを開かずに、AIアシスタントに記事の下書き、手直し、非公開化を頼めます。ツールが受け付ける値と断る値はエディタと同じで、他のお店の記事が見つかることはありません。新しい記事は、AIに公開を指示しない限り下書きのままです。

使い方

  1. 1オーナーと管理者は、Settings の API & monitoring にある API keys でキーを作ります。What this key may do の Blog, forms and email drafts の行で、読み取り用の2つのツールには See posts, forms and email drafts (content:read) に、書き込む4つのツールには Write posts, forms and email drafts (content:write) にチェックを入れます。どちらも 'Manage the business' が必要です。スコープ導入前に作られたキーで書き込むには読み書きのアクセスが必要で、ログインで接続したアプリは承認時に Read and write が必要です。
  2. 2MCPクライアントの接続先を https://bookatu.com/api/mcp にし、毎回のリクエストでキーを Authorization: Bearer bk_live_... として送ります。tools/list にはそのキーで呼べるツールだけが表示され、読み取り専用の認証情報は書き込むツールではすべて拒否されます。
  3. 3blog_list_posts は下書きと公開済みの記事を新しい順に一覧表示します。status は all、draft、published から選べます(省略可)。返すのは id、slug、title、status、publishedAt、excerpt で、本文は返しません。blog_get_post は postId か slug で記事1件を本文(マークダウン)まで含めて返し、下書きも見えます。
  4. 4blog_create_post にはタイトル(2〜140文字)とマークダウンの本文(最大50,000文字)が必要で、抜粋(最大300文字)と http(s) の coverImageUrl は任意です。スラッグはタイトルから作られ、重複しないようになります。publish: true を送らない限り下書きとして保存し、送ると記事はすぐに公開されます。
  5. 5blog_update_post は postId と、変更したい項目だけを受け取ります。それ以外はそのままで、スラッグは変わらないため、公開中のリンクも使えます。excerpt や coverImageUrl を空にすると消え、status を draft か published にすると誰が見られるかが変わります。blog_publish_post と blog_unpublish_post は状態だけを変えます。最初の公開で publishedAt が付き、その後に非公開にしたり再公開したりしても日付は変わりません。
  6. 6ツールでは検索用タイトル、検索用説明文、タグは設定できず、更新しても変わりません。エディタの Grow、Blog の Search & sharing で設定してください。不正な値は切り詰められずにエラーで拒否され、他のお店の記事IDには Post not found が返ります。ツールの完全なスキーマは /developers にあります。

Was this helpful?

お探しのものが見つかりませんでしたか?

サポートに問い合わせる または よくある質問をご覧ください.