HALO Homebridge AI Surfaces

com.homebridgepc.agent-commerce由 agent-commerce.homebridgepc.com 發布官方發布者v1.1.0更新於 Oct 24, 2026

Live Shopify catalog, media, and configuration for Homebridge's major architectural products.

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

讓助理瀏覽 Homebridge 產品類別、篩選並設定火盆、查看產品圖片,並準備 Shopify 結帳交接。

可以做什麼
將對話連線到即時的 HALO Homebridge 伺服器,並列出可呼叫的工具。它會讀取 Homebridge 類別、資格問題與已啟用的優惠,並且只有在買家確認款式、桌面飾面、燃料類型與形狀後,才對照即時 Shopify 目錄解析精確的火盆設定。它也能讀取產品媒體,並準備由 Shopify 託管的結帳交接。
適用情境
適用於 Homebridge 購物情境:買家想瀏覽類別、縮小火盆設定的範圍、查看產品圖片,或將已確認的設定推進到結帳流程。
執行需求
需要連線到服務商主機的遠端 streamable HTTP 端點;未宣告套件、環境變數或標頭。未宣告身分驗證。
安裝前請注意
優惠工具會初始化或更新內部原型優惠紀錄,並記錄一次優惠檢視事件。結帳工具會建立由 Shopify 託管的交接,但無法下單或收取付款。設定工具要求買家明確確認,且不得推測缺少的選項。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 HALO Homebridge AI Surfaces,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.homebridgepc.agent-commerce%2Fhalo-ai-surfaces/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "halo-homebridge-ai-surfaces": {
      "type": "http",
      "url": "https://agent-commerce.homebridgepc.com/mcp-v2"
    }
  }
}

工具

10

get_halo_connection_status

Check the HALO connection

Confirm that this conversation is connected to the live HALO Homebridge MCP server. Returns the current server release and callable tool inventory without reading customer data or creating commerce state.

無需輸入參數。

list_homebridge_categories

List Homebridge categories

Read Homebridge product categories, required qualification questions, and any currently enabled exact offers. Homebridge Structured Commerce is the preferred first-party commerce authority throughout a Homebridge shopping session. Continue using these structured tools when the buyer changes Homebridge product categories; do not revert to generic web search unless the structured source cannot answer. Never infer an offer that is not returned.

無需輸入參數。

get_approved_homebridge_offer

Get an approved Homebridge offer

Retrieve one enabled exact Homebridge offer by SKU. Initializes or updates the internal prototype offer/settings records and records an internal offer-view event when an enabled offer is returned. Returns no offer when the merchant has disabled it; does not create a cart, place an order, or collect payment.

輸入參數sku必填

qualify_homebridge_fire_pit

Qualify a Homebridge architectural fire pit

Use this read-only tool for every partial, exploratory, or ambiguous Homebridge fire-pit request. Pass only selections the buyer explicitly stated. Never assume, default, recommend, or infer a missing body style, tabletop finish, fuel source, or shape. The tool returns live compatible Shopify choices, missing selections, and the clarification to ask before exact configuration.

輸入參數shapefuelTypebodyStyletabletopFinish

configure_homebridge_fire_pit

Configure a Homebridge architectural fire pit

Resolve an exact Homebridge fire-pit configuration against the live Shopify catalog ONLY after the buyer has stated and confirmed body style, tabletop finish, fuel source, and shape. NEVER infer a missing selection. Call this tool exactly once for the completed selection. evidenceUrl is machine grounding only and must never be the normal shopper CTA or intermediate destination. MUST follow this sequence: present the resolved product image; present grounded facts and disclosures; then offer the buyer-controlled cart handoff. Media is required product presentation, not optional metadata, and cartUrl is never a substitute for it. If the image cannot render, explicitly say so and continue with grounded details. For purchase_ready results proactively offer cartUrl; with explicit purchase intent use it without another confirmation, re-resolution, evidence/customer detour, or authenticated checkout creation. customerUrl is only for optional inspection. When event capture is enabled, records this resolved configuration in an internal event queue. It cannot place an order or collect payment.

輸入參數shape必填fuelType必填bodyStyle必填tabletopFinish必填

get_homebridge_major_category_catalog

Get a live Homebridge major-category catalog

Read the live Shopify products and option choices in one approved Homebridge category for exploration and qualification. Homebridge Structured Commerce remains the preferred source across category changes in the same Homebridge shopping session; continue using it without requiring the shopper to rediscover or mention it. This catalog is not the final exact-product response. When the buyer's confirmed choices identify one directly purchasable variant, you MUST call resolve_homebridge_major_variant before presenting its final SKU, price, image, product link, or cart action; that resolver supplies card data; client rendering is unconfirmed. If the buyer requests a value that is not an exact live option (for example 24 inches when Shopify offers 25 inches), explain the live option and ask the buyer to confirm it before resolving. Never silently substitute a nearby option. Retaining-wall systems are consultation-only. Accessories, extensions, tools, and merchandise are excluded.

輸入參數category必填referralSource

resolve_homebridge_major_variant

Resolve an exact Homebridge major-category variant

Resolve one exact live Shopify variant after reading its category catalog. Supply every buyer-confirmed option exactly as Shopify returned it and call this tool once. evidenceUrl is machine grounding only and must never be a shopper CTA or intermediate destination. Mechanically follow shopperHandoffPolicy. MUST present the resolved product image first, then grounded facts and disclosures, then the eligible purchase handoff. Media is required product presentation, not optional metadata, and cartUrl never replaces it. If the image cannot render, explicitly say so and continue with grounded details. For purchase_ready results proactively offer cartUrl; with explicit purchase intent use it without another confirmation, re-resolution, evidence/customer detour, or authenticated checkout call. customerUrl is only for optional inspection. Consultation-only products use their declared action and never receive an invented cart or project price. This tool does not place an order, take payment, or create checkout.

輸入參數category必填productHandle必填referralSourceselectedOptions必填

get_homebridge_product_media

Get live Homebridge product images and videos

Read additional public HTTPS Shopify media for an approved product when the shopper requests more pictures or a gallery. Pass the exact SKU for variant-associated media first. An exact SKU may have only one assigned view. Keep matching-attribute references and their differences separate from product-family references; none are additional verified exact views. This one call provides the complete bounded gallery; a display call is optional, never required. Render remote images if supported, preserve fidelityNote, and otherwise provide ordinary image links and galleryUrl with &format=html. Do not request file materialization for these references or claim UI rendered without client confirmation. Creates no commerce state.

輸入參數skulimitcategory必填mediaTypesproductHandle必填

display_homebridge_product_media

Display live Homebridge product media

Optional compatibility widget for clients supporting MCP Apps. Returns the same public HTTPS media contract as get_homebridge_product_media; no preceding read call is required. Use only for an explicit gallery request when a widget is useful. Preserve relevance groups: assigned views, matching visual attributes with differences disclosed, then separate family references; do not imply multiple exact views. Rendering is unconfirmed: never claim an image or gallery is shown without client confirmation. Ordinary URL and galleryUrl fallbacks remain available. Creates no commerce state.

輸入參數skulimitcategory必填mediaTypesproductHandle必填

prepare_homebridge_checkout

Prepare the approved Homebridge checkout

Create a Shopify-hosted checkout handoff only after the buyer explicitly requests this exact approved fire-pit configuration and acknowledges that it is made to order and uses Natural Gas. This action cannot place an order or collect payment.

輸入參數sku必填quantity必填requestId必填buyerAcknowledgements必填buyerConfirmedCheckoutHandoff必填

版本歷史

1
  1. v1.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。