Meta Ads (Facebook & Instagram)
Read and manage Meta Ads campaigns, ad sets, ads, audiences, pages and Business Manager. You provide
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http meta-ads-facebook-instagram 'https://api.mcp.ai/p_meta_ads'{
"mcpServers": {
"meta-ads-facebook-instagram": {
"type": "http",
"url": "https://api.mcp.ai/p_meta_ads"
}
}
}التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Meta Ads (Facebook & Instagram)
Meta Ads (Facebook & Instagram) para Claude, ChatGPT e agentes de IA
Leitura e gestão de campanhas Meta Ads, ad sets, ads, audiências, páginas e Business Manager. Você fornece um long-lived access_token e o Facebook App ID (FB_API_ID).
- 📊 38 ferramentas
- ✏️ Leitura e escrita
- 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
- 🔑 Login via magic-link (sem senha)
English version · Documentação completa · Skill pra agentes
Instalar em 1 clique
Claude (Web e Desktop)
A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):
Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Meta Ads (Facebook & Instagram) e URL https://api.mcp.ai/p_meta_ads.
Cursor
➕ Instalar Meta Ads (Facebook & Instagram) no Cursor
VS Code (Copilot Chat)
➕ Instalar Meta Ads (Facebook & Instagram) no VS Code
ChatGPT, Manus, OpenClaw e mais 40+ clientes
Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:
https://api.mcp.ai/p_meta_adsDetalhes por cliente: INSTALL.md.
Exemplos de uso
Liste minhas contas de anúncio do Meta Ads
Quanto gastei hoje no Facebook Ads e qual o ROAS?
Mostre as campanhas ativas e o orçamento diário38 ferramentas disponíveis
| Tool | Descrição |
|---|---|
meta_ads_list_accounts | List Meta (Facebook) connections AND the ad accounts inside each — returns connections[] (OAuth logins) and ad_accounts[] with id (act_XXX), name, currency, timezone, status. |
meta_ads_status | Validate Facebook token, check expiry date, list connected ad accounts and scopes. |
meta_ads_campaigns | List Meta Ads campaigns. Returns: id, name, status, objective, budget, dates. Set include_paused=true to also show paused campaigns. |
meta_ads_today | Today's ad performance dashboard. |
meta_ads_roas | ROAS (Return on Ad Spend) for a date range using Meta's /insights endpoint — includes spend from ads in ANY status (ACTIVE/PAUSED/DISABLED/ARCHIVED). |
meta_ads_ads | List ads with creatives (image, video, copy) and performance insights. |
meta_ads_realtime | Hourly realtime dashboard for today. |
meta_ads_adset_detail | Get detailed ad set info: targeting, budget, schedule, billing, optimization goal, delivery status. |
meta_ads_pages_list | Read Facebook Pages data. Actions: list — all pages the user manages (name, fan_count, followers) insights — page engagement metrics (follows, views) for a specific page posts — recent posts with likes, comments, shar… |
meta_ads_pages_insights | Read Facebook Pages data. Actions: list — all pages the user manages (name, fan_count, followers) insights — page engagement metrics (follows, views) for a specific page posts — recent posts with likes, comments, shar… |
meta_ads_pages_posts | Read Facebook Pages data. Actions: list — all pages the user manages (name, fan_count, followers) insights — page engagement metrics (follows, views) for a specific page posts — recent posts with likes, comments, shar… |
meta_ads_pages_post_insights | Read Facebook Pages data. Actions: list — all pages the user manages (name, fan_count, followers) insights — page engagement metrics (follows, views) for a specific page posts — recent posts with likes, comments, shar… |
meta_ads_business_list | Read Facebook Business Manager data. |
meta_ads_business_accounts | Read Facebook Business Manager data. |
meta_ads_business_pages | Read Facebook Business Manager data. |
meta_ads_business_users | Read Facebook Business Manager data. |
meta_ads_business_pixels | Read Facebook Business Manager data. |
meta_ads_media_list_images | List uploaded media in the ad account. |
meta_ads_media_list_videos | List uploaded media in the ad account. |
meta_ads_audience | List Custom Audiences in the ad account. |
meta_ads_campaign_write_create | Create, update, pause or activate Meta Ads campaigns. |
meta_ads_campaign_write_update | Create, update, pause or activate Meta Ads campaigns. |
meta_ads_campaign_write_pause | Create, update, pause or activate Meta Ads campaigns. |
meta_ads_campaign_write_activate | Create, update, pause or activate Meta Ads campaigns. |
meta_ads_campaign_delete | Permanently delete a Meta Ads campaign. |
meta_ads_adset_write_create | Create or update Meta Ads ad sets. |
meta_ads_adset_write_update | Create or update Meta Ads ad sets. |
meta_ads_adset_delete | Permanently delete a Meta Ads ad set. |
meta_ads_creative_write_create_creative | Create ad creatives and ads (final step to launch). |
meta_ads_creative_write_create_ad | Create ad creatives and ads (final step to launch). |
meta_ads_creative_write_update_ad | Create ad creatives and ads (final step to launch). |
meta_ads_creative_delete | Permanently delete a Meta Ads ad. |
meta_ads_media_write_upload_image | Upload images and videos to Meta Ads account. |
meta_ads_media_write_upload_video | Upload images and videos to Meta Ads account. |
meta_ads_media_write_get_upload_command | Upload images and videos to Meta Ads account. |
meta_ads_audience_write_create | Manage Custom Audiences for targeting. |
meta_ads_audience_write_add_users | Manage Custom Audiences for targeting. |
meta_ads_audience_delete | Permanently delete a Custom Audience. |
Detalhe de cada tool: docs/ferramentas.md
Preços
Grátis.
Privacidade & LGPD
- Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
- Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.
Perguntas frequentes
O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.
Posso usar com agente próprio (não Claude/Cursor)?
Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_meta_ads.
Suporte
Licença
MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_meta_ads é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.
الأسئلة الشائعة
ما هو Meta Ads (Facebook & Instagram)؟
Read and manage Meta Ads campaigns, ad sets, ads, audiences, pages and Business Manager. You provide
كيف أثبّت Meta Ads (Facebook & Instagram)؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http meta-ads-facebook-instagram 'https://api.mcp.ai/p_meta_ads'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Meta Ads (Facebook & Instagram) إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Meta Ads (Facebook & Instagram) مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Meta Ads (Facebook & Instagram)؟
ينشره mcp-dir. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.