MCP & CLI
把 BrandFlow 接進你的 AI workflow
Agent skills 與標準 MCP protocol connector 都已經可用：讓 Claude、Cursor 等 agent 直接從你的 prompt 呼叫生成能力，不用切換到瀏覽器操作。
登入以搶先體驗能力
生成影片
從 agent 對話直接觸發腳本到成片的生成流程（generate-video skill）。
生成圖像
讓 agent 依品牌風格產出靜態素材（generate-image skill）。
發布到社群
把生成結果直接排程發布到已連接的平台（schedule-post skill——對比同類 agent 工具多這一段）。
Agent Skills（現在就能用）
已上線四個任務式 markdown skill（`generate-image`/`generate-video`/`generate-voiceover`/ `schedule-post`），打既有 `/api/v1/*` REST 端點，不需要 MCP protocol 或瀏覽器 connector。
npx skills add https://github.com/VVIVC/social-web/tree/main/skillsgenerate-image
文字轉圖片（預設 Flux 1.1 Pro）。同步回傳，不用輪詢。
generate-video
文字/圖片轉影片（預設 Seedance 2.0）。非同步，回 taskId 供輪詢。
generate-voiceover
文字轉語音，17 種情感聲線（預設 MiniMax Speech-02 HD）。
schedule-post
建稿＋掛生成的素材＋排程發布到已連接頻道——一次呼叫打通全程。
MCP Connector（協定本體）
已上線標準 MCP protocol connector（OAuth 2.1 + PKCE，不需要手動申請/貼上 API Key）——在 Claude 等支援 MCP 的客戶端貼上下方的連線位址即可。
https://lovtes.com/api/mcp① 複製 MCP Server URL
下方的固定連線位址，貼進任何支援 MCP connector 的 AI 客戶端。
② 於 AI 客戶端新增連接器
在 Claude（Settings → Connectors）等支援 MCP 的客戶端貼上連線位址並命名。
③ 走 OAuth 授權登入
跳轉到既有登入頁完成授權（同一組帳密，不需另外申請 token）即可在對話中呼叫工具。
現在可用的工具（15）
whoami
read目前連線的帳號、預設組織與專案。
list_projects
read列出可存取的所有專案。
get_credit_balance
read查詢目前計費週期的 credit 餘額與用量分布。
list_assets
read列出專案或組織素材庫裡的素材。
get_asset
read取回單一素材的網址與生成來源（prompt/provider）。
generate_image
generate文字轉圖片（同步回傳，會計費）。
generate_video
generate文字或圖片轉影片（非同步，回 task_id 供輪詢，會計費）。
generate_speech
generate文字轉語音（同步回傳，會計費）。
generate_music
generate文字轉背景音樂（同步回傳，會計費）。
get_task_status
generate輪詢非同步生成任務的狀態與完成後的素材網址。
list_tasks
generate列出近期生成任務，依狀態篩選。
list_channels
publish列出專案已連結的發布頻道（社群帳號）。
create_post_draft
publish建立內容草稿＋自動配對頻道與初始文案，尚未發布。
schedule_post_draft
publish把草稿展開成真正的排程貼文——差異化尾段，一次打通生成→建稿→發布。
get_post_draft_status
publish查詢草稿/排程的展開狀態與各頻道發布結果。
Scope 權限層
每個工具都歸類到三個 scope 之一；API Key 建立時可以選擇要開放哪些 scope（Settings → API Keys），publish 預設不開——會代發文，需要明選。
| scope | 工具數 | 預設授予 | 說明 |
|---|---|---|---|
| read | 5 | API Key 預設 ／ OAuth connector 一律有 | 唯讀查詢，不涉及計費或代發文。 |
| generate | 6 | API Key 預設 ／ OAuth connector 一律有 | 會消耗 credit 的生成 + 任務查詢。 |
| publish | 4 | 僅 API Key，且建立時需明選 | 會代發文——OAuth connector 一律不會有這個 scope，需改用 Settings 建立的 API Key。 |
OAuth connector（上方三步驟）恆定只有 read+generate——沒有內建的 scope 同意畫面可以另外勾選 publish，這是誠實的產品限制，不是遺漏。要用schedule_post_draft等發布工具，請改用 Settings → API Keys 建立時已勾選 publish 的金鑰。
對話內 UI（MCP Apps）
已上線連線成功後，部分工具會直接在對話內顯示互動卡片，不需要額外設定——這是 MCP Apps 協定的內建能力，工具本身照樣可以照純文字使用，卡片只是加分項。list_assets/get_asset顯示唯讀的縮圖畫廊；create_post_draft/schedule_post_draft/get_post_draft_status則是可以直接按按鈕排程/立即發布的草稿審閱卡——對話內就能走完「建稿→審閱→發布」整個 閉環，不用切回站內 UI。
生成結果畫廊
唯讀縮圖網格＋型別徽章（IMAGE/VIDEO/AUDIO/DOCUMENT/TEMPLATE），點擊放大預覽；沒有素材時顯示誠實的空狀態文案，不是假資料。
草稿審閱＋排程確認
互動回寫標題/內文預覽、頻道配對狀態（已連接/需重新授權/未連接）、附件縮圖；「立即發布」/「排程」按鈕直接呼叫發布工具， 結果就地更新——沒有 publish scope 時按鈕會顯示對應的權限提示，不會靜默失敗。
支援的 host
| host | 狀態 | 說明 |
|---|---|---|
| Claude（web / Desktop） | 已驗證 | 自訂連接器（Settings → Connectors → Add custom connector）貼上方連線位址即可，UI 渲染是協定內建能力，免另外審核/上架。 |
| ChatGPT（Developer Mode） | 盡力相容，未逐一驗證 | MCP Apps 是 Claude/OpenAI 共同定案的協定擴充，理論上相容；本批未實機跑過 ChatGPT 端渲染。 |
| 其他純文字 MCP 客戶端 | 不受影響 | 沒有 Apps 支援能力的客戶端會忽略 UI metadata，工具照樣回傳原本的 JSON 文字，功能不打折。 |