MCPツール
ツールは14個です(キーなしの場合にのみ提供されるsignupを含めると15個)。
| ツール | 機能 | パラメーター |
|---|---|---|
list_accounts |
連携済みアカウントをid、platform、username、avatarUrl付きで一覧表示します。idはaccountIdsに使います。 |
なし |
get_connect_url |
人間のユーザーがアカウントを連携・再連携するためのブラウザ用URLを返します。 | platform(必須)、reconnectAccountId(zernioAccountId) |
new_claim_link |
新しい受け取りリンクをメールで送ります(未受け取りのワークスペースのみ)。 | なし |
upload_media |
画像または動画を1つ、base64で10 MBまでアップロードします。メディアIDを返します。 | filename、contentType、dataBase64(すべて必須) |
create_post |
投稿を作成、予約、またはドライランします。ルールはPOST /postsと同じです。 | accountIds(必須)、content、mediaIds、dryRun、requireApproval、scheduledFor、firstComment、thread、firstReply、poll、cover、tiktokAiGenerated、idempotencyKey |
get_post |
投稿のアカウントごとのステータスを返します。settledがtrueになるまでポーリングします。 |
postId(必須) |
list_posts |
最近の投稿を新しい順に返します。 | limit(1–100、デフォルト20) |
approve_post |
承認待ちの投稿を承認します。キーでは拒否されます(人間のみ)。 | postId(必須)、publishNow、scheduledFor |
reject_post |
承認待ちの投稿を完全に却下します。キーが却下できるのは、そのキー自身が作成した投稿だけです(それ以外はreject_not_own_post)。 |
postId(必須)、reason |
retry_post |
失敗した投稿を、新しい試行として再試行します。キーが再試行できるのは、そのキー自身が作成した投稿だけです(それ以外はretry_not_own_post)。承認制のキーで再試行すると、投稿は再び承認待ちになります。 |
postId(必須) |
cancel_post |
承認待ちまたは予約済みの投稿をキャンセルします。キーがキャンセルできるのは、そのキー自身が作成した投稿だけです(それ以外はcancel_not_own_post)。 |
postId(必須) |
delete_post |
一度も送信されていない投稿(承認待ち、却下済み、キャンセル済み、またはすべてのネットワークで失敗)を、失敗した送信がZernioに残したコピーとともに削除します。キーが削除できるのは、そのキー自身が作成した投稿だけです(それ以外はdelete_not_own_post)。 |
postId(必須) |
reschedule_post |
公開前にscheduledForを変更します。キーが日時を変更できるのは、そのキー自身が作成した投稿だけです(それ以外はreschedule_not_own_post)。 |
postId、scheduledFor(どちらも必須) |
retry_first_comment |
失敗した最初のコメントを再試行します。二重に投稿されることはありません。 | postId(必須) |
signup |
キーなしの場合のみ。人間のユーザーのためにFreeワークスペースを作成し、キーを取得します。 | email(必須)、workspaceName、agentName、locale(enまたはja。受け取りメールの言語) |
各フィールドの意味はRESTリファレンスと同じです:POST /posts、投稿の操作、メディア、アカウント、連携。
典型的な流れ
Section titled “典型的な流れ”list_accountsを呼び出し、使うidを選びます。- ファイルごとに
upload_mediaを呼び出します。 dryRun: trueでcreate_postを呼び出し、指摘された点を修正します。次にdryRunを外し、idempotencyKeyを付けてもう一度呼び出します。settledがtrueになるまでget_postを呼び出します。needs_approvalと表示されたら、アプリで承認するよう人間のユーザーに伝えてください。
{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "create_post", "arguments": {"content": "Fresh sourdough at 7am", "accountIds": ["2ae8…"], "dryRun": true}}}よくある質問
投稿用のツールが表示されないのはなぜですか?
キーなしで接続しているため、signupだけが提供されています。Authorization: Bearer を付けて再接続してください。
MCPツールはRESTと同じデータを返しますか?
はい。ツール結果の中に、RESTのレスポンスと同じJSONが入っています。
呼び出しがタイムアウトしたとき、二重投稿を防ぐには?
create_postを再試行するときに、同じidempotencyKeyを渡してください。