> For the complete documentation index, see [llms.txt](https://docs.uppromote.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uppromote.com/settings/integrations/mcp/connect-to-uppromote-mcp.md).
# Connect to UpPromote MCP
Connect an MCP client to your UpPromote workspace.
Follow the instructions for your MCP client. Unlike some MCP servers, UpPromote MCP authenticates with an MCP Authorization key that you generate in the UpPromote admin — so the first step is always to get your key, then add the server in your client.
Note: This feature is available on the **Professional plan and above**.
### How to set up MCP in general?
Your key is created and managed inside the UpPromote app.
1. In the UpPromote admin, open Settings → Integration -> Advanced.
2. Find the MCP card and click Set up. The Set up MCP modal opens.
2. The first time you open it, an MCP Authorization key is generated automatically. Click the copy icon next to the key to copy it.
The modal also shows two other things you'll use below:
* Server endpoint:
* A ready-made config file you can copy in one click — when you copy it, your real key is filled in automatically (no manual replacing needed).
{% hint style="warning" %}
Notes: Keep your key private. Anyone with this key can read and act on your affiliate data. If it leaks, open the modal and click Refresh to issue a new key — the old one stops working, and you'll need to update every AI client that used it. Click Delete to revoke the key entirely.
{% endhint %}
In the steps below, replace YOUR\_MCP\_AUTHORIZATION\_KEY with the key you copied — or just paste the config file from the modal, which already contains it.
### Installation Guide for popular AI clients
#### Claude Code (for paid plan on Claude Code)
In this version, MCP is currently available only in the **Code** tab of Claude. It's not yet supported in **Chat and Cowork**.
**Option 1 — Use the CLI command**
1. Open a terminal and run: claude mcp add --transport http uppromote-mcp --header "Authorization: YOUR\_MCP\_AUTHORIZATION\_KEY"
2. Replace \ with your real token. By default the server is added at user scope (available across all projects).
**Option 2 — Edit the config file manually**
1. Open \~/.claude.json (Windows: C:\Users\\\\\.claude\_desktop\_config\_json) and add the following block inside mcpServers:
```
{
"mcpServers": {
"uppromote-mcp": {
"type": "http",
"url": "https://mcp.uppromote.com/mcp",
"headers": {
"Authorization": "YOUR_MCP_AUTHORIZATION_KEY"
}
}
}
}
```
2. Save the file, then restart Claude Code.
3. Verify the connection, in Claude Code, type /mcp → the uppromote-mcp server should show status connected.
#### Antigravity
1. Open Settings → Customization -> Move to section Installed MCP Servers
2. Click on button Open MCP Config
3. Open MCP Config file in your device Add the UpPromote json file to your config file:
```
{
"mcpServers": {
"uppromote-mcp": {
"serverUrl": "https://mcp.uppromote.com/mcp",
"headers": {
"Authorization": "YOUR_MCP_AUTHORIZATION_KEY"
}
}
}
}
```
4. Save the configuration and restart Antigravity. The UpPromote tools become available once the server connects.
#### VS Code - GitHub Copilot
1. Copy the config file in UpPromote and create a .vscode/mcp.json file in your workspace:
```
{
"servers": {
"uppromote-mcp": {
"type": "http",
"url": "https://mcp.uppromote.com/mcp",
"headers": {
"Authorization": "YOUR_MCP_AUTHORIZATION_KEY"
}
}
}
}
```
2. Open the Command Palette (Ctrl+Shift+P) and choose Preferences: Open User Settings (JSON), and paste the config file to
3. Start the uppromote-mcp server. Once it connects, the UpPromote tools are available in Copilot Chat.
### Managing your connection
* Refresh key — in Settings → Integration → MCP → Set up, click Refresh to generate a new key. The current key is overwritten and any client still using the old key stops working until you update it.
* Delete key — click Delete to revoke the key. All MCP connections stop working; reopen the modal and generate a new key to set up again.
* Reconnect a client — after refreshing or deleting a key, update the Authorization header (or re-copy the config file) in each client and restart it.
### Troubleshooting
* "Unauthorized" errors - the key is missing, mistyped, or was refreshed/deleted. Re-copy the key (or the full config file) from the Set up MCP modal and update your client.
* Server won't connect - confirm the endpoint is exactly and that your client uses the HTTP transport.
* MCP option not visible in the admin - the MCP card appears in Settings → Integration for accounts with the matching settings permission. Check with your store owner if you don't see it.
### Next steps
See the [Supported tools](https://docs.uppromote.com/~/revisions/GNHCrkPP03Iv0fEYoaq1/settings/integrations/mcp/supported-tools) that a connected client can use.
2. Replace \
2. Click on button Open MCP Config
3. Open MCP Config file in your device Add the UpPromote json file to your config file:
```
{
"mcpServers": {
"uppromote-mcp": {
"serverUrl": "https://mcp.uppromote.com/mcp",
"headers": {
"Authorization": "YOUR_MCP_AUTHORIZATION_KEY"
}
}
}
}
```
#### VS Code - GitHub Copilot
1. Copy the config file in UpPromote and create a .vscode/mcp.json file in your workspace:
```
{
"servers": {
"uppromote-mcp": {
"type": "http",
"url": "https://mcp.uppromote.com/mcp",
"headers": {
"Authorization": "YOUR_MCP_AUTHORIZATION_KEY"
}
}
}
}
```
2. Open the Command Palette (Ctrl+Shift+P) and choose Preferences: Open User Settings (JSON), and paste the config file to
