MindThread

MindThread MCP：AI エージェント向けに作られたThreadsスケジューラー

Claude、Cursor、または任意のMCPクライアントから、Metaの公式Threads APIを通じて、Threadsへの投稿の作成、予約、公開、返信の下書きの確認、アカウントのインサイトの閲覧ができます。40種類以上のツール、無料のサンドボックスキー、投稿前にエージェントが確認を求めるための権限管理機能を備えています。

claude mcp add --transport http mindthread https://mindthread.tw/api/mcp --header "Authorization: Bearer mt_live_your_key"

繁體中文說明在下方

エージェントにできること

• 作成：アカウントの文体（ペルソナ、ブランド素材、コンテンツの型）に合わせて、1〜5件の下書き、または2〜10件のパートからなるスレッドを生成します。
• 予約・公開：テキスト、単一画像、カルーセル（画像2〜10枚）、動画を、すぐに、または指定した時刻に公開できます。または、アカウント独自の時間枠に従って公開されるキューに投稿を追加できます。
• コードでブランドイメージを維持：コンテンツルール（文字数、禁止フレーズ、ハッシュタグなし、事実リストにある数字のみ使用）は、プロンプトで提案するだけでなく、サーバーによって適用されます。
• 重要な場所に返信：クラウドパトロールがThreadsでキーワードを検索して返信を下書きします。エージェントは下書きの一覧を表示し、それぞれを承認または却下します。
• 効果を測定：アカウントごとの閲覧数、いいね、返信、フォロワー数に加え、パトロールによる返信の結果も確認できます。
• 主導権を維持：各キーで権限ごとにallow、ask、denyを設定できます。askの場合、投稿はmindthread.twで確認するまで保留され、投稿の代わりに、エージェントから確認用リンクが渡されます。

3分でセットアップ

1. APIキーを取得します。 mindthread.twで登録し、Threadsアカウントを連携したら、Settings → API keysを開いてキーを作成します。 まずはテストキー（mt_test_…）から始めましょう。読み取りでは実際のデータが表示され、書き込みはシミュレーションされるため、Threadsには何も投稿されません。準備ができたら、ライブキー（mt_live_…）に切り替えてください。 すべてのプランにAPIアクセスが含まれます（2026年10月時点：無料プランではライブキーごとに1日50回、テストキーは共通の1日500回のサンドボックスを利用できます）。現在の制限については、mindthread.tw/developersをご覧ください。

2. MindThreadをクライアントに追加します（以下からお使いのものを選択してください）。

3. 最初の予約投稿を依頼します：

MindThreadのアカウントを一覧表示してください。次に、私が事業を始めた理由について短い投稿を書いて、私に見せてから、明日の台北時間午前9時にアカウントで公開するよう予約してください。

エージェントはlist_accounts、generate_postsの順に呼び出し、続いてpublishをpublish_atとともに呼び出します。「予約投稿を表示して」（list_schedules）と依頼すれば、結果を確認できます。

クライアントのセットアップ

接続方法は2つあります。どちらも同じサーバーに接続します。

• リモート（推奨）：クライアントの接続先をhttps://mindthread.tw/api/mcpに設定します。インストールは不要です。
• ローカルstdio：このパッケージをnpx -y mindthread-mcpで実行します。サーバーの起動にコマンドを使うクライアント向けです。すべてのメッセージを同じエンドポイントに転送するため、ツールは常に同じです。

Claude Code

# Remote, with an API key
claude mcp add --transport http mindthread https://mindthread.tw/api/mcp --header "Authorization: Bearer mt_live_your_key"

# Remote, signing in with your MindThread account instead of a key (run /mcp in Claude Code to log in)
claude mcp add --transport http mindthread https://mindthread.tw/api/mcp

# Local stdio
claude mcp add mindthread --env MINDTHREAD_API_KEY=mt_live_your_key -- npx -y mindthread-mcp

Claude Desktop

