用途：这是一个面向操作者（operator）的准备型技能，用于让代理把一台机器配置好，使任意 MCP 主机都能配合 SideFX Houdini 使用 dcc-mcp-houdini。它不是 Houdini 运行时技能，不应通过 Houdini MCP 服务器加载，而应从仓库检出目录运行，或把步骤抄入其他代理的指令中。若用户要求参考 dcc-mcp/dcc-mcp-houdini/install.md 安装，应先读根目录 install.md 再按本技能执行。
目标结果：把 dcc-mcp-houdini 及其 pip 依赖装入目标 Houdini 的 hython 环境；生成指向 Houdini MCP 服务器的 MCP 主机配置片段；引导用户安装 Houdini 包，使 scripts/123.py 自动启动服务器（或从 hython 手动启动）；最后用一次真实冒烟提示验证代理能发现并调用 Houdini 工具。
快速路径：在仓库根目录运行 python skills/dcc-mcp-houdini-setup/scripts/setup_dcc_mcp_houdini.py。该脚本会从 --hython、HYTHON、DCC_MCP_HOUDINI_HYTHON、PATH 或常见 Side Effects Software 安装位置查找 hython；用 hython -m pip install -e . 把当前检出装入 Houdini（dcc-mcp-houdini 不定义运行时 extra，dcc-mcp-core 会自动引入）；验证 import dcc_mcp_houdini；并把可复用的 MCP JSON 片段和冒烟提示写到 .dcc-mcp/agent-setup/ 下。为最终用户机器配置时可改用 PyPI：python skills/dcc-mcp-houdini-setup/scripts/setup_dcc_mcp_houdini.py --source pypi。若查找失败，向用户询问完整 hython 路径后重跑并加 --hython "<路径>"。
MCP 配置：Houdini 123.py 自启动钩子默认在直连端口启动内嵌 MCP 服务器，主机配置为 {"mcpServers": {"houdini": {"url": "http://127.0.0.1:9765/mcp"}}}。仅在多个 Houdini 会话位于自动网关（DCC_MCP_GATEWAY_PORT=9765）后面时才使用该地址。修改已有 MCP 配置时应保留无关服务器，除非用户另有要求，只合并 houdini 条目。
用户交接：pip 安装和 MCP JSON 生成后，需告知用户让服务器随 Houdini 启动，推荐使用随附 Houdini 包（快速安装 ZIP 的 install.ps1 / install.sh，或指向包根的 dcc_mcp_houdini.json 包文件）。该包把 scripts/ 加入 HOUDINI_PATH；启动时 123.py 将内置 wheel 解压到 vendor/ 并启动 MCP 服务器。启动 Houdini 后从控制台查看 OS 分配的确切实例 URL；代理通常通过 9765 上的稳定网关连接。若改为手动 hython 会话运行，可用 import dcc_mcp_houdini；server = dcc_mcp_houdini.start_server()；print(server.mcp_url) 取得直连端点。设置 DCC_MCP_HOUDINI_AUTOSTART=0 可禁用包自启动。
首次冒烟提示：在 Houdini 已打开且服务器运行后，让 MCP 主机执行：先调用 dcc_capability_manifest（loaded_only=false），再加载 houdini-nodes 技能，在 /obj 下创建名为 mcp_setup_smoke_geo 的 geo 节点，列出 obj 级节点，并报告 MCP URL 与创建的节点路径；优先用类型化工具，避免 execute_python。预期：代理发现能力、加载技能、以 parent_path=/obj、node_type=geo、node_name=mcp_setup_smoke_geo 调用 houdini_nodes__create_node，新节点出现在场景中，并由 houdini_scene__list_obj_nodes 确认。
排错：找不到 hython 时询问确切版本与 bin/hython 路径并用 --hython；pip 引导失败先运行 hython -m ensurepip --upgrade 再重试；连接被拒通常是 Houdini 未运行、自启动被禁用或 9765 网关未运行，可用 dcc-mcp-cli list 查看直连 URL；工具缺失时调用 dcc_capability_manifest 或 search_skills，再 load_skill("<skill-name>")；自启动无声时检查 Houdini 控制台的失败信息并确认包 JSON 指向正确包根。