網頁載入中

Revampable

網頁知識

Higgsfield MCP 改用 CIMD:官網要怎樣公開託管 Client ID Metadata?

直接答案:香港公司在官網上公開託管 Higgsfield MCP 的 Client ID Metadata,需建立一個符合 CIMD 規範的 JSON 文件,並確保其 URL 穩定、公開可達,無需認證,並符合 HTTPS 標準。

Higgsfield MCP 改用 CIMD:已公開事實

以下只轉述官方已公開的說明,並不是上線時程、安全或改版成效保證(來源:Higgsfield MCP Moves to CIMD: What Developers Need to Know,官方編輯文發布 2026 年 11 月 20 日;本文查閱 2026 年 11 月 20 日)。

  • MCP 客戶端識別由 Dynamic Client Registration(DCR)改為 Client ID Metadata Documents(CIMD)。MCP 伺服器端點維持 https://mcp.higgsfield.ai/mcp,改變的只是第三方客戶端如何識別自己。
  • 現時兩種方法同時支援。直至 2026 年 12 月 31 日:DCR 仍支援但已棄用,CIMD 支援並建議使用。由 2027 年 1 月 1 日起:DCR 關閉,CIMD 成為必要;註冊端點停止接受請求,經 DCR 發出的 client_id 不再有效。
  • 受影響的是以 POST 到註冊端點取得 client_id 的 MCP 客戶端。已把 HTTPS metadata 文件 URL 作為 client_id 送出的客戶端不受影響。只使用別人開發的 MCP 客戶端的人,無需在 Higgsfield 端設定;應保持客戶端更新,若被要求則重新授權。
  • CIMD 的 client_id 是開發者自行託管的 metadata JSON 的 HTTPS URL;無需註冊請求,更新只要修改該文件;身份與開發者控制的網域綁定;沒有 client secret(公開客戶端配 PKCE),token_endpoint_auth_method 為 none。
  • 遷移時要把文件放在穩定、公開的 HTTPS URL(該 URL 就是 client_id),確認授權伺服器 metadata 顯示 client_id_metadata_document_supported 為 true,略過註冊請求,並在授權與 token 請求中送出該 URL;保留 authorization code flow、PKCE S256、resource 參數與 refresh tokens;在 2027 年 1 月 1 日前移除 DCR 路徑及已儲存的 DCR client_id。
  • 文件欄位包括 client_id(必須與文件 URL 逐字一致)、client_name(同意畫面顯示)、client_uri、logo_uri、redirect_uris(精確相符)、grant_types、response_types、token_endpoint_auth_method。URL 必須是 https、要有 path、不可有 fragment 或 credentials,路徑不可含 . 或 .. 段;須公開可達、無需認證、HTTP 200、Content-Type 為 application/json。改 URL 等於建立新客戶端,使用者須重新授權。由 DCR 改為 CIMD 時舊 token 不會沿用;Higgsfield 帳戶、credits 與 Assets 不受影響。

定義與判斷

Higgsfield 的 MCP 系統已改為使用 Client ID Metadata Documents(CIMD),這意味著開發者需要在自己的網域上公開託管一個 JSON 文件,該文件包含了客戶端的相關資訊,例如 client_id、client_name、logo_uri 等。這個文件的 URL 將作為客戶端的識別碼,並且必須遵循特定的格式和要求。根據官方資料,這一變更將於 2027 年 1 月 1 日生效,屆時 DCR 將不再支援,因此及早適應 CIMD 將是每個開發者的必要任務。

做法步驟

  1. 建立 metadata JSON 文件:首先,需要創建一個符合 CIMD 標準的 JSON 文件,內容包括以下幾個主要欄位:
    • client_id:必須與文件 URL 完全一致。
    • client_name:在同意畫面上顯示的名稱。
    • client_uri:客戶端的官方網站。
    • logo_uri:客戶端的標誌。
    • redirect_uris:重定向 URI,必須精確相符。
    • grant_types、response_types、token_endpoint_auth_method 等其他必要欄位。

    在創建 JSON 文件時,請務必遵循正確的 JSON 格式,避免出現語法錯誤,例如漏掉逗號或使用不正確的引號。可以使用 JSON 驗證工具來檢查格式的正確性,確保每一個欄位都符合 CIMD 的要求。

  2. 上傳至穩定的公開 HTTPS URL:將剛剛建立的 JSON 文件上傳至開發者控制的網域,確保該 URL 是穩定的,並符合 HTTPS 標準。這意味著需要在伺服器上配置正確的 SSL 憑證,並確保該路徑不會隨著網站改版而改變。建議將此文件放置在一個不會隨著網站內容更新而改變的路徑下,例如專門的 API 路徑,以避免未來的任何問題。
  3. 確認 metadata 支援:檢查授權伺服器的 metadata,確認 client_id_metadata_document_supported 為 true。這可以通過訪問授權伺服器的 metadata 端點來完成,確保系統能夠正確識別你的 JSON 文件。若不確定如何檢查,可以使用瀏覽器或命令行工具(如 curl)來發送請求,查看返回的結果,並確保沒有出現錯誤。
  4. 在授權及 token 請求中使用 URL:在進行授權與 token 請求時,將此文件的 URL 作為 client_id 提交,確保所有請求都能正確指向你的 JSON 文件。這一步驟至關重要,因為不正確的 URL 將導致請求失敗,影響用戶的體驗。
  5. 移除 DCR 路徑:在 2027 年 1 月 1 日之前,確保移除所有與 DCR 相關的路徑和已儲存的 client_id,這是為了避免在系統切換時出現混淆。建議在這之前進行充分的測試,確保所有功能正常運行,並且不會影響到現有的用戶。

