# MCP Configure

> Connect your store with ChatGPT, Codex or Claude: sign in to Attribuly, choose your store and approve read-only access.
> 
## Settings to use

| Field | Value |
| --- | --- |
| Name | `Attribuly` |
| Server URL | `https://data.api.attribuly.com/mcp` |
| Connection type, if requested | Streamable HTTP |
| Authentication | OAuth |

No plugin ZIP, API key or client secret is needed.

## 1. ChatGPT

1. Open **Plugins → Add → Add custom MCP server**.
2. Enter the name and server URL above. Choose **OAuth** if asked.
3. Review the notice and click **Create** or **Create as a plugin**.
4. Click **Connect / Sign in**. Log in to Attribuly, choose your store, review the permissions and click **Allow access**.
5. Return to ChatGPT. Start a new chat and select **Attribuly** from the plugin picker or `@` menu.

If the form requires an OAuth Client ID, enter:

```text
https://chatgpt.com/oauth/client.json
```

Leave Client Secret and custom headers empty. This client ID is for ChatGPT only.

[Official ChatGPT connection guide](https://developers.openai.com/plugins/deploy/connect-chatgpt).

## 2. Codex desktop

1. Open **Settings → MCP servers → Add server**. If your version shows Plugins instead, choose **Settings → Plugins → Add → Add MCP server**.
2. Enter **Attribuly**, select **Streamable HTTP**, and paste the server URL above.
3. Leave Bearer token, headers and environment-variable fields empty. Click **Save**, then **Restart** if offered.
4. Click **Authenticate / Log in** for Attribuly. In the browser, log in to Attribuly, choose your store, review the permissions and click **Allow access**.
5. Return to Codex and start a new session. Ask it to use the Attribuly MCP connection.

[Official Codex MCP guide](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).

## 3. Claude web or desktop

1. Open **Customize → Connectors**. In some versions, use **Settings → Connectors**.
2. Choose **Add → Add custom connector**. Enter **Attribuly** and the server URL above.
3. Continue with the detected OAuth settings. Choose **Sign in now** and **Use Claude's published identity** if those options appear. Leave custom headers empty.
4. Click **Add / Connect**. Log in to Attribuly, choose your store, review the permissions and click **Allow access**.
5. Return to Claude. Enable Attribuly in your conversation through **+ → Connectors** or the connector picker.

For company accounts, an authorized administrator may need to add or allow the connector first.

[Official Claude connector guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

## Available tools

Ask in plain language; the assistant chooses the tools automatically.

| Tool | What you can query |
| --- | --- |
| `get_store_profile` | Connected store, domain, timezone and currency. |
| `get_attribution_models` | Attribution models available for your store. |
| `get_all_attribution_data` | All-channel attribution summaries and rankings. |
| `get_attribution_totals` | Overall attribution metrics for a selected report. |
| `get_ad_attribution_data` | Paid-ad performance by channel, campaign, ad set or ad. |
| `get_ad_attribution_detail_data` | Order-level attribution for paid advertising. |
| `get_all_attribution_detail_data` | Order-level attribution across all channels. |
| `get_product_analysis_data` | Product revenue, units, spend and ROAS. |
| `get_product_campaign_breakdown` | Campaign and channel performance for a specific product. |
| `get_web_analysis_data` | Website users, sessions, purchases and revenue. |
| `get_order_detail` | Purchased items, quantities, order amounts and payment status. |

Access is read-only and subject to your store permissions and Attribuly plan. Order details may include customer names and email addresses. Review the requested permissions before authorizing.

If an add/connect option is missing or setup fails, contact support with the client name and error text. Do not share passwords or tokens. Menu labels may vary by client version and account.