# MCP Configure

## Configure Attribuly's MCP server to get AI assistance with your Attribuly data.

### You will learn
The Attribuly Model Context Protocol (MCP) server seamlessly integrates with Attribuly’s APIs, enabling AI clients to interact with your Attribuly data. This guide will walk you through configuring various MCP clients for both the remote-hosted MCP server (recommended) and the local MCP server.

MCP (Model Context Protocol) is an open protocol that helps AI models securely interface with different data sources and tools. You’ll connect Attribuly’s MCP server to an MCP client, i.e., an AI agent like Claude or Cursor, to get assistance with your Attribuly data. Your MCP client can help with a variety of tasks from campaign creation to performance reports. Here are some examples of prompts you can give:
- Show me the performance of my campaigns from the last 30 days.
- Which campaign are performing the best in terms of conversions?

### Configuration

1. MCP Server Address (https://data.api.attribuly.com/mcp)
2. For authentication, please use your API key. For details, refer to the API Authentication Guide.
### Claude Code CLI

1. Execute in terminal

```shell
claude mcp add --transport http attribuly https://data.api.attribuly.com/mcp --header "ApiKey: your-api-key"
```

### Claude Code Desktop

1. Download [Claude Desktop](https://claude.ai/download)
2. Open Claude Desktop. Within **Settings > Developer > Edit Config**, add the following, substituting your API key and MCP server address:
```json
{
  "mcpServers": {
    "attribuly": {
      "type": "http",
      "url": "https://data.api.attribuly.com/mcp",
      "headers": {
        "ApiKey": "your-api-key"
      }
    }
  }
}
```

4. Once you have saved all configuration changes, terminate all Claude processes and relaunch Claude to apply the new settings.
5. Verify the connection by looking for visual indicators and asking a question to test the connection.

---

### Cursor

1. Download [Cursor](https://www.cursor.com/)
2. Open Cursor. Within **Settings > Cursor Settings > Tools & Integrations > Add Custom MCP**, add the following, substituting your API key and MCP server address:

```json
{
  "mcpServers": {
    "attribuly": {
      "type": "http",
      "url": "https://data.api.attribuly.com/mcp",
      "headers": {
        "ApiKey": "your-api-key"
      }
    }
  }
}
```

4. Once you have saved all configuration changes, terminate all Cursor processes and relaunch Cursor to apply the new settings.
5. Verify the connection by looking for visual indicators and asking a question to test the connection.

---

### VS Code

1. Download [VS Code](https://code.visualstudio.com/)
2. Open VS Code. Within settings (**Ctrl + Shift + P > Preferences: Open Settings (JSON)**), add the following, substituting your API key and MCP server address:

```json
{
  "mcp": {
    "servers": {
      "attribuly": {
        "type": "http",
        "url": "https://data.api.attribuly.com/mcp",
        "headers": {
          "ApiKey": "your-api-key"
        }
      }
    }
  }
}
```

4. Once you have saved all configuration changes, terminate all VS Code processes and relaunch VS Code to apply the new settings.
5. Verify the connection by looking for visual indicators and asking a question to test the connection.

---

### ChatGPT

#### 1. Enable Developer Mode
1. Open ChatGPT (web/desktop app).
2. Navigate to **Settings → Apps & Connectors**.
3. Under the **Advanced** section, toggle **Developer Mode** to enabled.
- https://developers.openai.com/apps-sdk/deploy/connect-chatgpt

#### 2. Create Connector
1. In **Settings → Connectors**, click the **Create** button.
2. Fill in the configuration form:
   - **Name**: Attribuly
   - **Server URL**: `https://data.api.attribuly.com/mcp`
   - Check the box: **I trust this provider**
   - Add authentication (ApiKey)
3. Click **Create** to finish connector setup.

> **Note**: Without Developer Mode enabled, ChatGPT will reject the server if it lacks search/fetch tools. With Developer Mode on, search/fetch tools are not required for Chat mode usage.

#### 3. Use in Chat
1. Start a new chat conversation in ChatGPT.
2. Click the **+** button → select **More** → choose **Developer Mode**.
3. Enable your MCP server connector (critical: the connector must be explicitly added to each chat session).
4. Now you can use the tools provided by your MCP server in the chat.

---

## Available Tools

| Tool Name                 | Description                                      |
|---------------------------|--------------------------------------------------|
| get_all_attribution_data  | Get omnichannel attribution report data          |
| get_ad_attribution_data   | Get ad attribution report data                   |
| get_product_analysis_data | Get product analysis report data                 |
| get_influencer_data       | Get influencer attribution report data           |
| get_link_builder_data     | Get custom tracking link attribution report data |

---

## Getting Started

1. Create an account
2. Get your private API key from **Settings > API Keys**
3. Configure your MCP client following the instructions above
4. Start using your MCP client