Genviral

$ claude mcp add --transport http genviral https://mcp.genviral.io/mcp

將 Genviral 加入目前專案。之後執行 /mcp 以完成 OAuth 登入。

Genviral 可發佈至

TikTokInstagramYouTubePinterestLinkedInFacebookXBlueskyMastodonTelegram

實際使用上

人們實際輸入的內容

每一項都會解析為針對您帳戶的真實工具呼叫——讀取已排定的內容、產生缺少的內容，並將結果排入佇列。

• 我上週發佈了什麼，哪一則表現最好？
• 為早晨例行公事產生三個 TikTok 幻燈片，並為本週排定發佈。
• 將所有排定在週五的內容移到週一早上。
• 我連線的帳戶中，哪一個在過去 10 天內沒有發文？
• 從這張圖片製作一個 9:16 的影片，並排入佇列作為 Instagram Reel。
• 從這份更新日誌草擬一篇 LinkedIn 貼文，但不要發佈。

兩層架構

您的助理做決定。Genviral 負責執行。

助理擅長判斷要製作什麼內容以及何時發佈。Genviral 擅長作為唯一一個能真正製作並發佈內容的連線。

您的助理負責

• 它已經知道您的意思 您描述想要的這一週。助理選擇格式、撰寫說明文字，並決定內容的配置——不需要指令語法，也不需要儀表板。
• 它在您原本工作的地方執行 Claude、ChatGPT、Cursor、VS Code，以及所有其他 MCP 用戶端都讀取同一個伺服器。每個用戶端連線一次，而不是每個功能連線一次。
• 它攜帶您的上下文 對話中的任何其他內容——發佈文件、儲存庫、靈感清單的試算表——都會成為它草擬貼文的素材來源。
• 它閉合迴圈 分析數據會透過同一條連線回流，因此下一批內容是根據實際表現來撰寫，而不是根據您希望會有的表現。

Genviral 負責

• 已連線的社群帳戶 透過一個 OAuth 連線涵蓋 10 個平台——不需要等待 Meta 或 TikTok 合作夥伴核准，您的助理設定中也不需要每個平台的權杖。
• AI 媒體產生 幻燈片、圖片和影片在 Genviral 的 Studio 中渲染。助理要求一個素材，就能拿回一個完成的素材——大多數 MCP 伺服器只能排定您已經製作的內容。
• 防重複發佈 透過 MCP 伺服器的每次寫入都需要冪等金鑰，而發佈需要明確的決定。重試中的代理程式無法重複發佈同一內容。
• 工作區與團隊 每個連線都綁定到您在同意時選擇的個人空間或一個工作區，因此代理商助理無法觸及未被指向的客戶。

連線

一個 URL，不到一分鐘

不需要安裝套件，也不需要執行伺服器。選擇您的用戶端，貼上端點，然後核准您希望它擁有的權限。

$ claude mcp add --transport http genviral https://mcp.genviral.io/mcp

將 Genviral 加入目前專案。之後執行 /mcp 以完成 OAuth 登入。

1. 02步驟 2 / 4

   將伺服器加入您的用戶端

   一個遠端 URL，無需安裝任何東西，也不需要持續執行的程序。Claude Code 將其視為指令；Cursor 和 VS Code 將其視為四行 JSON；Claude 和 ChatGPT 則在他們的連線器設定中接受。 Claude Code $ claude mcp add --transport http genviral https://mcp.genviral.io/mcp
2. 03步驟 3 / 4

   核准您真正想要的權限

   登入會開啟 Genviral 的同意畫面。選擇連線綁定的工作區，並僅授予您希望它擁有的範圍——讀取和草擬與發佈是分開的，而產生又是另一回事。之後可以隨時撤銷任何連線，而不影響其他連線。 建立免費帳戶
3. 04步驟 4 / 4

   要求一則貼文，然後看著它上線

   先從草稿而不是發佈開始，在儀表板中檢視說明文字和媒體，然後讓助理排定其餘內容。它產生的媒體會在支援 MCP 資源的用戶端中以畫廊形式呈現。 在您的助理中 $ Draft one TikTok slideshow about this week's launch, $ put it in my content library, and stop before publishing.

工具

32 個工具，4 種權限

此清單是根據伺服器授權的同一份合約產生，因此不會宣傳伺服器未註冊的工具。這裡的所有內容都會執行真實工作——沒有會丟給您一個連結並要求您自己完成的佔位工具。

讀取您的帳戶

context:read

帳戶、貼文、分析數據和媒體庫內容。此清單上的任何項目都不會變更任何內容。