claude_desktop_config.jsonを編集します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "mindthread": {
      "command": "npx",
      "args": ["-y", "mindthread-mcp"],
      "env": { "MINDTHREAD_API_KEY": "mt_live_your_key" }
    }
  }
}

WindowsでClaudeがnpxを見つけられない場合は、"command": "cmd"と"args": ["/c", "npx", "-y", "mindthread-mcp"]を使用してください。 ファイルを編集しない場合：Settings → Connectors → Add custom connectorで、URLにhttps://mindthread.tw/api/mcpを指定し、MindThreadアカウントでサインインします（カスタムコネクタを利用できるClaudeプランの場合）。

Cursor

全プロジェクト向けの~/.cursor/mcp.json、または単一プロジェクト向けの.cursor/mcp.jsonを使用します。

{
  "mcpServers": {
    "mindthread": {
      "url": "https://mindthread.tw/api/mcp",
      "headers": { "Authorization": "Bearer mt_live_your_key" }
    }
  }
}

stdio形式を使う場合は、"command": "npx", "args": ["-y", "mindthread-mcp"], "env": { "MINDTHREAD_API_KEY": "mt_live_your_key" }とします。

VS Code（GitHub Copilotエージェントモード）

.vscode/mcp.jsonを使用します。キーは一度だけ入力し、安全に保存されます。

{
  "inputs": [
    { "type": "promptString", "id": "mindthread-key", "description": "MindThread API key", "password": true }
  ],
  "servers": {
    "mindthread": {
      "type": "http",
      "url": "https://mindthread.tw/api/mcp",
      "headers": { "Authorization": "Bearer ${input:mindthread-key}" }
    }
  }
}

その他のMCPクライアント

• Streamable HTTP：https://mindthread.tw/api/mcp。ヘッダーはAuthorization: Bearer <key>（X-API-Keyも使用できます）。
• stdio：コマンドはnpx、引数は-y mindthread-mcp、環境変数はMINDTHREAD_API_KEYです。

キーがなくても、initialize、tools/list、get_playbook、list_formulasは動作するため、まず機能を確認できます。

プロンプトの例

• 「MindThread では何ができますか？まずプレイブックを読んでください。」（get_playbook）
• 「@mybrand の語り口で、初めての住宅購入に向けた貯蓄についての投稿を3件作成してください。まだ投稿はしないでください。」（generate_posts）
• 「投稿1と3をキューに追加し、投稿2を金曜日の20:00に予約してください。」（add_library, publish）
• 「確認待ちの返信の下書きはありますか？1件ずつ表示してください。」（list_pending_replies, approve_pending_reply, reject_pending_reply）
• 「直近7日間の @mybrand の実績を、その前の7日間と比較するとどうでしたか？」（analytics_insights）
• 「クラウドパトロールのキーワードを「初めての住宅購入」「住宅ローン」「賃貸か購入か」に設定し、1日あたりの返信は最大10件にして、すべての返信を私の確認待ちにしてください。」（set_cloud_patrol）

ツール

サインイン前にクライアントが認識するツールの一覧です。ライブサーバーから npm run tools-table で生成されます。サーバーが唯一の信頼できる情報源です。ツールが追加されると、このパッケージを更新しなくても公開されます。

