Public API + MCP

Beállítások → API-kulcsok: név + jogosultságok (Olvasás · Űrlap-létrehozás · Kampánylánc a sorba · Push indítása) → a kulcs (adsp_sk_…) egyetlen egyszer jelenik meg, másold ki azonnal. A kulcs a te jogosultságaiddal jár el: csak azokat a fiókokat éri el, amiket te, és a Megtekintő-szerep API-n át is csak olvas.

A kulcsot jelszóként kezeld — chatbe, repóba, megosztott dokumentumba soha ne kerüljön. Visszavonni bármikor tudod ugyanitt.

Minden kérés Authorization: Bearer <kulcs> fejléccel megy. Főbb végpontok: GET /api/v1/accounts (fióklista — a visszakapott tükör-id megy a többi útvonalba), GET /accounts/:id/leads (szűrők + lapozás, max 200/lap), GET/POST /accounts/:id/leadforms (űrlap-lista + űrlap-létrehozás a builder teljes szabályrendszerével), GET /accounts/:id/insights (napi bontás + összesítő), GET/POST /accounts/:id/changes (változás-sor olvasás + CREATE-spec sorba állítás), POST /accounts/:id/push (push-indítás + job-poll).

Hibaformátum: { error, detail } — űrlap-elutasításnál a detail.message a Meta valódi indoklása.

curl -H "Authorization: Bearer $ADSP_KEY" https://adspilot.im/api/v1/accounts

A repóban kapott mcp/adspilot-mcp.mjs egy függőség nélküli MCP-szerver 9 tool-lal (fiókok, űrlapok, űrlap-create, leadek, insights, változás-sor, push). Konfiguráció két env-változóval: ADSPILOT_API_KEY és opcionálisan ADSPILOT_BASE_URL.

claude mcp add adspilot -e ADSPILOT_API_KEY=adsp_sk_... -- node mcp/adspilot-mcp.mjs

A kulcs sosem tárolódik visszafejthetően (csak SHA-256 hash). Minden create szüneteltetve, a változás-soron át születik; push csak explicit hívásra fut. A jogosultság-feloldás ugyanaz a lánc, mint a felületen — az API sosem lát többet, mint a kulcs gazdája.