Meta App und System-User-Token einrichten

1. Auf developers.facebook.com/apps anmelden und auf »Create app« klicken.
2. Vergib einen Namen (z. B. claude-meta-mcp) und eine Kontakt-E-Mail. Die Business-Portfolio-Zuordnung kannst du jetzt überspringen — die machen wir in Schritt 3.
3. Nach dem Anlegen landest du im App-Dashboard.

Im App-Dashboard auf »Use cases → Add use case« und folgende fünf Cases anlegen — zusammen decken sie das komplette v0.4-Toolset (47 Tools) ab:

• »Measure ad performance with Marketing API« → liefert ads_read, business_management, read_insights
• »Create and manage ads with Marketing API« → liefert ads_management, business_management
• »Manage everything on your Page« → liefert pages_show_list, pages_manage_posts, pages_manage_metadata, pages_read_engagement
• »Manage messaging and content on Instagram« → liefert instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights
• »Manage products with Catalog API« → liefert catalog_management (für Product-Catalog-Inspektion: Businesses, Catalogs, Feeds, Produkte, Diagnostics)

Nach Auswahl dieser Use Cases zeigt der App-Tab »Permissions and Features« jede Berechtigung als »Standard Access (granted by default)« — für eigene Assets musst du nichts beim App Review einreichen.

1. Im Meta-Developer-Dashboard auf »App settings → Basic«.
2. Ganz nach unten zu »Business Portfolio« scrollen.
3. Existierendes Portfolio auswählen oder »Create new«, falls du noch keines hast.
4. Unten »Save changes« klicken.

Verifiziere unter business.facebook.com → Settings → Accounts → Apps, dass die App jetzt in der Liste auftaucht.

1. In business.facebook.com → Settings (unten links) → Users → System Users.
2. »Add« → Name z. B. claude-mcp → Rolle: Admin (System Admin).
3. Den neuen System-User anklicken, um den Detail-Panel zu öffnen.

Im System-User-Detail-Panel jeweils »Add Assets« klicken:

• Tab Apps → claude-meta-mcp anhaken → Rolle »Develop app« oder »Manage app«.
• Tab Ad Accounts → dein Ad Account anhaken, Permissions: »Manage campaigns« + »View performance«.
• Tab Pages → die Page anhaken, Permissions: »Create content« + »Manage Page posts« + »View Page insights«.
• Tab Catalogs → den Product Catalog anhaken (Permission: »View catalog«). Nur nötig, wenn du die v0.4-Product-Catalog-Tools nutzen willst.

Der Instagram-Business-Account wird automatisch über die zugehörige Facebook-Page erreichbar — separate Zuweisung nicht nötig.

1. Im System-User-Detail-Panel auf den Tab »Tokens« → »Generate New Token«.
2. »Select App«: claude-meta-mcp wählen — bindet das Token an deine App-Signing-Keys.
3. »Token expiration«: »Never« — genau das ist der Sinn eines System-User-Tokens.
4. Permissions: alle für das v0.4-Toolset benötigten Scopes (siehe Liste unten) anhaken.
5. »Generate Token« → der Token erscheint einmalig. Auf den Copy-Button klicken — nicht den dargestellten String per Maus markieren, Meta verschleiert ihn visuell bis zum Klick.

Volle Scope-Liste für v0.4 (47 Tools):

• ads_read, ads_management, business_management
• pages_show_list, pages_manage_posts, pages_manage_metadata, pages_read_engagement
• instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights
• catalog_management (für die v0.4 Product-Catalog-Tools — Catalogs, Feeds, Produkte, Diagnostics)
• optional: read_insights

Auf developers.facebook.com/tools/debug/accesstoken/ den Token einfügen. Du solltest sehen:

• Type: System User
• App ID: deine App-ID
• Expires: Never
• Scopes: die 12+ ausgewählten Permissions

# am Server, NICHT durch Drittanbieter:
nano /var/www/connector/.env
# Zeile setzen:
META_ACCESS_TOKEN=EAA...

# Connector neuladen:
pm2 reload claude-meta-mcp --update-env
# oder
systemctl restart claude-meta-mcp

Schnell-Check, dass alles greift:

TOKEN=$(grep ^META_ACCESS_TOKEN /var/www/connector/.env | cut -d= -f2-)

curl -s "https://graph.facebook.com/v22.0/me?access_token=$TOKEN" | jq
# → {"name":"<dein system user name>","id":"..."}

curl -s "https://graph.facebook.com/v22.0/me/adaccounts?fields=id,name&access_token=$TOKEN" | jq
# → Liste der zugewiesenen Ad Accounts

curl -s "https://graph.facebook.com/v22.0/me/accounts?fields=id,name&access_token=$TOKEN" | jq
# → Liste der zugewiesenen Pages