Skip to main content

Connect Altera to ChatGPT or Claude

Install the Altera connector in ChatGPT or Claude so you can run Shopify imports and exports from a chat conversation.

Goal

Install the Altera connector inside ChatGPT (or Claude) so you can ask the assistant to export, edit, and re-import data from your Shopify store without leaving the chat. The assistant calls Altera's tools on your behalf, you review the results, and Altera applies the changes through the same APIs the web app uses.

Prerequisites

  • An Altera account with at least one Shopify store connected.

  • Permission on the Altera account to create OAuth grants (any owner, admin, or staff role).

  • A ChatGPT plan with access to custom connectors (Pro, Business, or Enterprise), or a Claude plan (Pro or Team) with custom connectors enabled.

Add the connector in ChatGPT

  1. In ChatGPT, open Settings > Connectors and click Add custom connector (you may need to enable developer mode first under Advanced settings).

  2. Enter the connector URL: https://mcp.getaltera.com/mcp.

  3. Click Connect. ChatGPT redirects you to Altera to sign in.

  4. Sign in with your Altera credentials, choose the shop you want to authorize, and click Authorize.

  5. You're redirected back to ChatGPT. The connector now shows as Connected in your settings.

The grant is per-shop. If you want ChatGPT to act on more than one shop, repeat the steps above and authorize each shop separately.

Add the connector in Claude

The flow in Claude is nearly identical:

  1. In Claude, open Settings > Connectors and click Add custom connector.

  2. Enter the same connector URL: https://mcp.getaltera.com/mcp.

  3. Click Connect, sign in to Altera, pick the shop, and click Authorize Claude.

Connectors are available in the Claude desktop app, web app, and Claude Code.

Try it out

Open a new conversation and ask:

  • Use Altera to show me my five most recent jobs.

The assistant calls whoami to discover the shop, then list_jobs and reports the result.

For a write example:

  • Export the first 10 active products from my store as a CSV.

The assistant creates an export job, polls for completion, and returns a time-limited download link you can use to save the file locally.

What the assistant can do

The connector exposes tools in three groups:

  • Discovery: whoami, list_shops, list_jobs, ref_resources, ref_fields, ref_filters, ref_operators, ref_metafields, taxonomy_search, taxonomy_browse, taxonomy_validate, search_docs.

  • Shop reads: shop_metafield_definitions, shop_metaobject_definitions, shop_markets, shop_locations, shop_customer_segments.

  • Jobs and files: export_create, request_upload_url, import_create, job_status, job_run, job_cancel, job_download_url.

Read tools run automatically. Write tools (import_create in particular) prompt you to confirm before changing data on the store.

Permissions and safety

  • The connector inherits whatever data permissions you've configured for your Altera account. If a resource type is restricted, the assistant gets a permission error when it tries to use it.

  • Imports that change data require explicit confirmation in the chat UI. The assistant can't apply an import silently.

  • Every tool call is logged in your Altera account's audit log with the timestamp, tool name, and arguments.

Disconnect

To revoke the assistant's access:

  1. In ChatGPT or Claude: Settings > Connectors > Altera > Remove.

  2. In Altera: Settings > API & Connections > find the matching grant and click Revoke (this also revokes the underlying OAuth grant).

Doing both is the safest path; the Altera-side revocation invalidates the access token immediately.

See also

Did this answer your question?