Skip to main content
Raw Markdown

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:

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

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

Official ChatGPT connection guide.

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.

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.

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.