BigValue Real Estate 設定
安裝外掛程式後請確認 MCP 連線狀態,若尚未登入,則引導使用者依客戶端進行登入。
驗證方式為 瀏覽器 Google 登入 (OAuth),而非輸入 API 金鑰。安裝期間無需輸入任何值,首次使用時登入一次即可連線。Token 的儲存與更新由客戶端自行處理。
此技能僅確認狀態與提供指引。不會代為執行登入指令 — 瀏覽器往返需由使用者在互動式終端機中親自完成,以確保流程穩定結束。也不會直接編輯設定檔或憑證檔案。
若僅透過 npx skills add 安裝技能,MCP 連線應遵循入門指引,此技能則可略過。
狀態確認
- 識別目前客戶端。Claude Code 使用
claude plugin list --json與claude mcp list;Codex 使用codex plugin list --json與codex mcp list --json。若需 Shell 權限,請先取得同意。 - 確認外掛
bigvalue-realestate是否已安裝並啟用。 - 檢查 MCP 伺服器
bigvalue-realestate的狀態。未登入前伺服器會拒絕連線,顯示為! Needs authentication;若顯示✔ Connected則表示已登入。為求明確,可呼叫代表性工具一次進行驗證。 - 若僅要求狀態,則以繁體中文回報判斷結果,不做任何變更。
Claude Code 路徑
安裝外掛後,MCP 伺服器會自動註冊。剩下只需登入一次。
無需額外指令 — 首次提出資料相關問題時,客戶端會自動開啟瀏覽器登入頁面。以下是手動路徑:
- 若
claude mcp list顯示! Needs authentication屬正常現象,表示尚未登入。 - 引導使用者執行
/mcp並選擇bigvalue-realestate。瀏覽器會開啟,完成 Google 登入與授權後即可連線。 - 替代方案:可在外部互動式終端機中直接執行
claude mcp login plugin:bigvalue-realestate:bigvalue-realestate。此技能不會代為執行此指令。 - 首次登入後請在新工作階段中確認。登入前啟動的處理程序可能無法讀取認證狀態。
- 若登入帳號不在允許清單中,會顯示「無法連線的帳號」畫面,此時請引導使用者聯絡入職負責人申請帳號許可。
若要在 Claude Desktop 的聊天中使用,請引導使用者使用自訂連接器而非外掛 — 在設定 → 連接器 → 新增自訂連接器中輸入 https://datamarket-mcp.bigvalue.ai/mcp,然後按 Connect,同樣會開啟 Google 登入。
Codex 路徑
Codex 外掛僅包含技能。MCP 需另行註冊並登入。
-
引導使用者在
~/.codex/config.toml中新增伺服器。由於驗證方式預設為 OAuth,無需額外填寫。[mcp_servers.bigvalue-realestate] url = "https://datamarket-mcp.bigvalue.ai/mcp" -
使用者在外部互動式終端機中執行登入。此技能同樣不會代為執行此指令。
codex mcp login bigvalue-realestate -
重新啟動 Codex 的新處理程序。設定與登入狀態不會反映在執行中的處理程序。
-
使用
codex mcp list --json並呼叫代表性工具來確認連線。
驗證
連線完成後,呼叫代表性工具一次以確認回應(例如搜尋園區)。請勿輸出或記錄登入 URL、授權碼或 Token。
安全邊界
- 請勿要求、輸出、複製或記錄登入 URL、授權碼或 Token。瀏覽器往返由使用者負責。
- 修改
~/.codex/config.toml時,僅提供上述片段讓使用者自行套用。不會直接編輯 Claude 設定、憑證檔案或外掛快取。 - 不會移除或修改使用者自行設定的其他 MCP 伺服器或無關的外掛。