免费预览检查你的第一份商品 CSV ↗

Agent 接入

连接你的 Agent

通过你的 Agent 运行同一套 Shopify CSV 检查。

选择客户端

使用本地客户端时,先打开项目副本并安装 Node.js 22 或更高版本。把两处示例路径分别换成 Node 可执行文件和服务端文件的绝对路径。

Codex

本地 · stdio

在终端运行此命令,然后重新启动 Codex。

Codex CLI
codex mcp add catalog_preflight -- "/absolute/path/to/node" "/absolute/path/to/catalog-preflight/src/agent.mjs"

Claude Code

本地 · stdio

运行此命令,将服务添加到当前用户。打开新的 Claude Code 会话,输入 /mcp 检查连接。

Claude Code CLI
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 设置。

.cursor/mcp.json
{
  "mcpServers": {
    "catalog_preflight": {
      "type": "stdio",
      "command": "/absolute/path/to/node",
      "args": [
        "/absolute/path/to/catalog-preflight/src/agent.mjs"
      ]
    }
  }
}

Claude

远程 · 计划中

Claude 云端连接器需要远程 MCP。CatalogPreflight 计划通过账户登录授权。

查看远程接入状态 ↗

ChatGPT

远程 · 计划中

ChatGPT 需要远程 MCP,并且你的账户或工作区需要具备自定义应用权限。CatalogPreflight 计划通过账户登录授权。

查看远程接入状态 ↗

用样例验证连接

在本地客户端打开项目目录,再发送下面的提示词。预期结果包含 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 CLI
codex mcp add catalog_preflight_pilot --url https://catalog-mcp.penlonlab.com/mcp --bearer-token-env-var CATALOG_PREFLIGHT_MCP_TOKEN
Claude Code · .mcp.json
{
  "mcpServers": {
    "catalog_preflight_pilot": {
      "type": "http",
      "url": "https://catalog-mcp.penlonlab.com/mcp",
      "headers": {
        "Authorization": "Bearer ${CATALOG_PREFLIGHT_MCP_TOKEN}"
      }
    }
  }
}
Cursor · .cursor/mcp.json
{
  "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 必须留在设备上,请使用浏览器工作台。

打开浏览器工作台