# ================================
# YAPI MCP PRO 配置模板
# ================================
# 📝 说明：将此文件复制为 .env 并填写您的实际配置
# 🔒 重要：.env 文件包含敏感信息，不会被提交到Git仓库
# ====================================
# 必填配置项
# ====================================
# YApi 服务器地址（必填）
# 示例：http://yapi.yourcompany.com
YAPI_BASE_URL=http://your-yapi-server.com
# 认证信息（必填，选择以下一种方式）
#
# ============================================
# 方式一：Cookie认证（推荐⭐）
# ============================================
# 优势：自动发现所有项目，权限完整，配置简单
#
# 🔍 获取步骤：
# 1. 打开浏览器，登录您的YApi系统
# 2. 按 F12 打开开发者工具
# 3. 切换到 "Network"（网络）面板
# 4. 在YApi页面中操作任意功能（如刷新页面、点击项目）
# 5. 在网络请求列表中，点击任意一个请求
# 6. 在右侧详情中找到 "Request Headers"（请求头）
# 7. 找到 "Cookie:" 这一行，复制整个Cookie值
#
# 🔑 Cookie格式示例：
# YAPI_TOKEN=_yapi_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MTQxMywibmFtZSI6Imd1b2NvbmciLCJpYXQiOjE3MDM3NjE5NzR9.xxx; _yapi_uid=YOUR_USER_ID; other_cookies=values
#
# ⚠️ 重要：必须包含 _yapi_token 和 _yapi_uid 两个关键字段！
#
# ============================================
# 方式二：Token认证
# ============================================
# 优势：长期有效，更安全，适合自动化场景
#
# �� 获取步骤：
# 1. 登录YApi，进入要管理的项目
# 2. 点击项目 "设置" → "Token配置"
# 3. 如果没有Token，点击"生成Token"
# 4. 复制项目ID（URL中/project/后面的数字）和生成的Token
#
# 🔑 Token格式示例：
# 单个项目：YAPI_TOKEN=YOUR_PROJECT_ID:YOUR_PROJECT_TOKEN
# 多个项目：YAPI_TOKEN=YOUR_PROJECT_ID:token1,123:token2,789:token3
# 格式说明：项目ID:项目Token,项目ID:项目Token,...
#
# 📍 项目ID获取方法：
# - 进入项目后，浏览器地址栏显示：http://yapi.xxx.com/project/YOUR_PROJECT_ID/interface/api/123
# - 其中 YOUR_PROJECT_ID 就是项目ID
#
YAPI_TOKEN=
# ====================================
# 可选配置项（有默认值）
# ====================================
# MCP服务端口，默认 3388
PORT=3388
# 缓存时效（分钟），默认 10
YAPI_CACHE_TTL=10
# 日志级别：debug, info, warn, error，默认 info
YAPI_LOG_LEVEL=info
# 是否启用缓存，默认 true
YAPI_ENABLE_CACHE=true
# 默认分组ID（创建项目时使用，可选）
# YAPI_GROUP_ID=YOUR_GROUP_ID
# ====================================
# 📖 详细操作指南
# ====================================
#
# 🍪 Cookie认证详细操作（推荐）：
#
# 步骤1：登录YApi并打开开发者工具
# - 访问您的YApi网站并登录
# - 在YApi页面按 F12 键打开开发者工具
#
# 步骤2：打开网络面板
# - 点击开发者工具顶部的 "Network" 或 "网络" 标签
# - 确保网络面板处于记录状态（红色圆点）
#
# 步骤3：触发网络请求
# - 在YApi页面中进行任意操作：
# * 刷新页面（Ctrl+R 或 Cmd+R）
# * 点击任意项目
# * 点击任意接口
#
# 步骤4：查看请求详情
# - 在网络面板的请求列表中，点击任意一个请求
# - 在右侧或下方的详情面板中，找到 "Headers" 标签
# - 在 "Request Headers" 部分找到 "Cookie" 字段
#
# 步骤5：复制Cookie值
# - 复制 "Cookie:" 后面的完整内容
# - 粘贴到上面的 YAPI_TOKEN= 后面
#
# 🔑 Token认证详细操作：
#
# 步骤1：进入项目设置
# - 登录YApi并进入要管理的项目
# - 点击项目名称右侧的 "设置" 按钮
#
# 步骤2：配置Token
# - 在设置页面找到 "Token配置" 选项
# - 如果没有Token，点击"生成Token"按钮
# - 复制生成的Token字符串
#
# 步骤3：获取项目ID
# - 查看浏览器地址栏
# - URL格式：http://yapi.xxx.com/project/[项目ID]/interface/...
# - 记录项目ID数字
#
# 步骤4：组合配置
# - 格式：项目ID:Token
# - 示例：YOUR_PROJECT_ID:YOUR_PROJECT_TOKEN
# - 多项目用逗号分隔：YOUR_PROJECT_ID:token1,123:token2
#
# ✅ 配置完成后的测试：
# 1. 保存 .env 文件
# 2. 运行：npm run build
# 3. 运行：./start-mcp.sh start
# 4. 查看日志：./start-mcp.sh logs
# 5. 确认看到 "Cookie认证模式" 或 "Token认证模式" 的提示
