OpenAI Ads MCP by InsightfulPipe
Hosted OpenAI Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http openai-ads-mcp-by-insightfulpipe 'https://openai-ads.insightfulmcp.com/'{
"mcpServers": {
"openai-ads-mcp-by-insightfulpipe": {
"type": "http",
"url": "https://openai-ads.insightfulmcp.com/"
}
}
}التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
OpenAI Ads MCP Server by Insightful Pipe
Connect OpenAI Ads to AI assistants: campaign management and performance insights for ads in ChatGPT.
Part of the Insightful Pipe MCP Server Collection — use OpenAI Ads from Claude, ChatGPT, Cursor, and other AI assistants through the Model Context Protocol (MCP).
MCP Server URL
https://openai-ads.insightfulmcp.com/What is OpenAI Ads MCP?
OpenAI Ads MCP is a remote Model Context Protocol server hosted by InsightfulPipe. Manage OpenAI Ads campaigns, ad groups, ads, and creatives, and analyze performance insights.
Installation
Claude
- Copy the MCP Server URL:
https://openai-ads.insightfulmcp.com/ - Open Claude Connectors Settings
- Scroll to the bottom and click Add custom connector
- Paste the URL and click Add
- Click Connect and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.
ChatGPT
Custom MCP servers are added through ChatGPT's Developer mode. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.
- Turn on Developer mode in ChatGPT settings
- Create a new app for a remote MCP server and paste the URL:
https://openai-ads.insightfulmcp.com/ - Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.
See OpenAI's guide: Developer mode and MCP apps in ChatGPT
Claude Code
claude mcp add --transport http openai-ads https://openai-ads.insightfulmcp.com/Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"openai-ads": {
"url": "https://openai-ads.insightfulmcp.com/"
}
}
}When Cursor shows Needs authentication, click Connect and sign in to InsightfulPipe if asked.
Available Actions
49 actions: 25 read, 24 write.
Read Actions (25)
| Action | Description |
|---|---|
get_ad | Get details for a specific ad, including creative and review_status |
get_ad_account | Get metadata for the connected ad account (name, url, status, timezone, currency, brand review status) |
get_ad_account_insights | Get performance insights for the whole ad account |
get_ad_group | Get details for a specific ad group |
get_ad_group_insights | Get performance insights for an ad group |
get_ad_groups | List ad groups for a campaign |
get_ad_insights | Get performance insights for a single ad |
get_ads | List ads for an ad group |
get_bulk_job | Get the status of a bulk mutation job |
get_bulk_job_operations | List per-operation results for a bulk mutation job |
get_campaign | Get details for a specific campaign |
get_campaign_insights | Get performance insights for a campaign |
get_campaigns | List campaigns for the ad account |
get_conversion_events | List conversion events one pixel has received |
get_conversion_insights | Get conversion metrics (click-through and view-through) per entity |
get_custom_audience | Get details for a specific custom audience |
get_custom_audience_operation | Get the privacy-safe lifecycle state of one audience mutation operation |
get_custom_audiences | List custom audiences for the ad account |
get_event_settings | List conversion event settings for the ad account |
get_lead_form | Get details for a specific lead form |
get_lead_forms | List lead forms for the ad account |
get_lead_sync_subscription | Get one lead-sync subscription |
get_lead_sync_subscriptions | Get the ad account's lead-sync subscription state |
get_pixels | List web pixel conversion sources; each row carries the pixel_id used by the Conversions API |
search_geo_locations | Search targetable locations (country, region, DMA) and get the ids used in campaign targeting |
Write Actions (24)
| Action | Description |
|---|---|
add_custom_audience_identifiers | Add inline identifiers to an existing custom audience |
archive_custom_audience | Archive a custom audience so it can no longer be used for targeting |
archive_lead_form | Archive a lead form that is not attached to a published ad |
create_ad | Create an ad (always created in paused status for safety) |
create_ad_group | Create an ad group (always created in paused status for safety) |
create_bulk_job | Submit an async bulk mutation job (up to 1,000 campaign/ad group/ad operations) |
create_campaign | Create a campaign (always created in paused status for safety) |
create_custom_audience | Create an empty custom audience to fill with add_custom_audience_identifiers |
create_event_setting | Create a conversion event setting bound to one conversion source |
create_lead_form | Create a draft lead form |
create_pixel | Create a web pixel conversion source; returns the source id and the pixel_id for the JavaScript tag |
merge_custom_audiences | Create a new independent custom audience containing all members of the given audiences |
preview_ad | Generate a shareable preview for an ad (the preview link expires after 24 hours) |
publish_lead_form | Publish the lead form's current draft revision |
remove_custom_audience_identifiers | Remove inline identifiers from an existing custom audience |
send_conversion_events | Send server-side conversion events to the Conversions API for one pixel |
test_lead_form_submission | Queue a synthetic, signed lead-sync webhook test submission for a published lead form |
update_ad | Update an ad: name, creative, or status (live, paused, archived) |
update_ad_group | Update an ad group: name, description, hints, bidding, product set, or status (live, paused, archived) |
update_brand | Update the ad account's brand metadata (display name and/or favicon) |
update_campaign | Update a campaign: name, description, schedule, budget, targeting, or status (live, paused, archived) |
update_lead_form | Save a new draft revision for a lead form |
update_product_feed_items | Update availability and titles for existing variants in a linked product feed (delta feed) |
upload_file | Upload an image asset from a public URL; returns a file_id for ad creatives or the account favicon |
Control What Your AI Can Do
You decide what AI agents can do with each connected account:
- Turn individual actions on or off for every connected account, so agents only see the actions you allow.
- Connect as Read-only or Read & Write. A read-only connection can only enable read actions.
- Destructive actions stay off by default. Actions such as deletes are disabled until an admin enables them.
- Team access per account. Restricted team members only use the accounts they are granted, with the read actions enabled on them.
Usage Examples
"Show my OpenAI Ads campaign performance for the last 14 days""Which ad groups have the highest click-through rate?""Create a paused campaign for our spring launch"Pricing
The OpenAI Ads MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month, and you can try it for 7 days. See insightfulpipe.com/pricing for current plans.
Explore More MCP Servers by Insightful Pipe
Visit insightfulpipe.com/mcp-servers to discover our full collection of MCP servers.
Resources
Support
- Documentation: insightfulpipe.com/docs
- All MCP Servers: insightfulpipe.com/mcp-servers
- Email: support@insightfulpipe.com
Insightful Pipe — AI-powered marketing analytics through MCP servers. Explore all integrations →
License
MIT License - see LICENSE for details.
الأسئلة الشائعة
ما هو OpenAI Ads MCP by InsightfulPipe؟
Hosted OpenAI Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
كيف أثبّت OpenAI Ads MCP by InsightfulPipe؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http openai-ads-mcp-by-insightfulpipe 'https://openai-ads.insightfulmcp.com/'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج OpenAI Ads MCP by InsightfulPipe إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل OpenAI Ads MCP by InsightfulPipe مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون OpenAI Ads MCP by InsightfulPipe؟
ينشره Insightful-Pipe. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.