Meta Ads AI Connectors: MCP server a Ads CLI [Wiki]

Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku.
====== Meta Ads AI Connectors: MCP server a Ads CLI ======

//Vytvořeno: **3.5.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://www.facebook.com/business/news/meta-ads-ai-connectors|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 [[https://developers.facebook.com/blog/post/2026/04/29/introducing-ads-cli/|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 [[https://mcp.facebook.com/ads|mcp.facebook.com/ads]]:

<code txt>
https://mcp.facebook.com/ads
</code>

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

<code txt>
ads_management
ads_read
catalog_management
business_management
</code>

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

==== Co MCP server umí ====

Podle [[https://www.facebook.com/business/help/1456422242197840|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:

<code txt>
https://mcp.facebook.com/ads
</code>

  - 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 [[https://pypi.org/project/meta-ads/|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:

<code bash>
pip install meta-ads
</code>

==== Autentizace a účet ====

[[https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/setup/get-started|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í:

<code bash>
export ACCESS_TOKEN=<ACCESS_TOKEN>
</code>

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:

<code bash>
# 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
</code>

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

<code bash>
meta auth status
meta ads adaccount list
</code>

==== Struktura příkazů ====

[[https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/ads-cli-overview|Ads CLI Overview]] popisuje příkazy vzorem:

<code bash>
meta ads <resource> <action> [options]
</code>

Příklady:

<code bash>
meta ads campaign list
meta ads insights get --date-preset last_7d
</code>

[[https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/command-reference|Command Reference]] uvádí také samostatnou větev pro autentizaci:

<code bash>
meta auth <action>
</code>

==== 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:

<code bash>
meta ads campaign create \
  --name "Summer Sale" \
  --objective OUTCOME_SALES \
  --daily-budget 5000
</code>

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

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

==== 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:

<code bash>
meta ads campaign list --output json
</code>

===== 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.

===== Zdroje =====

  * [[https://www.facebook.com/business/news/meta-ads-ai-connectors|Meta – Introducing Meta Ads AI Connectors]]
  * [[https://www.facebook.com/business/help/1456422242197840|Meta Business Help Center – Manage ads from an AI agent with Meta ads AI connectors]]
  * [[https://mcp.facebook.com/ads|Meta ads MCP endpoint]]
  * [[https://mcp.facebook.com/.well-known/oauth-protected-resource/ads|OAuth protected resource metadata pro ads MCP]]
  * [[https://mcp.facebook.com/.well-known/oauth-authorization-server/ads|OAuth authorization server metadata pro ads MCP]]
  * [[https://developers.facebook.com/blog/post/2026/04/29/introducing-ads-cli/|Meta Developers Blog – Introducing Ads CLI]]
  * [[https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/ads-cli-overview|Ads CLI Overview]]
  * [[https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/setup/get-started|Ads CLI – Get Started]]
  * [[https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli/command-reference|Ads CLI – Command Reference]]
  * [[https://pypi.org/project/meta-ads/|PyPI – meta-ads]]