ツール	タイトル	種類	機能
get_me	自分のプランとキー	読み取り	現在のプラン、この接続のIDと権限（各権限は allow、ask、deny のいずれか）、この … での1日の残り呼び出し回数を返します。
list_accounts	接続済みアカウントの一覧	読み取り	この MindThread メンバーに接続されている Threads アカウントの一覧を返します。他のすべてのツールで account_id として渡す ID も含まれます。
get_material	ブランド素材を取得	読み取り	アカウントの素材ダイジェスト（ブランドの概要、販売商品、主張、体験、FAQ、出典付きの数値、トーン）を返します。これはすべての …
build_material	ブランド素材を作成	書き込み	ブランド独自のウェブサイトにある最大8件の https ページと、実例を含む任意のメモおよび … を使って、アカウントの素材ダイジェストを作成または再作成します。
get_account_settings	アカウント設定を取得	読み取り	1つのアカウントの persona、schedule_times、review_before_publish、auto_reply_enabled、auto_thread、content_rules、およびガードレール … を返します。
update_account_settings	アカウント設定を更新	書き込み	アカウントの persona（最大4,000文字）、schedule_times（アカウントのタイムゾーンで HH:MM をカンマ区切りで指定、最大8件）、… を変更します。
list_guardrail_changes	ガードレールの変更履歴	読み取り	アカウントのガードレールの改訂履歴を新しい順に一覧表示します（件数は1～50、既定値は20。次のページには before を指定します）。
list_account_settings	アカウント設定の一覧（一括）	読み取り	このメンバーに接続されているすべての Threads アカウントと、MindThread の一括設定シートの設定（実行モード、自動投稿、レビュー …）を一覧表示します。
preview_account_settings	一括設定変更をプレビュー	読み取り	設定変更をまとめて適用した場合の内容を表示します。書き込みは行いません。各アカウントとセルの現在値および新しい値、警告 … を確認できます。
apply_account_settings	一括設定変更を適用	書き込み	最大100アカウントに設定変更をまとめて適用します。各アカウントを個別のトランザクションで処理し、行ごとの結果（成功、変更なし、…）を返します。
revert_account_settings_batch	一括設定変更を取り消す	書き込み	バッチ処理から24時間以内に、そのバッチで変更した値を復元します。
get_account_settings_batch	一括設定バッチを取得	読み取り	batch_id で指定したバッチを返します。送信日時と送信元（ウェブサイト、API、MCP）、件数、取り消し可能かどうか、および各 … が含まれます。
generate_posts	投稿の下書きを生成	書き込み	トピックについて、コンテンツのフォーミュラ（自動、または list_formulas の ID）、アカウントの persona と素材を使って、1～5件の投稿の下書きを生成します。…
publish	投稿を公開または予約	書き込み	Threads に投稿を今すぐ公開する（publish_now:true）か、publish_at（オフセット付き ISO 8601）に公開します。
schedule_text	テキスト投稿を予約	書き込み	既存のテキスト（最大500文字）を publish_at に予約するか、auto_optimize_time:true を指定して次に最適な時間帯に予約します（この2つは相互に …）。
list_schedules	予約投稿の一覧	読み取り	予約投稿を一覧表示します。必要に応じて account_id で絞り込み、ステータス、publish_at、投稿が保留された場合の held_reason（例 …）を含めます。
cancel_schedule	予約をキャンセル	書き込み	ID を指定して予約投稿をキャンセルします。
list_library	ライブラリー項目の一覧	読み取り	ステータス（queued、draft、published、failed）別に、アカウントのライブラリー項目を一覧表示します（最大200件）。
add_library	ライブラリー項目を追加	書き込み	最大20件の項目（テキスト、任意の公開 https 画像）を queued（既定値）としてアカウントのライブラリーに追加します。これらは … に自動公開されます。
delete_library_item	ライブラリー項目を削除	書き込み	ID を指定して、queued、draft、archived のライブラリー項目を1件完全に削除します。
approve_library_item	下書きをキューに承認	書き込み	ID を指定して、下書き1件を公開キューに移動します。
update_library_item	ライブラリー項目を更新	書き込み	ID を指定して、ライブラリー項目1件のステータス（archived、draft、queued）、テキスト（content_rules に照らして確認）、またはキュー内の位置（position …）を変更します。
get_cloud_patrol	クラウドパトロール設定を取得	読み取り	アカウントのクラウドパトロール設定とステータス（キーワード、1日の上限、当日の返信数、review_before_reply、最終スキャン時刻）を返します。
set_cloud_patrol	クラウドパトロールを設定	書き込み	アカウントのクラウドパトロールを新規作成または更新します。キーワード（1～10件。「#tag」形式の項目はトピックタグを検索）、返信用 persona、daily_cap（…で1～50）を設定します。
cloud_patrol_log	クラウドパトロールの返信ログ	読み取り	過去1～7日間にアカウントのクラウドパトロールが送信した返信を、対象の投稿と返信テキストとともに一覧表示します。
cloud_patrol_stats	クラウドパトロールの結果	読み取り	1～14日間にアカウントのクラウドパトロールの返信が獲得した表示回数と「いいね」の数を、上位の返信とともに返します。
list_pending_replies	レビュー待ちの返信下書きを一覧表示	読み取り	ステータス別（既定値は pending。sent、rejected、expired も指定可能）に、アカウントのクラウドパトロールの返信下書きを一覧表示します。
approve_pending_reply	返信の下書きを送信	書き込み	ID を指定して、クラウドパトロールの返信下書き1件を承認し、Threads に今すぐ送信します。任意で編集した返信テキストを指定できます。編集後のテキストは同じ品質 … を満たす必要があります。
reject_pending_reply	返信の下書きを却下	書き込み	ID を指定して、クラウドパトロールの返信下書き1件を、任意のメモを付けて却下します。
list_events	最近のイベントを一覧表示	読み取り	過去7日間のメンバーのイベントフィードを新しい順に返します（件数は1～200）。post.published、post.failed、reply.sent、patrol.reply、… が含まれます。
analytics_insights	アカウントのインサイト	読み取り	1つのアカウントの表示回数、「いいね」、返信、フォロワー数を期間（7d、30d。既定値は30d）で返します。
list_formulas	コンテンツフォーミュラの一覧	読み取り	generate_posts で使用できるコンテンツフォーミュラを、ID と短い説明付きで一覧表示します。
get_playbook	運用プレイブック	読み取り	このサーバーを使ってアカウントを運用するためのプレイブックを返します。日々の流れ、確認リクエストの仕組み、利用上限、および … が含まれます。
connect_account_link	新しいアカウントの接続リンクを取得	書き込み	ユーザーがブラウザーで開き、このメンバーに新しい Threads アカウントを接続するための Threads OAuth リンクを返します。
disable_this_key	この接続を無効化	書き込み	この呼び出しを行うキーまたは接続を永久に無効化します。
get_my_usage	自分の利用状況と呼び出しログ	読み取り	過去1～30日間のこの接続自身の利用状況を返します（days=1 は Asia/Taipei の午前0時以降の今日）。概要（呼び出し回数、ユニット数、エラー数、…）が含まれます。
get_approval	確認リクエストを確認	読み取り	ID（apr_...）で、この接続が作成した確認リクエスト1件を返します。ステータス（pending、approved、executed、failed、denied、expired、…）が含まれます。
bulk_archive_library	ライブラリー項目を一括アーカイブ	書き込み	1回の呼び出しで、ID を指定して最大50件のライブラリー項目をアーカイブします。
bulk_delete_library	ライブラリー項目を一括削除	書き込み	1回の呼び出しで、ID を指定して queued、draft、archived のライブラリー項目を最大50件完全に削除します。
bulk_queue_library	ライブラリー項目を一括キュー登録	書き込み	1回の呼び出しで、ID を指定して最大50件の下書きを公開キューに移動します。アカウントの schedule_times に従って自動公開されます。

