Free previewCheck your first catalog CSV ↗

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 · stdio

Run this command in your terminal, then restart Codex.

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

Claude Code

Local · stdio

Run this command to add the server for your user. Open a new Claude Code session and use /mcp to check it.

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

Local · stdio

In your project, add the server entry to .cursor/mcp.json. Merge it with any existing servers. Reload Cursor and check the MCP settings.

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

Claude

Remote · planned

Claude cloud connectors need a remote MCP connection. CatalogPreflight plans to use account sign-in for this connection.

See remote access status ↗

ChatGPT

Remote · planned

ChatGPT 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.

Sample check

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 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}"
      }
    }
  }
}

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