npx @larksuite/cli@latest install   # 或 npm i -g @larksuite/cli
lark-cli config init                # 配置应用凭证（交互式）
lark-cli auth login --recommend     # 浏览器授权，按业务域授权也可：
                                    # lark-cli auth login --domain docs,drive,base,sheets
lark-cli auth status                # 确认登录态

git clone <repo> feishu_mcp && cd feishu_mcp
npm install && npm run build

{
  "mcpServers": {
    "feishu": {
      "command": "node",
      "args": ["D:/projects/feishu_mcp/dist/index.js"]
    }
  }
}

node dist/index.js   # 需要以下环境变量

{
  "mcpServers": {
    "feishu": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer <MCP_HTTP_TOKEN 的值>" }
    }
  }
}

https://mcp.example.com/mcp?token=<MCP_HTTP_TOKEN 的值>

# 1. 修改 docker-compose.yml 中的 MCP_HTTP_TOKEN
docker compose up -d --build

# 2. 首次登录（一次性）：容器内无系统密钥链，lark-cli 回落为文件存储（挂载在 volume 中持久化）
docker exec -it feishu-mcp lark-cli config init
docker exec -it feishu-mcp lark-cli auth login --domain docs,drive,base,sheets
# 按提示在本地浏览器打开授权链接确认即可（无需在服务器开浏览器）

# 3. 重启后登录态仍在（凭证已持久化到 volume）
docker compose restart

# 构建产物上传到 /opt/feishu-mcp（或服务器上 git clone 后 npm install && npm run build）
sudo cp deploy/feishu-mcp.service /etc/systemd/system/
sudo cp deploy/feishu-mcp.env /opt/feishu-mcp/deploy/ && sudo chmod 600 /opt/feishu-mcp/deploy/feishu-mcp.env
# 编辑 env 中的 MCP_HTTP_TOKEN 等配置
sudo systemctl daemon-reload && sudo systemctl enable --now feishu-mcp

sudo -u <运行用户> lark-cli config init
sudo -u <运行用户> lark-cli auth login --domain docs,drive,base,sheets
# 无桌面环境时如连接中断，可用官方断点续登：
#   lark-cli auth login --domain docs --no-wait   # 记下 device code 与 URL
#   lark-cli auth login --device-code <DEVICE_CODE>

# stdio 冒烟测试（工具清单 + 登录态 + 真实搜索）
node scripts/smoke-stdio.mjs all

# 写读全链路校准（会在云空间创建"【MCP校准-可删除】"测试文件）
node scripts/calibrate.mjs docs    # 文档 create→read→append→replace_text→overwrite
node scripts/calibrate.mjs sheet   # 电子表格读取
node scripts/calibrate.mjs base    # 多维表格 describe + 读记录
BASE_TOKEN=<token> node scripts/calibrate.mjs basewrite      # 多维表格写记录
SHEET_TOKEN=<token> node scripts/calibrate.mjs sheetwrite    # 电子表格写