Meta Ads AI Connectors: MCP server a Ads CLI

Vytvořeno: 3.5.2026 | Aktualizováno: 03.05.2026 03:59

Meta Ads AI Connectors je open beta sada od Meta pro správu reklam přes AI nástroje a terminál. Obsahuje oficiální remote MCP server pro napojení AI agentů na Meta reklamní účet a Ads CLI pro práci s Meta Marketing API z příkazové řádky.

Meta oznámila dvě navazující části:

• Meta ads MCP server – vzdálený MCP server pro práci s reklamním účtem z AI nástrojů.
• Ads CLI – oficiální CLI nástroj pro skriptování a automatizaci nad Meta Marketing API.

Podle oznámení Meta jsou AI connectors určené pro tvorbu, správu a analýzu kampaní přímo v nástrojích, kde už uživatel pracuje. Prakticky jde o dvě různé cesty ke stejným reklamním datům: MCP je vhodné pro AI agenty, CLI pro terminál, skripty a CI/CD.

Oficiální remote MCP endpoint je mcp.facebook.com/ads:

https://mcp.facebook.com/ads

Endpoint bez přihlášení vrací HTTP 401 a odkazuje na OAuth protected resource metadata. Metadata jsou dostupná na .well-known/oauth-protected-resource/ads a uvádějí podporované scope:

ads_management
ads_read
catalog_management
business_management

OAuth authorization metadata jsou dostupná na .well-known/oauth-authorization-server/ads. Ukazují, že autorizace běží přes Facebook OAuth a token endpoint Graph API.

Podle Meta Business Help Center může ads MCP server pomoci hlavně s těmito oblastmi:

• Reporting – získávání insightů a detailních reportů k výkonu kampaní.
• Správa reklam – tvorba a editace reklam, ad setů a kampaní.
• Katalogy – tvorba katalogu, přidání produktových dat a troubleshooting feedů nebo viditelnosti položek.
• Signal diagnostics – kontrola zdraví a kvality signálů.
• Help & troubleshooting – vyhledávání relevantních článků v Meta Business Help Center.

Meta uvádí, že pro nástroje pro správu reklam a katalogů existují i write capabilities. Zároveň platí, že akce vyžadují autorizaci přes AI agenta.

Konkrétní UI se liší podle AI platformy. Meta Help Center uvádí jako aktuálně podporované AI agenty ChatGPT, Claude a Perplexity. Obecný postup je:

1. V AI nástroji otevři nastavení konektorů / integrací / remote MCP serverů.
2. Přidej nový remote MCP server s URL:

https://mcp.facebook.com/ads

1. Přihlas se přes Meta/Facebook OAuth a vyber účet, který má přístup k reklamnímu účtu.
2. Povol jen oprávnění, která dávají smysl pro zamýšlené použití.
3. Nejdřív otestuj read-only dotazy, například výpis reklamních účtů nebo reporting kampaní.
4. Až potom používej write operace, které mění kampaně, reklamy nebo katalogy.

Podle oznámení Meta není pro MCP potřeba vlastní developer credentials, API setup ani psaní kódu. Prakticky ale pořád probíhá autorizace uživatele a přístup je omezený oprávněními účtu.

Oficiální balíček je meta-ads na PyPI. Pozor na podobně pojmenované komunitní balíčky typu meta-ads-cli – oficiální balíček Meta se instaluje jako meta-ads.

Požadavky podle dokumentace:

• Python 3.12 nebo novější
• virtuální prostředí
• pip nebo uv
• Meta system user access token
• ID reklamního účtu

Instalace:

pip install meta-ads

Get Started dokumentace uvádí, že Ads CLI používá Meta system user access token. Token je možné nastavit přes proměnnou prostředí:

export ACCESS_TOKEN=<ACCESS_TOKEN>

Většina příkazů potřebuje ID reklamního účtu. To lze nastavit přes .env, proměnnou prostředí nebo flag u konkrétního příkazu:

# Via .env
AD_ACCOUNT_ID=<AD_ACCOUNT_ID>
 
# Via environment variable
export AD_ACCOUNT_ID=<AD_ACCOUNT_ID>
 
# Via flag u konkrétního příkazu
meta ads --ad-account-id <AD_ACCOUNT_ID> campaign list

Kontrola autentizace a výpis dostupných účtů:

meta auth status
meta ads adaccount list

Ads CLI Overview popisuje příkazy vzorem:

meta ads <resource> <action> [options]

Příklady:

meta ads campaign list
meta ads insights get --date-preset last_7d

Command Reference uvádí také samostatnou větev pro autentizaci:

meta auth <action>

Podle dokumentace a PyPI popisu umí Ads CLI pracovat hlavně s těmito zdroji:

• adaccount – reklamní účty
• campaign – kampaně
• adset – sady reklam
• ad – reklamy
• creative – kreativy
• catalog – produktové katalogy
• page – stránky
• product-set – produktové sady
• product-item – produkty
• product-feed – feedy
• dataset – datasety / pixely
• insights – výkon a reporting

Příklad vytvoření kampaně podle blogu Meta:

meta ads campaign create \
  --name "Summer Sale" \
  --objective OUTCOME_SALES \
  --daily-budget 5000

Příklad získání výkonu kampaně:

meta ads insights get \
  --campaign_id <CAMPAIGN_ID> \
  --fields=impressions,conversions \
  --date-preset last_7d

Ads CLI je navržené i pro skripty a automatizaci. Podle dokumentace podporuje:

• výstup table pro člověka,
• výstup json pro zpracování přes jq nebo další nástroje,
• výstup plain jako tab-separated formát,
• .env soubory pro konfiguraci,
• –no-input a –force pro neinteraktivní běh,
• konzistentní exit kódy pro skripty.

Příklad JSON výstupu:

meta ads campaign list --output json

• Nejdřív testuj na účtu nebo kampani, kde případná chyba nezpůsobí škodu.
• Tokeny nikdy neukládej do repozitáře ani do historie shellu.
• Pro CLI používej co nejmenší potřebná oprávnění a oddělený system user token.
• U MCP si před potvrzením write akce zkontroluj, co agent skutečně mění.
• Meta u Ads CLI uvádí, že nově vytvářené resources jsou vytvořené ve stavu PAUSED by default, aby nic nezačalo běžet dřív, než je to zkontrolované.
• Funkce je v open beta a Meta Help Center uvádí upozornění, že k ní účet nemusí mít přístup.

• Meta – Introducing Meta Ads AI Connectors
• Meta Business Help Center – Manage ads from an AI agent with Meta ads AI connectors
• Meta ads MCP endpoint
• OAuth protected resource metadata pro ads MCP
• OAuth authorization server metadata pro ads MCP
• Meta Developers Blog – Introducing Ads CLI
• Ads CLI Overview
• Ads CLI – Get Started
• Ads CLI – Command Reference
• PyPI – meta-ads