> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hurrypayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect with AI (MCP server)

> Connect Claude, ChatGPT, Cursor or VS Code to your Hurry account so AI can create and manage your stores for you.

The **Connect with AI** section lets you connect AI assistants such as **Claude**, **ChatGPT**, **Cursor** or **VS Code** to your Hurry account through the **Hurry Payments MCP server**.

MCP is the standard AI assistants use to work with external tools. Once connected, your AI can create stores, upload products and photos, design pages, translate them, write the policies and publish them, always within your account's permissions.

You'll find this section in the side menu, under **Account > Connect with AI**.

![Connect with AI screen in the Hurry Account menu](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-vista-general.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=e6679f6cc483877c7783970b382cf1eb)

***

## What the AI can do

With a connected token, the AI can work on these areas of your account:

| Area | What it includes |
| :- | :- |
| Stores | Stores, pages and sections |
| Catalog | Products, variants and collections |
| Design | Theme, menu, cart and CSS |
| Content | Translations, policies and domain |
| Payments | Payments, customers and gateways |
| Operations | Refunds, routing and bulk charges |
| Marketing | Pixels, automations, emails and SMS |

![Hurry Payments MCP server block with the available features and the server URL](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-servidor.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=8dc7ec7a392eed328004689a6c07b16a)

What the AI can do in each case depends on the access level you give the token (you'll see this in the next step).

***

## Step 1: create a token

The token is the key the AI uses to access your account. Create a different one for each AI or device so you can revoke them separately.

**1. Open the form**

In **Connect with AI**, click **New token** (top right).

**2. Give it a name**

In **Name**, enter the AI or device you'll use it with, for example `Claude Desktop` or `Cursor laptop`. This helps you recognize it later.

**3. Confirm with your password**

In **Your password**, enter your Hurry account password to confirm that you're the one creating the token.

**4. Choose the access level**

* **Full**: can create, change, publish and, with your confirmation, charge or refund.
* **Read only**: can only view sales, payments, stores and metrics. It can't change anything.

**5. Decide whether to allow money operations**

The **Allow money operations** checkbox enables refunds, bulk charges, SMS campaigns, paid apps and gateway changes. Leave it unchecked if you don't need it.

**6. Choose the expiration**

In **Expiration** you can choose **Never expires**, **7 days**, **30 days**, **90 days** or **1 year**.

**7. Create the token**

Click **Create token**. The token appears in the **Tokens** list.

![New token form with name, password, access level, money operations and expiration](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-nuevo-token.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=5f96b8f387ce976179769e545ed347eb)

> [!TIP]
>
> If you only want the AI to help you analyze sales or metrics, create a **Read only** token. Use **Full** access when you want it to create or modify stores, and check **Allow money operations** only if you really need it.

***

## Step 2: connect your AI

All connections use the same server URL:

```text Server URL theme={null}
https://app.hurrypayments.com/api/mcp
```

The transport is HTTP and the token is sent in the `Authorization: Bearer` header. In the examples, replace `YOUR_TOKEN` with the token you created.

In the **How to connect it** section there's a tab for each tool, with a **Copy** button to grab the configuration.

> [tab] claude.ai / ChatGPT
>
> For claude.ai and ChatGPT you use a URL that includes the token:
>
> ```text URL with token theme={null}
> https://app.hurrypayments.com/api/mcp/t/YOUR_TOKEN
> ```
>
> * **claude.ai**: go to **Settings > Connectors > Add custom connector** and paste this URL.
> * **ChatGPT**: go to **Settings > Connectors > Developer mode > Create**, paste this URL and leave the connection **without authentication**.
>
> ![claude.ai / ChatGPT tab with the URL that includes the token](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-claude-ai.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=685c897b70eccaea8ef8b6701e6ea471)
>
> > [!WARNING]
> >
> > This URL includes the token: don't share it. If it leaks, revoke the token.

> [tab] Claude Desktop
>
> You need **Node.js** installed.
>
> 1. In Claude Desktop, go to **Settings > Developer > Edit config**.
> 2. Add this to the `claude_desktop_config.json` file:
>
> ```json claude_desktop_config.json theme={null}
> {
>   "mcpServers": {
>     "hurry": {
>       "command": "npx",
>       "args": [
>         "-y",
>         "mcp-remote",
>         "https://app.hurrypayments.com/api/mcp",
>         "--header",
>         "Authorization:${HURRY_AUTH}"
>       ],
>       "env": {
>         "HURRY_AUTH": "Bearer YOUR_TOKEN"
>       }
>     }
>   }
> }
> ```
>
> 3. Save the file and restart Claude Desktop.
>
> ![Claude Desktop tab with the configuration for claude\_desktop\_config.json](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-claude-desktop.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=41361f5c56d366463f9d6d038056d5cd)
>
> > [!NOTE]
> >
> > You can also use the URL from the claude.ai tab in Claude Desktop, from **Settings > Connectors**.

> [tab] Claude Code
>
> Run this command in the terminal:
>
> ```bash Terminal theme={null}
> claude mcp add --transport http hurry https://app.hurrypayments.com/api/mcp --header "Authorization: Bearer YOUR_TOKEN"
> ```
>
> Add `--scope user` to make it available in all your projects.
>
> ![Claude Code tab with the claude mcp add command](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-claude-code.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=12ba3b25686ed53cc51affbea44ccb7c)

> [tab] Cursor
>
> In Cursor, go to **Settings > MCP > Add new global MCP server**, or edit the `~/.cursor/mcp.json` file directly:
>
> ```json ~/.cursor/mcp.json theme={null}
> {
>   "mcpServers": {
>     "hurry": {
>       "url": "https://app.hurrypayments.com/api/mcp",
>       "headers": {
>         "Authorization": "Bearer YOUR_TOKEN"
>       }
>     }
>   }
> }
> ```
>
> ![Cursor tab with the mcp.json configuration](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-cursor.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=1cce05168499aba9778260212efe947b)

> [tab] VS Code
>
> Works with **Copilot in agent mode**. Create the `.vscode/mcp.json` file in your project, or use the **MCP: Add Server** command from the command palette:
>
> ```json .vscode/mcp.json theme={null}
> {
>   "servers": {
>     "hurry": {
>       "type": "http",
>       "url": "https://app.hurrypayments.com/api/mcp",
>       "headers": {
>         "Authorization": "Bearer YOUR_TOKEN"
>       }
>     }
>   }
> }
> ```
>
> ![VS Code tab with the .vscode/mcp.json configuration](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-vscode.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=7ca817314869a3492bd95bab9132c7cd)

***

## Step 3: ask your AI for something

Once connected, tell your AI what you need in plain language. For example:

> Create a scented candle store with 4 products, a persuasive home page in warm tones and the policies in English.

The AI will use Hurry's tools to do it, within the token's permissions.

***

## Manage your tokens

In the **Tokens** section you'll see all the tokens you've created. Until you have one, the message **No tokens yet** is shown.

![Empty Tokens section with the No tokens yet message](https://mintcdn.com/hurrypay/CqqjnfXAnul-H7BZ/images/mcp/mcp-tokens-vacio.jpg?fit=max\&auto=format\&n=CqqjnfXAnul-H7BZ\&q=85\&s=aff22b05cdc42bb917283f4e8e150b9b)

***

## Security

* Treat the token like a password: don't share it or publish it.
* Create one token per AI or device so you can revoke them separately.
* If a token or the URL with the token leaks, revoke it.
* Use **Read only** whenever the AI doesn't need to make changes.
* Leave **Allow money operations** unchecked unless you need it.
* Consider setting an expiration on tokens you'll only use for a limited time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.