> ## Documentation Index
> Fetch the complete documentation index at: https://996f455-productmetrics.manicule.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://996f455-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://996f455-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://996f455-productmetrics.manicule.dev/docs/.well-known/llms-manifest.json

# Product Metrics in ChatGPT (/docs/integrations/chatgpt)

<!-- agent-signals: reading_time_min: 5 · est_tokens: 1772 · updated: 2026-11-16 -->
Related: [Product Metrics in Claude Code](/docs/integrations/claude-code.md), [Product Metrics in Claude](/docs/integrations/claude.md), [Product Metrics in Codex](/docs/integrations/codex.md), [Product Metrics in Cursor](/docs/integrations/cursor.md), [Product Metrics MCP tools](/docs/mcp/tools.md)

> Add Product Metrics to ChatGPT as a custom MCP app with OAuth, sign in, and ask about your store and Google Ads.

Add Product Metrics to ChatGPT as a **custom app** in developer mode. It connects to the **MCP server** at `https://www.productmetrics.io/mcp`. ChatGPT can then:

* read your stores, products and Google Ads account
* explain what changed and report profit on ad spend
* run setup steps such as connecting your store

You sign in in your browser. There is no API key.

## Install



**1. Turn on developer mode**

In ChatGPT, open **Settings → Apps**, then **Advanced settings**, and turn on **Developer mode**.

**2. Create the app**

Click **Create app** and fill in:

| Field              | Value                               |
| ------------------ | ----------------------------------- |
| **Name**           | `Product Metrics`                   |
| **MCP server URL** | `https://www.productmetrics.io/mcp` |
| **Authentication** | **OAuth**                           |

Click **Create**.

`productmetrics mcp-config --client chatgpt` prints the same steps with the URL filled in.

## Authenticate

ChatGPT opens a Product Metrics page. Sign in, or choose **Continue with Google** to create an account. Check that the page names ChatGPT and what it **Can read** and **Can change**, then click **Connect ChatGPT**.

Access tokens last one hour and renew on their own. If you don't use the app for 30 days, sign in again.

## How it works

* **Pick a store first.** One connection covers every store (property) you can open. ChatGPT calls `list_properties`, then passes the store to every other tool. With one store, it uses that one without asking.
* **Analysis tools read live.** Tools such as `explain_google_ads_change`, `get_google_ads_report` and `get_poas_report` read your Google Ads account and your store's margins and stock. They never change Google Ads or your store.
* **Setup runs through Code Mode.** `search` finds an API operation; `execute` runs code that calls it: setup status, connecting stores and Google Ads, creating conversion actions. Operations that delete something run only after you confirm.
* **Browser steps come back as a link.** Google consent, a store install or checkout needs you in a browser. ChatGPT gives you the link, waits, then reads the setup status again.
* **Secrets stay out of the chat.** Fields such as a store setup token never reach ChatGPT. They show only in the Product Metrics app or the CLI.

## Tools

| Tool                           | Description                                                     |
| ------------------------------ | --------------------------------------------------------------- |
| `list_properties`              | The stores (properties) you can open; called first              |
| `get_store_overview`           | The store's own sales, orders and profit next to the ads        |
| `explain_google_ads_change`    | Why a Google Ads metric changed, in one call                    |
| `get_google_ads_report`        | Live Google Ads performance at any level                        |
| `get_poas_report`              | Profit on ad spend per product, campaign or account, with stock |
| `get_google_ads_changes`       | Who changed what in the account, last 30 days                   |
| `list_products_to_investigate` | Products that need attention first                              |
| `propose_change`               | File a proposal that a person approves in **Priorities**        |
| `search` / `execute`           | The whole Product Metrics API in Code Mode                      |

All 24 analysis tools and their arguments: [MCP tools](/docs/mcp/tools).

## What you can ask

In a new chat, add **Product Metrics** from the tools menu, then ask:

```text
"Where is my Product Metrics setup, and what is the next step?"
→ execute (GET /setup/status)

"Connect my WooCommerce store to Product Metrics."
→ execute (POST /companies/:companyId/stores); the setup token shows in
  the Product Metrics app, not in the chat

"Create the Product Metrics conversion actions in Google Ads."
→ execute (POST /properties/:propertyId/google-ads/conversion-actions)

"Which products spend without returning anything?"
→ list_properties, then get_google_ads_report (level: product,
  only_without_conversions: true)

"Why did my Google Ads conversion value drop since Monday?"
→ list_properties, then explain_google_ads_change
```

## Skills and the CLI

The Product Metrics skills (`set-up-tracking`, `connect-google-ads`, `check-tracking`, `bid-on-profit`, `analyse-google-ads`) and the `productmetrics` CLI are for coding agents such as [Codex](/docs/integrations/codex), [Claude Code](/docs/integrations/claude-code) and [Cursor](/docs/integrations/cursor). In ChatGPT, the app alone is enough: the tools carry their own instructions.

## Configuration

### Pin one store

To give ChatGPT one store only, use this URL when you create the app. The analysis tools then read that store without asking; `search` and `execute` still work on your whole account.

```text
https://www.productmetrics.io/mcp?selectedAccountPropertyId=<propertyId>
```

## Troubleshooting

| What ChatGPT says                                                                 | What to do                                                                                         |
| --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| "This connection expired or was removed; connect Product Metrics again."          | Sign in again from the app's settings. If that fails, delete the app and create it again.          |
| "This connection only has MCP access, so it cannot call the Product Metrics API." | Delete the app, create it again and allow everything the consent page shows.                       |
| "The MCP server is not enabled for this account yet."                             | Ask Product Metrics support to turn it on for your account.                                        |
| "This property needs a Product Metrics Pro subscription for the MCP server."      | Upgrade that store to Pro, or ask about another store.                                             |
| "No property chosen."                                                             | Name the store in your question; ChatGPT calls `list_properties` and tries again.                  |
| "The limit of … tool calls per hour … is reached."                                | Wait the minutes it names. Expensive tools have a lower hourly limit: see [MCP tools](/docs/mcp/tools). |
| **Create app** is missing                                                         | Turn on **Developer mode** first.                                                                  |

## Where next

* [Setup and usage](/docs/mcp/connect): how sign-in works, every client
* [MCP tools](/docs/mcp/tools): every tool and argument
* [MCP overview](/docs/mcp/overview): access control and disconnecting
* [Claude](/docs/integrations/claude) · [Codex](/docs/integrations/codex)
