企业官网建设流程全解析

目标：只需提供蓝湖Cookie（文档中也称 Token），即可快速拉起lanhu-mcp，并在 Claude/Codex 中调用。

0. Cookie 获取方式

1.登录蓝湖网页，打开开发者工具。

2.进入Network，选择任意Fetch/XHR请求。

3.在Request Headers复制完整Cookie。

1. 3 分钟跑通（安装 + 启动 + 接入）

1.1 先设置路径变量

export PROJECT_DIR="$HOME/path/to/your-project" # 你的业务项目目录 export LANHU_MCP_DIR="$HOME/lanhu-mcp-main" # lanhu-mcp 本地目录

1.2 一次性安装（首次机器执行）

# 基础检查 python3 --version npm -v git --version # 拉取代码 [ -d "$LANHU_MCP_DIR" ] || git clone https://github.com/dsphper/lanhu-mcp.git "$LANHU_MCP_DIR" cd "$LANHU_MCP_DIR" cp -f .env.example .env # 写入蓝湖 Cookie export LANHU_TOKEN='这里替换成你的蓝湖Cookie' if grep -q '^LANHU_COOKIE=' .env; then sed -i '' "s|^LANHU_COOKIE=.*|LANHU_COOKIE=\"${LANHU_TOKEN}\"|" .env else printf '\nLANHU_COOKIE="%s"\n' "${LANHU_TOKEN}" >> .env fi # 安装依赖 python3 -m venv venv source venv/bin/activate python -m pip install -U pip setuptools pip install -r requirements.txt python -m playwright install chromium

1.3 每次启动服务（推荐方式）

cd "$PROJECT_DIR" mkdir -p data/messages export LANHU_COOKIE="$(awk -F'"' '/^LANHU_COOKIE=/{print $2}' "$LANHU_MCP_DIR/.env")" export SERVER_PORT=8000 "$LANHU_MCP_DIR/venv/bin/python" "$LANHU_MCP_DIR/lanhu_mcp_server.py"

启动成功日志应包含：

Uvicorn running on http://0.0.0.0:8000

1.4 接入 Claude/Codex MCP

# Claude claude mcp remove lanhu >/dev/null 2>&1 || true claude mcp add --transport http lanhu "http://localhost:8000/mcp?role=测试&name=Lucas" claude mcp list # Codex codex mcp remove lanhu >/dev/null 2>&1 || true codex mcp add lanhu --url "http://localhost:8000/mcp?role=测试&name=Lucas" codex mcp list

1.5 快速验证

lsof -iTCP:8000 -sTCP:LISTEN -n -Pcodex mcp list

2. 标准流程

第 1 节是最短路径；本节是详细版。若两处文字有重复，统一以本节命令为准。

2.1 环境要求

• git

• Python 3.10+（建议3.11）

• Node.js + npm

2.2 为什么推荐在业务目录启动服务

lanhu-mcp会写入相对路径data/messages。若历史上用过sudo启动，容易出现目录归属为root，导致普通用户写入失败。推荐固定在$PROJECT_DIR启动，并确保：

cd "$PROJECT_DIR"mkdir -p data/messages

Bash

2.3 Cookie 配置约定

• lanhu-mcp实际读取的是.env里的LANHU_COOKIE

• 本文所有“Token”都按 Cookie 字符串处理

写入方式已在1.2给出，后续只需复用1.3里的读取逻辑。

3.lanhu-requirements-docSkill 使用

3.1 Skill 路径

• Claude：<项目根目录>/.claude/skills/lanhu-requirements-doc/SKILL.md

• Claude：<项目根目录>/.claude/skills/lanhu-requirements-doc/template.md

• Codex：$CODEX_HOME/skills/lanhu-requirements-doc/SKILL.md

• Codex：$CODEX_HOME/skills/lanhu-requirements-doc/template.md

3.2 单页面扫描（带pageId）

触发条件：URL 包含docId + product + pageId。

Claude：

/lanhu-requirements-doc https://lanhuapp.com/web/#/item/project/product?...&versionId=...&docId=...&pageId=...

Codex：

$lanhu-requirements-doc https://lanhuapp.com/web/#/item/project/product?...&versionId=...&docId=...&pageId=...

输出文件：需求文档-[项目名]-[页面名]-[YYYYMMDD].md

3.3 全版本页面扫描（不带pageId）

触发条件：URL 包含docId + product，但不带pageId。

Claude：

/lanhu-requirements-doc https://lanhuapp.com/web/#/item/project/product?...&versionId=...&docId=...

Codex：

$lanhu-requirements-doc https://lanhuapp.com/web/#/item/project/product?...&versionId=...&docId=...

如果手里是单页链接但要扫全量，删除 URL中pageId（通常也删掉image_id、parentId）。

3.4 Codex 无 Slash 技能入口时（等价提示词）

请按 <项目根目录>/.claude/skills/lanhu-requirements-doc/SKILL.md 的规则处理以下蓝湖链接： 1) 先判断是邀请链接、PRD单页、PRD全文档还是UI设计； 2) 使用 lanhu MCP 的对应工具读取并分析； 3) 按 <项目根目录>/.claude/skills/lanhu-requirements-doc/template.md 输出完整中文需求文档； 4) 保存为 需求文档-[项目名]-[YYYYMMDD].md（若是单页则带页面名）。 蓝湖链接：<在这里粘贴>

4. 按症状查错（实战版）

5.蓝湖MCP支持

6. 验收清单

• 服务日志出现Uvicorn running on http://0.0.0.0:8000

• claude mcp list可见lanhu

• codex mcp list可见lanhu

• 能用蓝湖链接成功执行一次lanhu-requirements-doc