New product launch · BestUpsell is live for smarter upsell offers and higher Shopify order value.Explore BestUpsell →
← Back to MCP connection options
API Key · BestTrack MCP

Connect BestTrack MCP with an API Key

Give an AI client read-only access to the tracking data allowed for your current store.

Who this is forFor clients that support a remote HTTP MCP server and custom request headers. You need access to BestTrack Admin.

1. Create a read-only Key

Open MCP integration in BestTrack Admin. Create a Key and select only the read-only permissions needed for the tracking questions you plan to ask.

BestTrack Admin Integrations page with the MCP Server card and Connect button highlighted
Open BestTrack MCP Server from IntegrationsOpen Integrations in BestTrack Admin and select Connect on the BestTrack MCP Server card.
BestTrack MCP Server screen with the Create API Key button highlighted
Create an API KeySelect Create API Key in the BestTrack MCP Server screen.

2. Copy and save the Key now

The complete Key is shown only once. Copy it when it is created and store it somewhere secure. If you lose it, create a new Key and update your client.

API Key creation dialog showing the one-time display notice and Copy API key button; the Key value is hidden
Copy the Key while it is visibleThe screenshot shows the one-time notice; the Key value has been hidden.

3. Copy the MCP Server URL

Copy the MCP Server URL for your current environment from BestTrack Admin. Use that value in the client; do not copy a URL from another store or environment.

BestTrack MCP Server screen with the Copy URL button highlighted
Copy the current MCP Server URLUse Copy URL on the BestTrack MCP Server screen.

4. Configure the AI client

Add a remote HTTP MCP server in a client that lets you set custom request headers. Paste the URL from Admin and add this Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Different clients may use different configuration formats. This line shows the required header, not a complete client configuration file.

AI client MCP settings showing Streamable HTTP, a Server URL, and an Authorization header with a placeholder Key
Example client configurationThis client example shows Streamable HTTP and the Authorization header. Copy your own URL from Admin; other clients may differ.

5. Confirm the connection

Ask the client to look up a shipment that you can also find in the current store's BestTrack Admin. Compare the returned tracking details with that store's record before using the connection for other queries.

6. Rotate, revoke, or replace the Key

When rotating a Key, create its replacement, update each client that uses the old value, verify a tracking query, then revoke the old Key in Admin. A revoked Key must be replaced in the client before it can connect again.

If a Key may have leaked, revoke it in Admin promptly, create a replacement, update affected clients, and check their recent use in Admin if that information is available.

Common questions
My client cannot set custom headers. What should I do?

Use a client that supports custom headers, or follow the OAuth guide if the client supports MCP OAuth.

The query failed after I revoked a Key. Why?

The client may still be using the revoked value. Create a replacement Key, update its configuration, and try the query again.