Framer CLI MCP
概述
透過託管的 framer-cli-mcp 遠端 MCP 端點控制 Framer 專案。它包裝了官方的 @framer/agent CLI（Node 24），並為每個執行緒使用該執行緒自己的 Framer 專案 API 金鑰進行授權。
端點：https://framer-cli-mcp.onrender.com/mcp
健康檢查：https://framer-cli-mcp.onrender.com/healthz
無需 Bearer Token。
關於此伺服器：官方 @framer/agent CLI v0.0.46（Node 24，Docker）；無狀態的 Streamable HTTP MCP 端點；每個專案獨立 API 金鑰（無共用伺服器金鑰）；CLI 作為無 Shell 的子程序以序列化方式執行；專案憑證存放在限制權限的暫存 /tmp 目錄中；Render Free 方案（新加坡節點，空閒時休眠，重新啟動後檔案系統重置）；原始碼與技能託管於 https://github.com/shifatmasud/framer-cli-mcp；每次推送到 main 分支會自動部署至 Render。
每個專案的規則
每個執行緒僅處理一個 Framer 專案。
- 為每個專案建立一個新的執行緒。
- 向使用者索取該執行緒的專案連結：
- 瀏覽器：複製已開啟專案的網址列。
- 應用程式：在專案標籤頁上按右鍵，然後選擇「複製專案連結」。
- 向使用者索取該專案的 API 金鑰（位於網站設定 → 一般 → API 金鑰）。
- 使用該執行緒的
projectUrlOrId和projectApiKey呼叫一次framer_project_auth。 - 在相同執行緒中，後續所有任務都重複使用已建立的託管工作階段。
切勿在不同 Framer 專案之間重複使用同一個執行緒、工作階段或 API 金鑰。如果 Render 免費實例重新啟動，請在該執行緒中再次呼叫 framer_project_auth。
工作流程
- 在索取憑證之前，先呼叫
framer_setup_guide並依照其每個專案的腳本操作。 - 使用
framer_project_auth授權該執行緒的專案。 - 使用
framer_session_new建立一個工作階段，並在整個執行緒中重複使用該工作階段 ID。 - 如需方法、查詢、DSL 格式及安全規則的詳細資訊，請參閱 Framer 工具參考。
- 如需部署、代管、環境變數及疑難排解的資訊，請參閱 代管參考。
- 僅在該執行緒的 Framer 工作完成後，才使用
framer_session_destroy銷毀工作階段。
驗證範例
在每個執行緒中先呼叫 framer_project_auth。將佔位符替換為該執行緒的專案連結以及該專案在網站設定 → 一般 → API 金鑰中的金鑰。
{
"projectUrlOrId": "https://framer.com/projects/PASTE_THIS_THREADS_PROJECT_ID--abc123",
"projectApiKey": "PASTE_THIS_PROJECTS_API_KEY"
}
預期結果：託管的 CLI 會儲存該專案的憑證（相當於 project auth <projectUrlOrId> <apiKey>），因此後續在同一個執行緒中的呼叫可以省略 projectApiKey。然後建立可重複使用的工作階段：
{
"projectUrlOrId": "https://framer.com/projects/PASTE_THIS_THREADS_PROJECT_ID--abc123"
}
工具選擇
framer_setup_guide：先閱讀伺服器的每個專案設定腳本。framer_project_auth：在使用任何其他工具之前，先授權此執行緒的專案。framer_session_new：建立此執行緒可重複使用的工作階段。framer_exec：當沒有更精確的工具適用時，透過 Framer 代理執行 JavaScript。framer_apply_changes：偏好用於頁面、版面、樣式、CMS 畫布、元件及設計 Token 的編輯。framer_read_project：查詢字型、指南、螢幕截圖及其他支援的專案資料。framer_session_destroy：完成工作後關閉此執行緒的工作階段。
安全性
- 僅對使用者有權編輯的專案進行操作。
- 在編輯前，偏好先進行讀取與審查。
- 對於使用者未明確要求的破壞性或未發佈變更，需先確認。
- 切勿在需要 API 金鑰的工具呼叫之外，要求或儲存 API 金鑰。