This guide explains how to use the Microsoft Ads MCP hosted by TrueClicks in Claude AI. You’ll generate a secure GPT token and plug it into Claude to unlock AI-powered access to your Microsoft Ads data.
1. Generate GPT Token via GAQL.app
Introducing GAQL.app
GAQL.app is a free, intuitive tool for querying Google, Microsoft and Meta Ads data. Developed by TrueClicks, it enables effortless data access with a secure, user-specific token.
Why use it?
Free and secure
Designed for data exploration, automation, and script writing
Ideal for marketers, analysts, and engineers
Simplifies access to Google, Microsoft and Meta Ads data
How to Get Your GPT Token
Go to https://gaql.app
Log in using your Microsoft account
Click the COPY GPT TOKEN button in the top-right corner
This token will authenticate your session with Claude’s integration.
2. Add MCP Integration in Claude AI
To enable the hosted MCP endpoint inside Claude AI, follow these steps:
Step-by-step Instructions
In Claude: Click on Manage connectors
At the top, click the "Add custom connector" button:
Fill out the fields as follows:
Integration Name:
Microsoft Ads MCP by TrueClicksIntegration URL:
https://mcp.gaql.app/mcp/microsoft-ads/{YOUR-GPT-TOKEN}Url too long? See the callout below
That’s it! The integration will now be available within Claude AI.
⚠️ URL too long? Claude Desktop has a hard URL length limit, and GPT tokens can push your URL past it. This happens often for Microsoft Ads. If the connector won't save, use the advanced setup instead. It puts the token in a header via Claude's config file, so the URL length stops mattering.
✅ You’re All Set!
You’ve successfully connected Claude AI with your Microsoft Ads account using the MCP hosted by TrueClicks. Now you can:
Ask natural-language questions about your ad account
Build insights and automations faster
💬 Need Help?
If you run into issues with setup or query logic, feel free to reach out:
We're here to support your productivity with Claude AI and GAQL MCP.