安全性と制御

• キーごとの権限。 各権限（読み取り、下書きの作成、予約投稿、今すぐ投稿、返信の送信、クラウドパトロールの有効化、アカウントの接続、ガードレールの緩和、Webhook）は、Settings → API keys で allow、ask、deny のいずれかに設定できます。ask の場合、エージェントには確認用リンク付きの approval_required が返されます。mindthread.tw で確認した後にのみ、操作が実行されます。
• ウェブサイト上で行うのは、あなただけです。 ガードレールの変更を元に戻せるのは、常にあなただけです。クラウドパトロールの有効化が OAuth 接続（Claude、ChatGPT）に許可されることはありません。また、API キーでは、この権限を明示的に設定する必要があります。
• コンテンツルールはコードで適用されます。 enforce: "block" を設定すると、モデルがどのような内容を作成したかにかかわらず、ルールに違反する投稿をサーバーが拒否します。
• キルスイッチ。 disable_this_key は、現在使用中のキーを恒久的に無効にします。Settings からキーや接続を取り消すこともできます。
• 公式 API のみを使用。 投稿と返信には Meta の公式 Threads API を使用します。MindThread が Threads のパスワードを求めることはありません。
• キーはローカルに保持されます。 stdio モードでは、キーは MINDTHREAD_API_KEY 環境変数から読み取られ、mindthread.tw にのみ送信されます。キーがそのまま表示されることはありません（ログには mt_live_…abcd と表示されます）。

