直接答案:香港公司在官網上公開託管 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 將是每個開發者的必要任務。
做法步驟
- 建立 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 的要求。
- 上傳至穩定的公開 HTTPS URL:將剛剛建立的 JSON 文件上傳至開發者控制的網域,確保該 URL 是穩定的,並符合 HTTPS 標準。這意味著需要在伺服器上配置正確的 SSL 憑證,並確保該路徑不會隨著網站改版而改變。建議將此文件放置在一個不會隨著網站內容更新而改變的路徑下,例如專門的 API 路徑,以避免未來的任何問題。
- 確認 metadata 支援:檢查授權伺服器的 metadata,確認 client_id_metadata_document_supported 為 true。這可以通過訪問授權伺服器的 metadata 端點來完成,確保系統能夠正確識別你的 JSON 文件。若不確定如何檢查,可以使用瀏覽器或命令行工具(如 curl)來發送請求,查看返回的結果,並確保沒有出現錯誤。
- 在授權及 token 請求中使用 URL:在進行授權與 token 請求時,將此文件的 URL 作為 client_id 提交,確保所有請求都能正確指向你的 JSON 文件。這一步驟至關重要,因為不正確的 URL 將導致請求失敗,影響用戶的體驗。
- 移除 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。