Connect Adworkin to your AI assistant
Last updated: 19 November 2026
The Adworkin connector (an MCP server) lets Claude, ChatGPT or Gemini answer questions about the e-commerce sales and advertising data of the brands you can access in Adworkin: revenue and orders from your store, ad spend and blended ROAS, Meta Ads and Google Ads campaigns, products and stock, Google Analytics 4 traffic and the AI analyst's daily recommendations. The figures are the same as in the dashboard. The connector is read-only: it cannot change anything in your ad accounts or your store.
Example questions
- "Compare last week's revenue, ad spend and blended ROAS with the week before, and explain the biggest changes."
- "Which Meta and Google Ads campaigns spent the most last month, and which of them had the lowest ROAS?"
- "Which products will run out of stock in the next three weeks while they are still getting ad spend?"
- "Which Google Ads search terms spent money without any conversions in the last 30 days?"
- "What did the AI analyst recommend this morning?"
Before you connect
- You need an Adworkin account with access to at least one brand: a brand managed by Woom Digital (ask your account manager to add your e-mail address), or a Shopify store with the Adworkin app on the Growth plan.
- You sign in with the same Google account you use for the dashboard. No API key is needed.
- Without access to a brand you can still connect, but the assistant will find no data.
Server address:
https://adworkin.com/api/mcp
Claude
On claude.ai, in the Claude desktop app or on mobile:
- Open this link, or go to Settings → Connectors → Add custom connector.
- Name: Adworkin. URL: the server address above. Leave the client ID and secret fields empty.
- Click Connect, sign in with Google, check the brands listed and click Allow.
- In a chat, make sure Adworkin is turned on in the tools menu, then ask your question.
On Team and Enterprise plans an organization owner adds the connector first; members then connect with their own account.
Claude Code:
claude mcp add --transport http ad-intelligence https://adworkin.com/api/mcp
Then run /mcp in Claude Code, choose ad-intelligence and authenticate.
ChatGPT
- On chatgpt.com, open Settings → Apps & Connectors (Plugins). If needed, turn on Developer mode under Advanced settings.
- Create a connector: name Adworkin, MCP server URL the address above, authentication OAuth. Leave the client fields empty.
- Sign in and click Allow on the Adworkin consent screen.
- In a chat, choose Adworkin from the + menu and ask your question.
Custom connectors are available on paid ChatGPT plans. On Business and Enterprise, a workspace admin may need to allow them first. Menu names change often; OpenAI's help center has the current steps.
Gemini
- On gemini.google.com, open Settings → Connectors → Custom.
- Name: Adworkin. URL: the server address above. Authentication: Dynamic Client Registration.
- Click Connect, sign in and click Allow.
Tools
The connector offers 39 read-only tools. Call "List Accessible Brands" first: every other tool needs a brand (its id or exact name) and dates in the brand's time zone. Your assistant picks the tools for you.
| Tool | Name |
|---|---|
| List Accessible Brands | markalar |
| Sales and Ad Spend Summary | ozet_metrikler |
| Monthly Target Progress | hedef_durumu |
| Product Sales and Ad Spend | urunler |
| Meta and Google Ads Campaigns | kampanyalar |
| Ad Performance Breakdowns | reklam_kirilimlari |
| Orders by Sales Channel | siparis_kanallari |
| Sales by Province | iller |
| Out-of-Country Ad Impressions | yurt_disi_gosterim |
| New and Returning Customers | musteriler |
| Discount Codes | indirim_kodlari |
| Metric Anomalies | anomaliler |
| Low Stock Alerts | stok_uyarilari |
| Ad Account Change History | hesap_degisiklikleri |
| Orders by Hour | saatlik_siparisler |
| GA4 Traffic Sources | trafik_kaynaklari |
| Google Ads Search Terms | arama_terimleri |
| Marketplace Orders | pazar_yerleri |
| AI Analyst Morning Report | analist_raporu |
| Google Ads Reports | google_raporlari |
| Google Ads Monthly Report | google_aylik_rapor |
| Google Ads Settings Check | google_ayar_kontrolu |
| Meta Ads Settings Check | meta_ayar_kontrolu |
| Meta Ads Reports | meta_raporlari |
| Ad Sets, Ad Groups and Ads | reklam_setleri |
| Other Ad Channels (Criteo) | kanal_raporlari |
| Wasted Ad Traffic | trafik_sagligi |
| Site Health (GA4 and PageSpeed) | site_sagligi |
| Instagram Account Insights | |
| GA4 Campaigns | trafik_kampanyalari |
| Marketplace Products | pazar_yeri_urunleri |
| Price Comparison Sites | fiyat_karsilastirma_siteleri |
| Daily, Weekly and Monthly Metrics | donemsel_metrikler |
| Budget Simulator | butce_simulatoru |
| Impact of Account Changes | aksiyon_etkileri |
| Frequently Bought Together | birlikte_alinanlar |
| Customer Cohorts | musteri_kohortlari |
| Estimated Profitability (POAS) | karlilik |
| Product Analysis | urun_analizi |
Limits
- 300 tool calls per user in any 24 hours. A typical question uses 2–6 calls.
- Long answers are shortened. If a result is cut off, ask for a shorter date range or fewer rows.
- Date ranges can be up to 400 days.
- For Shopify stores, the connector is part of the Growth plan.
Privacy and security
- The assistant only sees the brands you can see in the dashboard. If you lose access to a brand, so does the assistant.
- No tool can change anything in ad accounts or stores.
- We log each tool call (user, assistant app, brand, tool, time) for security and usage limits. We do not receive or store your conversation.
- Data sent to your assistant is processed by its provider (for example Anthropic, OpenAI or Google) under your agreement with that provider.
Details: Privacy Policy and Terms of Service.
Remove access
Disconnect Adworkin in your assistant's connector settings. Access ends immediately. You can connect again at any time.
Troubleshooting
- "Invalid connection request": the request expired. Start the connection again from your assistant.
- Connected, but no brands: your account is not a member of any brand. Ask the brand's owner or your agency to add your e-mail address, or install the Adworkin app for your Shopify store.
- Brand not found: the brand name is misspelled or you do not have access to it. Ask the assistant to list your brands.
- Growth plan message: the Shopify store is on a plan without this feature.
- Daily limit reached: wait until older calls drop out of the 24-hour window.
- Numbers differ from Meta or Google: revenue comes from your store; platform conversions use each platform's own attribution and the last 1–3 days are not final.
- Sign-in keeps failing: remove the connector, add it again and complete the sign-in within 15 minutes.
Support
See our Support page.
Adworkin'i yapay zekâ asistanınıza bağlayın
Son güncelleme: 19 Kasım 2026
Adworkin bağlayıcısı (MCP sunucusu), Claude, ChatGPT veya Gemini'nin Adworkin'de erişebildiğiniz markaların e-ticaret satış ve reklam verisiyle ilgili sorularınızı yanıtlamasını sağlar: mağaza cirosu ve siparişler, reklam harcaması ve Blended ROAS, Meta Ads ve Google Ads kampanyaları, ürünler ve stok, Google Analytics 4 trafiği ve yapay zekâ analistinin günlük önerileri. Rakamlar paneldekiyle aynıdır. Bağlayıcı yalnızca okur: reklam hesaplarınızda veya mağazanızda hiçbir şeyi değiştiremez.
Örnek sorular
- "Geçen haftanın cirosunu, reklam harcamasını ve Blended ROAS'ını önceki haftayla karşılaştır, en büyük değişimleri açıkla."
- "Geçen ay en çok harcayan Meta ve Google Ads kampanyaları hangileri, hangisinin ROAS'ı en düşük?"
- "Hâlâ reklam harcaması alırken önümüzdeki üç haftada stoğu bitecek ürünler hangileri?"
- "Son 30 günde dönüşüm getirmeden para harcayan Google Ads arama terimleri hangileri?"
- "Yapay zekâ analisti bu sabah ne önerdi?"
Bağlanmadan önce
- En az bir markaya erişimi olan bir Adworkin hesabı gerekir: Woom Digital'in yönettiği bir marka (müşteri temsilcinizden e-posta adresinizi eklemesini isteyin) veya Adworkin uygulaması Growth paketinde kurulu bir Shopify mağazası.
- Panelde kullandığınız Google hesabıyla giriş yaparsınız. API anahtarı gerekmez.
- Hiçbir markaya erişiminiz yoksa da bağlanabilirsiniz, ama asistan veri bulamaz.
Sunucu adresi:
https://adworkin.com/api/mcp
Claude
- Bu bağlantıyı açın veya Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle'ye gidin.
- Ad: Adworkin. URL: yukarıdaki sunucu adresi. İstemci kimliği ve gizli anahtar alanlarını boş bırakın.
- Bağlan'a basın, Google ile giriş yapın, listelenen markaları kontrol edip İzin ver'e basın.
- Sohbette araçlar menüsünde Adworkin'in açık olduğunu kontrol edip sorunuzu sorun.
Team ve Enterprise planlarında bağlayıcıyı önce kuruluş sahibi ekler, üyeler sonra kendi hesaplarıyla bağlanır. Claude Code için yukarıdaki komutu çalıştırıp Claude Code içinde /mcp ile giriş yapın.
ChatGPT
- chatgpt.com'da Ayarlar → Uygulamalar ve Bağlayıcılar'ı (Plugins) açın; gerekirse Gelişmiş ayarlar'da Geliştirici modunu açın.
- Bağlayıcı oluşturun: ad Adworkin, MCP sunucu adresi yukarıdaki adres, kimlik doğrulama OAuth. İstemci alanlarını boş bırakın.
- Giriş yapın ve Adworkin onay ekranında İzin ver'e basın.
- Sohbette + menüsünden Adworkin'i seçip sorunuzu sorun.
Özel bağlayıcılar ChatGPT'nin ücretli planlarında kullanılabilir. Business ve Enterprise'da önce çalışma alanı yöneticisinin izin vermesi gerekebilir. Menü adları sık değişir; güncel adımlar OpenAI yardım merkezindedir.
Gemini
- gemini.google.com'da Ayarlar → Bağlayıcılar → Özel'i açın.
- Ad: Adworkin. URL: yukarıdaki sunucu adresi. Kimlik doğrulama: Dinamik istemci kaydı (Dynamic Client Registration).
- Bağlan'a basın, giriş yapın ve İzin ver'e basın.
Araçlar
Bağlayıcıda 39 salt okunur araç var (liste yukarıda, İngilizce adlarıyla). Önce "List Accessible Brands" (markalar) çağrılır; diğer her araç bir marka (numarası veya tam adı) ve markanın saat dilimine göre tarih ister. Araçları asistanınız kendisi seçer.
Sınırlar
- Kullanıcı başına herhangi bir 24 saatte 300 araç çağrısı. Bir soru genelde 2–6 çağrı yapar.
- Uzun yanıtlar kısaltılır. Sonuç kesilirse daha kısa bir tarih aralığı veya daha az satır isteyin.
- Tarih aralığı en fazla 400 gün olabilir.
- Shopify mağazaları için bağlayıcı Growth paketindedir.
Gizlilik ve güvenlik
- Asistan yalnızca panelde sizin gördüğünüz markaları görür. Bir markaya erişiminiz biterse asistanınki de biter.
- Hiçbir araç reklam hesaplarında veya mağazada bir şey değiştiremez.
- Güvenlik ve kullanım sınırı için her araç çağrısını (kullanıcı, asistan uygulaması, marka, araç, zaman) kaydederiz. Sohbetinizi almayız ve saklamayız.
- Asistanınıza giden veri, o sağlayıcıyla (ör. Anthropic, OpenAI, Google) yaptığınız sözleşmeye göre işlenir.
Ayrıntılar: Gizlilik Politikası ve Kullanım Şartları.
Erişimi kaldırma
Asistanınızın bağlayıcı ayarlarından Adworkin bağlantısını kesin. Erişim hemen sona erer. İstediğiniz zaman yeniden bağlanabilirsiniz.
Sorun giderme
- "Bağlantı isteği geçersiz": isteğin süresi doldu. Bağlantıyı asistanınızdan yeniden başlatın.
- Bağlandı ama marka yok: hesabınız hiçbir markanın üyesi değil. Markanın sahibinden veya ajansınızdan e-posta adresinizi eklemesini isteyin ya da Shopify mağazanız için Adworkin uygulamasını kurun.
- "Marka bulunamadı veya bu markaya erişiminiz yok": marka adı yanlış yazıldı veya erişiminiz yok. Asistandan markalarınızı listelemesini isteyin.
- "… Growth paketinde": Shopify mağazası bu özelliğin olmadığı bir pakette.
- Günlük sınıra ulaşıldı: eski çağrılar 24 saatlik pencereden çıkana kadar bekleyin.
- Rakamlar Meta veya Google'dan farklı: ciro mağazanızdan gelir; platform dönüşümleri her platformun kendi atfıyla sayılır ve son 1–3 gün kesinleşmemiştir.
- Giriş tamamlanmıyor: bağlayıcıyı kaldırıp yeniden ekleyin ve girişi 15 dakika içinde tamamlayın.
Destek
Destek sayfamıza bakın.