• show_studio 唯讀 在 Studio 圖片和影片準備好後顯示。
• show_posts 唯讀 當您要求查看時，顯示您的內容行事曆，或其中的一則貼文。
• show_video 唯讀 顯示帶有可播放預覽的影片專案，並可從中開啟完整編輯器。
• show_library 唯讀 當要求時，顯示您的檔案或幻燈片的視覺預覽。
• show_viral_library 唯讀 當您想瀏覽靈感時，顯示病毒式參考卡片。
• show_analytics 唯讀 當您要求查看時，顯示您的貼文或一個追蹤帳戶的分析儀表板。
• browse_music 唯讀 瀏覽音樂庫和您自己上傳的曲目。
• get_context 唯讀 已連線的帳戶、工作區、方案和點數餘額，以及您可用的 Studio 模型。
• list_posts 唯讀 已排定、草擬和已發佈的貼文，以及每個帳戶的個別投遞狀態。
• get_analytics 唯讀 貼文和帳戶表現，以及您追蹤分析數據的每個帳戶。
• research_trends 唯讀 某個利基市場的趨勢簡報，以及在匯入前預覽任何公開的 TikTok 幻燈片。
• research_reddit 唯讀 搜尋 Reddit 上的來源貼文，然後從您選擇的討論串中讀取有限的評論樣本。
• analyze_content 唯讀 針對真實病毒式貼文為開場鉤子評分、建議經過驗證的鉤子結構，並為一個想法尋找病毒式參考。
• search_viral_library 唯讀 搜尋 Genviral 精選的病毒式貼文庫，並可完整開啟其中任何一則。
• browse_library 唯讀 您內容庫中的檔案、資料夾、影響者（一致角色）、圖片包、範本和幻燈片。
• search_images 唯讀
• get_job 唯讀 執行中的渲染、產生或分析重新整理的狀態。

建立和編輯內容

content:write

草稿、上傳、資料夾、套件、範本和幻燈片。仍然無法發佈。

• manage_music 寫入可刪除資料 新增、重新命名、匯入和刪除您自己的音樂曲目。
• manage_studio 寫入可刪除資料 將 Studio 創作儲存到您的媒體庫、刪除它們，或將範本加入最愛。
• upload_media 寫入 將圖片或影片上傳到您的媒體庫。
• manage_library 寫入可刪除資料 建立、移動和刪除資料夾，並在資料夾之間移動項目。
• manage_assets 寫入可刪除資料 建立和編輯圖片包以及可重複使用的幻燈片範本。
• manage_slideshow 寫入可刪除資料 複製、編輯、渲染或刪除幻燈片，或重新產生單一投影片。
• manage_analytics_targets 寫入可刪除資料 新增、編輯、移除和重新整理您追蹤分析數據的帳戶。
• create_post 寫入 準備貼文：媒體、說明文字、各平台設定、目標帳戶和排程。
• update_post 寫入可刪除資料 重新排定、編輯、重試或刪除您已建立的貼文。

排程和發佈

posts:publish

唯一能將內容呈現在觀眾面前的範圍。請單獨授予。

• schedule_editor_versions 寫入 準備並排定影片專案的渲染版本，跨您的帳戶發佈。
• publish_post 寫入可刪除資料 提交已準備的貼文——立即發佈或交給排程器。

產生媒體

media:generate

圖片、影片和幻燈片產生。這是會消耗點數的範圍。

• edit_video 寫入可刪除資料 建立和編輯影片專案：片段、文字、字幕和音樂，然後渲染最終剪輯。
• remix_video 寫入 尋找要混音的來源影片、預覽它們，並將片段匯入專案。
• generate_slideshow 寫入可刪除資料 從簡報產生多投影片輪播，或從 TikTok 匯入，然後渲染。
• generate_studio_media 寫入可刪除資料 在 AI Studio 中從提示或參考圖片產生圖片和影片。

安全性

它能做什麼是您的決定，而不是模型的決定

將您的社群帳戶交給助理，只有在限制存在於它無法觸及的地方時才合理。以下四項都位於後端。

OAuth，而非貼上的 API 金鑰

您登入 Genviral 來連線。不會有長期有效的金鑰放在設定檔、shell 設定檔或您的助理會記錄的 URL 中。撤銷連線後，它會立即停止運作。

您為每個連線選擇的權限

4 個獨立的範圍，在 Genviral 同意畫面上核准。助理可以被允許草擬但永遠不允許發佈，或只允許讀取分析數據而不允許其他操作。

限定於一個工作區

您在核准時選擇個人空間或特定工作區。連線無法看到、發佈到或花費其外部任何內容的點數。

發佈永遠是刻意的

發佈需要明確的發佈或排程決定，而且每次寫入都帶有冪等金鑰。重試失敗呼叫的代理程式不會重複發佈。

使用案例

六個值得連線的工作流程

每一個都是您已開啟的助理中的單一請求。迴圈每次都一樣：它讀取帳戶、產生缺少的內容，並將結果排入佇列。

