Agent setup
Connect your Agent
Run the same Shopify CSV checks from your Agent.
Choose your client
For local clients, open a copy of this project and install Node.js 22 or later. Replace both example paths with your Node executable and the full path to the server file.
Codex
Local · stdioRun this command in your terminal, then restart Codex.
codex mcp add catalog_preflight -- "/absolute/path/to/node" "/absolute/path/to/catalog-preflight/src/agent.mjs"
Claude Code
Local · stdioRun this command to add the server for your user. Open a new Claude Code session and use /mcp to check it.
claude mcp add --transport stdio --scope user catalog_preflight -- "/absolute/path/to/node" "/absolute/path/to/catalog-preflight/src/agent.mjs"
Cursor
Local · stdioIn your project, add the server entry to .cursor/mcp.json. Merge it with any existing servers. Reload Cursor and check the MCP settings.
{
"mcpServers": {
"catalog_preflight": {
"type": "stdio",
"command": "/absolute/path/to/node",
"args": [
"/absolute/path/to/catalog-preflight/src/agent.mjs"
]
}
}
}Claude
Remote · plannedClaude cloud connectors need a remote MCP connection. CatalogPreflight plans to use account sign-in for this connection.
See remote access status ↗ChatGPT
Remote · plannedChatGPT needs a remote MCP connection and custom app access on your account or workspace. CatalogPreflight plans to use account sign-in for this connection.
See remote access status ↗Verify with sample files
Open the project folder in your local client, then send this prompt. Expect one new draft, one price change, and two held rows. Shopify import files stay locked during preview.
Use preview_catalog_csv with the text from fixtures/supplier-current.csv, fixtures/shopify-export.csv, and fixtures/supplier-prior.csv in this checkout. Leave both confirmation flags off. Summarize the changes and list the held rows.
Remote access
The hosted pilot is available over HTTPS with an invite key. Cloud sign-in for Claude and ChatGPT is still planned.
Set your invite key in CATALOG_PREFLIGHT_MCP_TOKEN before launching your client. Merge the example into your existing configuration.
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}"
}
}
}
}Check your allowance with get_catalog_usage. Successful checks count once per month for the same input and mapping. Use synthetic CSVs during the pilot.
Data handling
The local MCP process reads tool arguments on your device. Your Agent client may send inputs and results to its model provider. Use the browser workbench for private CSVs that must stay on your device.
Open the browser workbench