下载并解压
下载最新版 Codex Marketplace 安装包并完整解压。推荐解压到 C:\tk-data；确认电脑中存在目录 C:\tk-data\tk-data-marketplace。当前修复版本：0.1.0+codex.20260716191056。
CODEX · MCP · SKILL
用一个 KEY，连接你的
TK 业务数据
验证管理员提供的连接 KEY，随后按页面指引连接 Codex。数据权限、Skill 和分析能力由服务器持续更新。
01
验证连接 KEY
只需输入管理员提供的一个 KEY。系统会自动识别用户和数据权限，KEY 不会保存在浏览器本地存储中。
✓
KEY VALID
授权验证成功
WindowsPOWERSHELL
推荐 · 一键安装
只复制并执行这一条命令
在 PowerShell 中粘贴运行。系统会自动完成下载、校验、解压、插件安装、MCP 注册和安装检查；浏览器打开后，再输入刚才验证的同一个 KEY。
KEY 不会写入命令或 PowerShell 历史记录。授权成功后，完全退出并重新打开 Codex 即可使用。
macOS终端 · TERMINAL
推荐 · 苹果一键安装
只复制并执行这一条命令
在苹果电脑的“终端（Terminal）”中粘贴运行。系统会自动完成下载、SHA256 校验、解压、插件安装、MCP 注册和安装检查；浏览器打开后，再输入刚才验证的同一个 KEY。
KEY 不会写入命令或终端历史记录。授权成功后，按 Command + Q 完全退出 Codex，再重新打开并新建任务。
苹果已安装过旧版本？可以运行上方命令覆盖安装；完整安装会移除旧 MCP 并重新授权，因此必须使用本页刚验证且尚未使用的新 KEY。
下方带有 C:\tk-data 路径的 7 步手动说明仅适用于 Windows；苹果安装遇到错误时，请保留终端中的完整错误提示。
安装成功后 · HOW TO USE
在 Codex 中开始使用 TK 数据
安装器显示绿色成功提示后，按下面三步操作。无需填写数据库地址，也不需要再次输入 KEY。
01 · 重启 Codex完全关闭 Codex，再重新打开。
02 · 新建任务不要继续使用安装前已经打开的旧任务。
03 · 直接提问Codex 会自动调用 TK Data Skill 和 MCP。
检查 TK 数据连接并列出我可以访问的店铺查看我最近 30 天所有店铺的视频表现找出 GMV 最好的视频并分析 Hook、商品知识和转化原因查看视频 7638077324210031885 的原视频并分析已安装过旧版本？直接运行上方一键安装命令即可。它会移除旧的 TK Data 注册并安装当前版本；旧的 C:\tk-data 文件夹可以在安装成功后手动删除。
一键安装失败？展开查看手动安装（7 步）
添加 Marketplace
打开 PowerShell，执行下面命令。如果解压到了其他位置，请替换命令中的路径。
codex plugin marketplace add C:\tk-data\tk-data-marketplace看到 Added marketplace: tk-data-team 表示这一步成功。注意：这时只是添加了安装源，插件还没有安装。
安装 TK 插件
继续在同一个 PowerShell 窗口执行：
codex plugin add tk-data@tk-data-team命令执行后返回 PowerShell 提示符且没有错误，即可继续确认。
确认安装结果
执行确认命令：
codex plugin list列表中应看到 tk-data@tk-data-team、状态 installed, enabled、版本 0.1.0+codex.20260716191056。如果只看到 Added marketplace，请返回第 03 步安装插件。
注册 MCP 并授权
继续在 PowerShell 执行下面这一条完整命令。它会注册 TK 数据接口并自动打开浏览器授权页；只需输入本页验证过的同一个 KEY。
codex mcp add tk-data --url https://data.taomaiyd.com/mcp/v1 --oauth-client-id codex-public --oauth-resource https://data.taomaiyd.com/mcp/v1KEY 只能使用一次。浏览器显示授权成功、PowerShell 返回登录成功后，再继续下一步。
确认 MCP 连接
执行：
codex mcp list应看到名为 tk-data 的服务器，状态为启用且 OAuth 已登录。
重启并测试连接
完全退出 Codex 后重新打开并新建任务，先发送：“检查 TK 数据连接并列出我可以访问的店铺”。能够返回店铺范围即表示 MCP、Skill 和权限均已生效。随后可以继续说：
- “查看我最近 30 天所有店铺的视频表现”
- “找出 GMV 最好的视频并分析 Hook”
- “查看视频 7638077324210031885 的原视频并分析”
常见问题命令提示找不到路径：检查压缩包是否完整解压，以及是否多套了一层同名目录。插件存在但没有 TK 查询工具：确认已完成第 05 步的
codex mcp add 和 OAuth 授权。KEY 提示已使用或过期：请管理员吊销旧 KEY 并生成新的 Enrollment KEY。MCP ENDPOINT
服务端自动更新 Skill 与数据能力卸载 Codex 对接
以下操作会让 Codex 停止访问 TK 数据。依次在 PowerShell 中执行：
codex plugin remove tk-data@tk-data-teamcodex plugin marketplace remove tk-data-teamcodex mcp remove tk-data最后联系管理员在后台吊销该用户的 Enrollment Code、OAuth 会话或服务凭据。
macOS 卸载终端 · TERMINAL
苹果卸载 / REMOVE ON macOS卸载苹果电脑上的 Codex 对接
以下操作会让 Codex 停止访问 TK 数据。依次在苹果电脑的终端中执行：
codex plugin remove tk-data@tk-data-teamcodex plugin marketplace remove tk-data-teamcodex mcp remove tk-data如需同时删除本地安装文件，再执行下面这条命令。它只删除本安装器创建的 TKData 目录：
rm -rf "$HOME/Library/Application Support/TKData"最后按 Command + Q 完全退出 Codex，并联系管理员在后台吊销该用户的 Enrollment Code、OAuth 会话或服务凭据。