AIエージェント (MCP)

PostClaw はリモートの Model Context Protocol サーバーを提供しています。AI アシスタントを接続すれば、「来週の投稿を3本書いて、Facebook ページに予約して」と普通の言葉で頼めます。アシスタントがあなたとしてチャネルを確認し、下書きを作り、カレンダーに入れます。

Free を含むすべてのプランで利用できます。 プランの上限はアプリと同じように適用されます。

必要なもの

チャネルを1つ以上接続した PostClaw アカウント。
Streamable HTTP で Authorization ヘッダーを送れる MCP クライアント：Claude Code、Cursor、VS Code、その他ほとんどの MCP クライアント。
設定 → AIエージェント で作成したトークン。

ブラウザ版の Claude.ai と ChatGPT にはまだ対応していません。OAuth ログインが必要で、対応を予定しています。

2分で接続

設定 → AIエージェントを開き、新しいトークン をクリックします。
わかりやすい名前（例：「ノートPCの Cursor」）を付け、権限を選びます。
トークンをコピーします。表示されるのは一度だけです。 なくした場合は取り消して新しく作成してください。
クライアントにサーバーを追加します。設定ページには、トークン入りの次のスニペットが表示されます。

サーバー URL: https://app.postclaw.fun/mcp

Claude Code

claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "postclaw": {
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "postclaw": {
      "type": "http",
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

接続を確認するには、アシスタントに「PostClaw にどのチャネルがある？」と聞いてみてください。

権限

トークンごとに権限があります。アシスタントにはトークンで許可されたツールだけが見えます。

権限	アシスタントができること
閲覧 (常にオン)	チャネル、投稿、メディア、分析の閲覧と投稿時間の提案
書き込み	下書きの作成と編集、メディアのアップロード、AI での投稿作成、AI 画像の作成
公開 (既定はオフ)	実際のアカウントでの投稿の予約、公開、予約解除、削除

公開がない場合、アシスタントは下書きを残すだけで、確認と承認は PostClaw で行います。代わりに投稿させてもよいと信頼できるアシスタントにだけ有効にしてください。

有効なトークンは最大10個まで持てます。取り消しはアシスタントの次のリクエストから反映されます。

ツール

ツール	権限	内容
`list_channels`	閲覧	投稿先として接続済みのアカウントとページ
`list_posts`, `get_post`	閲覧	下書き・予約済み・公開済みの投稿（公開 URL とエラー付き）
`get_analytics`	閲覧	合計、プラットフォーム別内訳、最適な時間、上位投稿
`suggest_posting_times`	閲覧	プラットフォームごとのおすすめ時間帯
`list_media`	閲覧	最近アップロードしたメディア
`generate_post`	書き込み	指示から投稿文を作成（ブランドボイスも指定可）
`adapt_post`	書き込み	1つのコンテンツを各プラットフォーム向けに書き直し
`create_image`	書き込み	投稿用の AI 画像
`upload_media`, `add_media_to_post`	書き込み	自分の画像や動画を添付
`create_post`, `update_post`	書き込み	下書きの作成と編集。日時を指定すると予約になります（公開が必要）
`publish_post`	公開	今すぐ公開し、各プラットフォームの投稿 URL を返す
`unschedule_post`	公開	予約済みの投稿を下書きに戻す
`delete_post`	公開	PostClaw から投稿を削除

メディアは https:// の URL か、upload_media で送ったファイルである必要があります。

create_post と publish_post には任意で idempotency_key を指定できます。24時間以内に同じキーで再送された場合、PostClaw は二重に作成・公開せず最初の結果を返します。

上限とクレジット

アシスタントはアプリと同じプランで動作します：

月間投稿数、AI クレジット、画像クォータは、PostClaw でもアシスタント経由でも同じように数えられます。
設定で自分の AI キーを接続している場合、AI ツールはそのキーを使います。
トークンごとに1分あたり60リクエストまで送れます。
すべての呼び出しはアカウントに記録されます。

トラブルシューティング

表示	原因	対処
`401` / “invalid token”	トークンが間違っているか、取り消されています	新しいトークンを作成してクライアントを更新
`429`	1つのトークンから1分間に60件を超えるリクエスト	数秒待つ（待ち時間はレスポンスに記載）
ツールが表示されない	トークンにそのツールの権限がない	その権限を持つトークンを作成
`scope_missing`	公開権限なしで予約または公開した	新しいトークンで公開を有効にするか、アプリで予約
`quota_exceeded`, `credit_cap_exceeded`	プランの月間上限に達した	次の期間を待つか、プランをアップグレード
”your … configuration failed”	自分の AI キーがエラーを返した（クォータ、請求、ログイン期限切れ）	設定 → Providers でキーを修正または削除

トークンを安全に保つ

トークンはあなたとして動作します。パスワードと同じように扱ってください：

リポジトリにコミットしたり、共有チャットに貼り付けたりしないでください。
デバイスやツールごとに別のトークンを使えば、1つだけ取り消しても他に影響しません。
使わなくなったトークンは 設定 → AIエージェント で取り消してください。