Obsah

Meta Ads AI Connectors: MCP server a Ads CLI

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.

Co Meta vydala

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.

MCP server

Oficiální endpoint

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.

Co MCP server umí

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.

Jak MCP přidat do AI nástroje

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:

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

https://mcp.facebook.com/ads

Přihlas se přes Meta/Facebook OAuth a vyber účet, který má přístup k reklamnímu účtu.
Povol jen oprávnění, která dávají smysl pro zamýšlené použití.
Nejdřív otestuj read-only dotazy, například výpis reklamních účtů nebo reporting kampaní.
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.

Ads CLI

Instalace

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

Autentizace a účet

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

Struktura příkazů

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>

Hlavní oblasti CLI

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

Automatizace

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

MCP vs CLI

Věc	MCP server	Ads CLI
Primární použití	AI agent v nástroji typu Claude, ChatGPT nebo Perplexity	Terminál, skripty, CI/CD
Přístup	Remote MCP endpoint	Lokální CLI balíček `meta-ads`
Autentizace	OAuth přes Meta/Facebook	System user access token
Vhodné pro	Přirozený jazyk, analýzy, ad hoc workflow	Opakovatelné příkazy, automatizace, exporty
Riziko	Agent může navrhovat a po autorizaci provádět změny	Skript může změnit kampaně bez dalšího kontextu

Bezpečnostní poznámky

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.