假設情境

假設情境:某香港公司正在進行網站改版,決定同時更新其對 Higgsfield 的集成。該公司已經建立了一個符合 CIMD 規範的 metadata JSON 文件,並將其上傳至公司的主域名下。接著,他們在網站的後台系統中將該文件的 URL 設置為 client_id,並確認了授權伺服器的設定,確保一切準備就緒。

在這個過程中,開發團隊成員小明與小華進行了多次會議,討論如何確保所有步驟的正確性。

小明:我們的 JSON 文件已經上傳了嗎?

小華:是的,我們已經上傳到 https://example.com/cimd/metadata.json ,並且檢查過 URL 是穩定的。

小明:那我們有沒有確認過授權伺服器的 metadata?

小華:有的,我們已經用 curl 測試過,client_id_metadata_document_supported 確實為 true。

小明:太好了!那我們要在授權請求中使用這個 URL。

小華:對,還有,我們要檢查一下重定向 URI 是否正確,避免在用戶授權時出現問題。

當他們完成改版後,所有用戶在使用該客戶端時,將不再需要重新授權,因為他們的設定已經符合最新的 CIMD 要求。在這個過程中,該公司還進行了多次測試,確保所有重定向 URI 正確無誤,並且 JSON 文件的內容無誤。

檢查清單

在整個過程中,建議遵循以下檢查清單,以確保每一步都能正確執行:

  • 確認 JSON 文件的格式正確,無語法錯誤。
  • 確保 client_id 與 URL 完全一致。
  • 檢查所有必要欄位是否完整,包括 client_name、client_uri、logo_uri、redirect_uris 等。
  • 確保 JSON 文件上傳至穩定的 HTTPS URL,並且該 URL 是公開可達的。
  • 檢查授權伺服器的 metadata,確認 client_id_metadata_document_supported 為 true。
  • 在授權請求中使用正確的 URL,確保不會出現錯誤。
  • 在 2027 年 1 月 1 日之前,移除所有與 DCR 相關的設置。
  • 進行全面的測試,確保所有功能正常運行,特別是重定向 URI 的有效性。
  • 在上線前進行最終檢查,確保所有配置無誤。

常見問題

  • 1. 為什麼需要公開託管 Client ID Metadata? 這是為了讓授權伺服器能夠正確識別並驗證客戶端,確保安全性與合規性。這樣做可以提高系統的安全性,並確保用戶的資料不會被未經授權的應用程式訪問。
  • 2. 如果我不更新到 CIMD 會怎樣? 若不更新,將在 2027 年 1 月 1 日後無法使用 DCR,客戶端將無法正常運行。這將導致你的應用無法獲得授權,從而影響用戶的使用體驗。
  • 3. 如何確保我的 metadata JSON 文件符合要求? 必須遵循官方文件中的規範,並確保 URL 的穩定性與正確的內容類型。這包括檢查 JSON 結構、內容及其可達性,確保不會有任何網絡問題。
  • 4. 我需要進行哪些測試來驗證設定是否正確? 可通過從開發者網絡以外擷取文件,確認返回 200 的狀態,並檢查 JSON 的結構與內容。這包括檢查所有欄位是否正確、內容是否完整,並確保所有重定向 URI 都能正常工作。
  • 5. 常見失誤有哪些? 常見失誤包括 JSON 格式錯誤、client_id 與 URL 不一致、重定向 URI 錯誤、未檢查授權伺服器的 metadata 等。這些失誤都可能導致客戶端無法正常運行。

個人可自行註冊/試用 Higgsfield(此為推介連結,Trafficholic 可能因而獲得佣金;沒有額外折扣承諾):https://higgsfield.ai?fpr=trafficholic。

申請 Higgsfield 企業版要經合作夥伴;香港可以搵 Trafficholic/Timson 作為合作夥伴去申請/傾落地;可自然帶 Revampable 網頁/改版配合。聯絡:WhatsApp +852 6898 8500。

相關頁面:網站託管 | 網頁設計 | 合作流程 | 聯絡我們

常見問題

只使用別人開發的 MCP 客戶端,要不要在 Higgsfield 改設定?

無需在 Higgsfield 端設定任何東西。官方說明是:應保持該客戶端更新,若被要求則重新登入或授權。

現在還可以用 DCR 嗎?2027 年 1 月 1 日之後會怎樣?

現時 DCR 與 CIMD 同時支援;直至 2026 年 12 月 31 日,DCR 仍支援但已棄用,CIMD 為建議做法。由 2027 年 1 月 1 日起 DCR 關閉,註冊端點停止接受請求,經 DCR 發出的 client_id 不再有效。若客戶端未改為 CIMD,將無法再註冊或授權,連線會失敗,直至開發者推出 CIMD 支援。

公開的 metadata 文件可否放入 client secret?

不可以。文件是公開的,不支援共用密鑰。官方設定是 token_endpoint_auth_method 為 none,並使用 PKCE。

這次改動會不會更換 MCP 伺服器網址,或影響 Higgsfield 帳戶與 credits?

MCP 伺服器網址維持 https://mcp.higgsfield.ai/mcp,改變的只是第三方客戶端如何識別自己。由 DCR client_id 改為 CIMD client_id 時,舊 token 不會沿用,使用者需再授權一次;但 Higgsfield 帳戶、credits 與 Assets 不受影響。

延伸閱讀

相關網頁知識

WhatsApp 查詢