連接 MCP 用戶端

Bannerify 在 https://api.bannerify.co/mcp 執行 Model Context Protocol（MCP）伺服器。本頁適合使用 Claude、Cursor 或 VS Code 等 AI 助理，並希望助理使用自己 Bannerify 範本的人。伺服器連接之後，助理可以：

• 列出你的範本，以及每個範本中可以變更的圖層。
• 從範本生成圖片或 PDF。
• 在沒有合適範本時，用形狀組合出一次性的圖片。

開始之前

• 一個 Bannerify 帳號。範本工具至少需要一個範本；用形狀組合圖片則不需要。
• 支援透過 HTTP 連線遠端伺服器，並支援 OAuth 登入的 MCP 用戶端。

新增伺服器

伺服器網址是 https://api.bannerify.co/mcp，使用 Streamable HTTP 傳輸。儀表板中的 Agents & MCP 頁面會針對每個用戶端顯示相同的設定步驟，並提供複製網址和指令的按鈕。

claude mcp add --transport http bannerify https://api.bannerify.co/mcp

{
  "mcpServers": {
    "bannerify": {
      "type": "http",
      "url": "https://api.bannerify.co/mcp"
    }
  }
}

{
  "mcpServers": {
    "bannerify": {
      "url": "https://api.bannerify.co/mcp"
    }
  }
}

{
  "servers": {
    "bannerify": {
      "type": "http",
      "url": "https://api.bannerify.co/mcp"
    }
  }
}

codex mcp add bannerify --url https://api.bannerify.co/mcp
codex mcp login bannerify

若是其他用戶端，請輸入相同的網址，並選擇使用 OAuth 登入的 HTTP 傳輸。

登入

用戶端第一次連線時還沒有權杖，所以 Bannerify 會把它導向登入頁面。用戶端會在瀏覽器中開啟該頁面。登入之後，你要選擇用戶端可以使用的工作區。用戶端會保存權杖，並在每個請求中一併傳送。你不需要建立 API 金鑰，也不需要複製權杖。

整個交換過程分為四個步驟：

1. 用戶端不帶權杖，向 https://api.bannerify.co/mcp 傳送請求。伺服器回應 HTTP 401，以及一個 WWW-Authenticate 標頭，指向位於 https://api.bannerify.co/.well-known/oauth-protected-resource/mcp 的中繼資料。
2. 中繼資料會指出登入服務，用戶端便會帶你前往該處。
3. 你登入 Bannerify。同意頁面會顯示用戶端的名稱，以及它把權杖傳送到哪裡。選擇你的 Personal 工作區或某個團隊工作區，然後點選 Allow。
4. 用戶端取得存取權杖，並在每個請求中以 Authorization: Bearer <token> 傳送。Bannerify 會檢查權杖是否有效、是否未過期，以及是否是為 MCP 網址所簽發。

請求檔案

用平常的方式告訴助理你要什麼：

列出我的 Bannerify 範本，以及每個範本的圖層。

用我的 "Lifecycle email" 範本建立一張 PNG。把 headline 設為 "Welcome back, An"，qr 圖層設為 https://example.com/restart。

用我的發票範本，為 Acme Studio 建立一份 PDF。

設計一張 1200 × 630 的橫幅，深色背景，文字是 "Launch week"，然後把圖片給我看。

我的 Bannerify 工作區使用哪個方案？

助理會從用 MCP 工具生成檔案中挑選需要的工具、繪製檔案，並把結果顯示給你。

用量與限制

從 MCP 用戶端生成的檔案，與 REST API 和 SDK 計入相同的每月與每日上限，並套用所連接工作區的方案。

失敗的繪製不會計算。Free 方案的團隊工作區無法生成檔案，新的團隊工作區則從為期 14 天的 Automate 3k 試用開始。MCP 伺服器沒有請求速率限制。各方案的上限請見用量額度與限制。

中斷連線

請從你的 MCP 用戶端移除伺服器，或在 Claude 中移除連接器。用戶端會停止傳送權杖，而權杖在過期後就會失效。

疑難排解

瞭解更多

• 用 MCP 工具生成檔案
• 用量額度與限制
• 從終端機生成