ProfitMetrics supports connecting your account to AI platforms such as Claude or ChatGPT using the Model Context Protocol (MCP). This lets you ask an AI assistant questions directly about your ProfitMetrics data. Setting this up involves three steps: generating an access token, registering an agent connection, and adding the connection details into your chosen AI platform. This article walks through all three.
NOTE: Shopping Booster fee data is not currently supported through the MCP connection.
If you have an agency account and wish to connect the ProfitMetrics MCP server to multiple customers, please follow this guide.
Step 1: Generate an access token
Go to Account > Access Tokens and click Generate New Token.
| Setting | What to do |
|---|---|
| Token name | Give the token any name you like so you can identify it later. |
| Expiration date | Set an expiration date if you want one, or choose no expiration. |
| Site access | Choose Full access to allow access to all your websites, or click Custom to select a single website. |
| Scopes | Under Scopes, select both Metrics Read and MCP Server Access |
Click Generate Token. You can close the token window afterwards — the token itself doesn't need to be copied or saved anywhere for this setup.
Step 2: Register an agent connection
Go to Accounts and then Agent Connections.
| Field | What to enter |
|---|---|
| Connection name | Give the connection any name you like, for example My MCP connector. |
| Redirect URL | Choose Claude or ChatGPT, depending on which AI platform you're using. The matching redirect URI is added automatically. You can also enter a custom redirect URI if you're connecting a different system. |
| Scopes | Keep OpenID and Sites Read checked. Also check Metrics Read to ensure you can access the dashboard data |
Click Register Connection. This generates a client ID and client secret, which you'll need in the next step.
Step 3: Add the connection to your AI platform
With the client ID and client secret from Step 2, you can now connect ProfitMetrics inside your AI platform.
The steps below use Claude as an example:
| Step | Action |
|---|---|
| 1 | Click the plus button in a chat and select Connectors. |
| 2 | Click Add Connector, then Add Custom Connector. |
| 3 | Give the connector any name you like. |
| 4 | In the remote server URL field, enter https://api.my.profitmetrics.io/mcp |
| 5 | Open Advanced Settings and enter the client ID, then the client secret underneath it. |
| 6 | Click Add. |
Once the connector is added, you can start asking your AI platform questions about your ProfitMetrics data.
Troubleshooting
| Symptom | Check |
|---|---|
| Connector fails to connect | Check that the client ID and client secret were copied correctly from the Agent Connections page, with no extra spaces. |
| AI platform can't find any data | Confirm the access token's site access covers the website you're asking about, and Metrics Read and MCP Server Access were both selected as part of the scopes. |
| Shopping Booster fee data missing from answers | This is expected — Shopping Booster fee data isn't currently available through the MCP connection. |
| Wrong redirect URI error | Make sure you selected the correct platform (Claude or ChatGPT) when registering the connection, or entered the correct custom redirect URI if using another system. |