設定

変数	必須	説明
MINDTHREAD_API_KEY	アカウントにアクセスするすべてのツールで必須	mt_live_… または mt_test_…
MINDTHREAD_MCP_URL	いいえ	エンドポイントの上書き先。デフォルトは https://mindthread.tw/api/mcp

Node.js 18.17 以降が必要です。ランタイム依存関係はありません。

トラブルシューティング

• 「MINDTHREAD_API_KEY is not set」：クライアント設定で、このサーバーの env ブロックにキーを追加し、クライアントを再起動してください。
• 「MindThread rejected the key」：キーが間違っているか、取り消されているか、無効になっています。Settings → API keys で新しいキーを作成してください。
• approval_required：想定どおりの動作です。エージェントが表示したリンクを開いて確認すると、投稿が公開されます。
• insufficient_scope：このキーでは、その権限が deny に設定されています。エラーの fix フィールドに、変更が必要な設定が示されます。
• rate_limit_exceeded：1 日あたり、または 1 分あたりの上限に達しました。エラーにリセット時刻が表示されます。
• ログは stderr に出力されます（Claude Desktop：Settings → Developer → Open Logs Folder）。stdout には MCP メッセージのみが出力されます。

こちらも利用できます

• シェルコマンドを使いたいスクリプトやエージェント向けの CLI：mindthread-cli（npx mindthread-cli）。
• REST API：mindthread.tw/api/v1/openapi.json の OpenAPI 3.1、ドキュメントは mindthread.tw/developers、エージェントガイドは mindthread.tw/llms.txt にあります。

繁體中文

MindThread 是給 AI agent 用的 Threads 排程器。接上之後，Claude、Cursor 或任何支援 MCP 的工具，都能替你的 Threads 帳號寫文、排程、發文（文字、單圖、輪播、影片）、審核雲端海巡的回覆草稿、看觀看與互動數據。全程走 Meta 官方 Threads API，不需要你的 Threads 密碼。

三分鐘上手：

1. 到 mindthread.tw 註冊並連接 Threads 帳號，在「設定 → API 金鑰」建立金鑰。建議先用測試金鑰（mt_test_ 開頭）：讀取的是真資料，寫入只模擬、不會發到 Threads。
2. 把 MindThread 加進你的工具，例如 Claude Code：

   claude mcp add --transport http mindthread https://mindthread.tw/api/mcp --header "Authorization: Bearer mt_live_你的金鑰"
   

   Claude Desktop、Cursor、VS Code 的設定見上方 Client setup。
3. 對 AI 說：「列出我的 MindThread 帳號，幫我寫一篇介紹我為什麼創業的短文，給我看過之後，排在明天早上 9 點發。」

你保有控制權：每把金鑰的每項權限都能設成「允許」「先問我」「拒絕」。設成「先問我」時，AI 會拿到一個確認連結交給你，你在 mindthread.tw 按下確認才會發出。字數、禁用詞、只能用你列的數字這些內容規則，由伺服器以程式檢查，可以設成直接擋下。

ライセンス

MIT © Ultra Lab