BigValue Real Estate 设置 是做什么的?
插件安装后,先检查 MCP 连接状态;如果尚未登录,则根据客户端指导相应的登录方法。
认证方式不是 API 密钥输入,而是浏览器 Google 登录(OAuth)。安装时无需输入任何值,首次使用时登录一次即可连接。令牌的保存和刷新由客户端自行处理。
此技能仅检查状态并给予指导。不会代执行登录命令——浏览器往返需要用户在交互式终端中亲自完成,才能稳定结束。也不会直接编辑配置文件或凭据文件。
如果仅通过 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 的聊天中使用,请引导用户使用自定义连接器而非插件——在 Settings → Connectors → Add custom connector 中输入 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、授权码或令牌。
安全边界
- 不请求、输出、复制或记录登录 URL、授权码或令牌。浏览器往返由用户自行处理。
- 对
~/.codex/config.toml的修改仅提供上述片段,由用户自行更新。不要直接编辑 Claude 设置、凭据文件或插件缓存。 - 不要移除或更改用户自行配置的其他 MCP 服务器或无关插件。