Serwer MCP Efekto: zgłoszenia od klientów z Twojego agenta AI
Efekto przynosi małym firmom zgłoszenia od klientów z reklam na Facebooku, Instagramie i w Google: robi reklamy ze strony firmy, publikuje je i codziennie wyłącza to, co nie przynosi zgłoszeń. Serwer MCP pozwala dowolnemu agentowi AI pokazać podgląd reklam, sprawdzić, czego brakuje do startu, zatwierdzić i opublikować reklamy oraz odczytać wyniki i nowe zgłoszenia - w imieniu właściciela, po jego zalogowaniu.
Adres serwera (Streamable HTTP)
https://efekto.ai/api/mcp
Logowanie
- OAuth 2.1 z PKCE (S256). Obsługiwana rejestracja dynamiczna (RFC 7591) i dokumenty metadanych klienta - większości agentów wystarczy sam adres.
- Wykrywanie: /.well-known/oauth-protected-resource/api/mcp i /.well-known/oauth-authorization-server (RFC 9728, RFC 8414).
- Właściciel loguje się do Efekto i zatwierdza aplikację na ekranie zgody. Token dostępu 1 godzina, token odświeżania 60 dni (rotowany).
- Zakres = konto Efekto użytkownika (wszystkie jego firmy; przy kilku podaj brand_id).
- Odłączenie w każdej chwili: Ustawienia > Pomiar i CRM > Połączone aplikacje AI. Dostęp znika od razu.
Narzędzia
preview_ads_from_website(odczyt) - 3 gotowe reklamy na Facebooka/Instagrama i przykładowe zgłoszenie z adresu strony (1-2 min).list_businesses(odczyt) - Firmy na koncie (id, strona, budżet, stan kampanii).get_account_status(odczyt) - Czego brakuje do startu i następny krok, z linkiem do ekranu Efekto.get_campaign_results(odczyt) - Wydatek, zgłoszenia (zakupy w sklepach), koszt zgłoszenia - 7 i 30 dni, per produkt lub usługa.list_leads(odczyt) - Ostatnie zgłoszenia z odpowiedziami z formularza; imię, telefon i e-mail tylko dla właściciela konta.list_pending_ads(odczyt) - Reklamy czekające na decyzję właściciela.approve_ads(zapis) - Zatwierdzenie propozycji reklam (samo nie wydaje pieniędzy).reject_ad(zapis) - Odrzucenie reklamy z powodem - Efekto robi następczynię.set_daily_budget(zapis) - Zmiana budżetu dziennego (min. 50 zł / 15 w innych walutach, max 5x na raz). Właściciel lub administrator.pause_campaign / resume_campaign(zapis) - Wstrzymanie albo wznowienie całej kampanii. Właściciel lub administrator.publish_ads(zapis) - Jak przycisk Publikuj. Gdy brakuje płatności, budżetu, konta, strony albo formularza - link do dokończenia w Efekto, nic nie wychodzi.
Bezpieczeństwo i limity
- Żadne narzędzie nie rusza pieniędzy: płatność za plan, doładowanie budżetu i zmianę planu robi właściciel w Efekto - narzędzie oddaje link.
- Zmiana budżetu i pauza: tylko właściciel konta albo administrator; minimum 50 zł / 15 w innych walutach dziennie, najwyżej 5x obecny budżet na raz.
- Imię, telefon i e-mail klientów widzi tylko właściciel konta.
- Każde wywołanie narzędzia trafia do dziennika konta. Limity: 60 wywołań na minutę na połączenie, 5 nowych podglądów stron dziennie na użytkownika.
- Firmy usługowe: pierwsze zgłoszenia od klientów w 7 dni od startu albo zwrot za pierwszy miesiąc abonamentu (warunki w regulaminie, część o gwarancji). Sklepy internetowe: pierwsze dodania do koszyka z reklam w 7 dni od startu albo zwrot za pierwszy miesiąc (piksel w sklepie musi wysyłać dodania do koszyka).