Agent 接入
连接你的 Agent
通过你的 Agent 运行同一套 Shopify CSV 检查。
选择客户端
使用本地客户端时,先打开项目副本并安装 Node.js 22 或更高版本。把两处示例路径分别换成 Node 可执行文件和服务端文件的绝对路径。
Codex
本地 · stdio在终端运行此命令,然后重新启动 Codex。
codex mcp add catalog_preflight -- "/absolute/path/to/node" "/absolute/path/to/catalog-preflight/src/agent.mjs"
Claude Code
本地 · stdio运行此命令,将服务添加到当前用户。打开新的 Claude Code 会话,输入 /mcp 检查连接。
claude mcp add --transport stdio --scope user catalog_preflight -- "/absolute/path/to/node" "/absolute/path/to/catalog-preflight/src/agent.mjs"
Cursor
本地 · stdio在项目的 .cursor/mcp.json 中添加此服务,保留已有的服务条目。重新加载 Cursor,然后查看 MCP 设置。
{
"mcpServers": {
"catalog_preflight": {
"type": "stdio",
"command": "/absolute/path/to/node",
"args": [
"/absolute/path/to/catalog-preflight/src/agent.mjs"
]
}
}
}用样例验证连接
在本地客户端打开项目目录,再发送下面的提示词。预期结果包含 1 个新草稿、1 条调价和 2 条拦截。预览时 Shopify 导入文件保持锁定。
读取本项目里的 fixtures/supplier-current.csv、fixtures/shopify-export.csv 和 fixtures/supplier-prior.csv,将文本传给 preview_catalog_csv。不要开启两个确认标志。汇总变更并列出拦截行。
远程接入
托管试点已支持 HTTPS,凭邀请密钥访问。Claude 和 ChatGPT 的云端登录仍在规划。
启动客户端前,将邀请密钥设为环境变量 CATALOG_PREFLIGHT_MCP_TOKEN。把示例合并到现有配置。
codex mcp add catalog_preflight_pilot --url https://catalog-mcp.penlonlab.com/mcp --bearer-token-env-var CATALOG_PREFLIGHT_MCP_TOKEN
{
"mcpServers": {
"catalog_preflight_pilot": {
"type": "http",
"url": "https://catalog-mcp.penlonlab.com/mcp",
"headers": {
"Authorization": "Bearer ${CATALOG_PREFLIGHT_MCP_TOKEN}"
}
}
}
}{
"mcpServers": {
"catalog_preflight_pilot": {
"url": "https://catalog-mcp.penlonlab.com/mcp",
"headers": {
"Authorization": "Bearer ${env:CATALOG_PREFLIGHT_MCP_TOKEN}"
}
}
}
}用 get_catalog_usage 查看额度。同一月份相同输入和映射的成功检查只计一次。试点期间请使用合成 CSV。
数据处理
本地 MCP 进程在你的设备上读取工具参数。Agent 客户端可能把输入和结果发送给模型供应商。如果 CSV 必须留在设备上,请使用浏览器工作台。
打开浏览器工作台