• TikTok 一句話產生一週的幻燈片 助理拉取趨勢簡報、據此產生五個輪播，並每天排定一個——您核准整批，而不是逐一撰寫。
• Instagram 從已核准的資料夾為 Reels 加上字幕 指向媒體庫資料夾。它為每個片段撰寫字幕、加入主題標籤，並將它們排入佇列，而不會離開您的核准流程。
• LinkedIn 從您已經完成的工作撰寫貼文 因為助理可以在同一個對話中看到您的儲存庫、文件或更新日誌，貼文是根據真實細節草擬的，而不是摘要的摘要。
• YouTube Shorts 在審查關卡後發佈 它上傳、填寫中繼資料，並先以不公開方式發佈。您觀看後再將其設為公開——助理預設永遠不會得到這個決定。
• Pinterest 按節奏產生資訊圖表釘圖 Studio 渲染圖片、助理撰寫釘圖文案，然後整個內容送到正確的看板——一個提示，不需要設計步驟。
• Facebook 無需第二個工作流程即可交叉發佈 一個連線涵蓋所有平台，因此一小時後將今天的 TikTok 鏡像到 Facebook 粉絲專頁只是一個句子，而不是一個整合。

指南

接下來閱讀什麼

連線背後的開發者介面。每個 MCP 工具呼叫最終都會到達這些端點之一。

• Genviral Partner API 參考 每個 MCP 工具都是這些端點的輕量包裝。當您想要工具呼叫背後的確切請求和回應結構時，請閱讀此文件。 閱讀指南
• Genviral for AI agents 兩種連線路徑的簡短、機器可讀概覽——MCP 用於助理、REST 用於程式碼——具有相同的能力清單。 閱讀指南
• Genviral CLI 程式碼代理程式的替代方案：一個二進位檔、一個限定範圍的 API 金鑰，且不需要 MCP 用戶端。適用於 Codex、CI 工作和 cron。 閱讀指南

常見問題

MCP 問題

團隊在將助理指向他們的社群帳戶之前會問的問題。

什麼是 MCP？

模型上下文協定（Model Context Protocol）是由 Anthropic 推出的開放標準，用於將 AI 助理連接到外部工具和資料。MCP 伺服器發佈一組工具；任何 MCP 用戶端——Claude、ChatGPT、Cursor、VS Code 等——都可以呼叫它們。這意味著 Genviral 只需公開一次其能力，所有助理都能使用。

Genviral MCP 伺服器 URL 是什麼？

https://mcp.genviral.io/mcp. 它是一個遠端 streamable-HTTP 伺服器，因此無需安裝任何東西，也不需要保持本機程序執行。支援探索的用戶端也可以讀取 https://www.genviral.io/.well-known/mcp/server-card.json 來自動尋找端點、完整工具清單和可用的範圍。

如何驗證？ 使用 OAuth。當您的用戶端首次連線時，它會將您導向 Genviral 的同意畫面，您可以在其中登入、選擇連線所繫結的工作區，並核准您希望其擁有的權限。無需產生、複製或貼上 API 金鑰到設定檔中，而且您之後可以撤銷任何單一連線，而不會影響其他連線。

哪些 AI 用戶端可以使用它？

任何支援遠端伺服器搭配 OAuth 的 MCP 用戶端皆可。這涵蓋 Claude（桌面版、網頁版、行動版及 Claude Code）、ChatGPT 的自訂連接器、Cursor、搭配 Copilot 的 VS Code、Windsurf、Cline、Zed、JetBrains IDE，以及任何建構在支援 MCP 的代理框架之上的產品。

助理實際上能做什麼？

32 個工具，涵蓋完整流程：讀取您的帳戶與分析資料、瀏覽和管理您的內容庫、在 Studio 中產生圖片、影片和幻燈片、準備貼文，以及排程或發佈到 10 個平台。內容產生是大多數社群 MCP 伺服器所沒有的功能——它們可以排程內容，但無法建立內容。

它可以在不詢問我的情況下發佈嗎？

只有在您授予它發佈權限時才可以，而且僅限於您所連線工作區中的帳戶。讀取、草擬和產生是分開的權限範圍，因此可以允許某個連線建立整個內容佇列，同時仍然無法將任何內容上線。發佈也要求在每次呼叫時做出明確的發佈或排程決定，而不是預設立即發出。

重試的代理程式會重複發文嗎？

不會。透過 MCP 伺服器的每次寫入都需要冪等金鑰，因此重試的呼叫會解析為同一則貼文，而不是建立第二則。這項保證來自儀表板和 Partner API 所使用的相同後端，而不是助理必須記住要做的事情。

我需要付費方案嗎？

您可以建立免費的 Genviral 帳戶並進行連線。產生媒體會消耗點數，而連線帳戶的限制會跟隨您的方案，因此較重的自動化需求需要付費方案，就像在儀表板中一樣。

我應該使用 MCP 還是 REST API？

當聊天助理在驅動時，請使用 MCP——這是從一句話到排程貼文的最快路徑。當您在撰寫程式碼、執行排程作業，或在 Genviral 之上建置產品時，請使用 Partner REST API 或 Genviral CLI。兩者都使用相同的後端服務，因此沒有任何功能是某一條路徑獨有的。