> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/faq/faq-nl/marketingoptimalisatie/koppel-claude-aan-de-data-assistant.md).

# Koppel Claude aan de Data Assistant

Koppel Claude aan je AdPage-account via de AdPage MCP-server. Claude meldt zich aan met OAuth, dus er hoeft geen token te worden gekopieerd. Vervolgens kan het je GA4, Google Ads, Meta Ads, TikTok, LinkedIn, Magen

***

### Wat is de AdPage × Claude-integratie?

[Claude](https://claude.ai/) is de AI-assistent van Anthropic. Voeg de AdPage MCP-server toe als een **connector** en Claude krijgt directe toegang tot dezelfde tools als de Data Assistant:

* Server-side trackinggegevens uit ClickHouse, inclusief uitgaande en inkomende verzoeken en webhooklogs
* Gegevens van GA4, Google Ads, Meta Ads, TikTok en LinkedIn
* Gegevens van Magento en Shopify, inclusief bestellingen, voorraad en marketing
* Attributierapporten, funnels en controles op datakwaliteit
* Audits van GTM-containers en validatie van toestemmingsmodus

> 🔐 **Geen token om te kopiëren.** Claude meldt zich aan via OAuth. Je voegt één URL toe, logt één keer in met je AdPage-account, en Claude behoudt de verbinding. Er komt niets geheims in de URL terecht, dus er is geen token dat kan lekken, roteren of per ongeluk in een gedeeld document kan worden geplakt.

> 💡 **Verschil met Manus MCP:** Met Claude stel je een vraag en krijg je in het gesprek een antwoord. Het is snel en interactief, waardoor het beter geschikt is om te verkennen. Manus voert een volledige workflow onbeheerd uit en levert een afgerond document terug. Zie [Verbind Manus AI met de Data Assistant](https://docs.adpage.io/faq/faq-nl/marketingoptimalisatie/koppel-manus-ai-aan-de-data-assistant.md).

***

### Wat heb je nodig?

Voordat je begint, zorg ervoor dat je hebt:

* Een actieve **AdPage-account** met ten minste één container
* Een **Claude-account** — Free, Pro, Max, Team of Enterprise
* Twee minuten

> ⚠️ **Team- en Enterprise-abonnementen:** Alleen een eigenaar of beheerder kan een connector toevoegen voor de hele organisatie. Bij een persoonlijk abonnement voeg je hem voor jezelf toe.

***

### De URL van de AdPage MCP-server

Eén URL werkt voor elke Claude-omgeving — web, desktop en Claude Code:

```
https://mcp.adpage.io/mcp
```

Je kunt hem ook in AdPage kopiëren. Meld je aan op [data.adpage.io](https://data.adpage.io/), selecteer **Integraties** in het linkermenu, scroll naar **Accountintegraties**, en selecteer de **Claude (MCP)** kaart.

***

### Stap 1: Open Connectors in Claude

1. Meld je aan op [claude.ai](https://claude.ai/), of open de desktop-app van Claude.
2. Selecteer je **profielfoto-icoon** en vervolgens **Instellingen**.
3. Selecteer **Connectors** in de zijbalk.
4. Selecteer **Aangepaste connector toevoegen**.

***

### Stap 2: Voeg de AdPage-server toe

Voer de connectorgegevens in.

| Veld                           | Waarde                      | Beschrijving                                        |
| ------------------------------ | --------------------------- | --------------------------------------------------- |
| **Naam**                       | `AdPage`                    | Elke herkenbare naam, zoals `AdPage`                |
| **URL van externe MCP-server** | `https://mcp.adpage.io/mcp` | Dezelfde URL voor elk account — geen token, geen ID |

Selecteer **Toevoegen**.

> 💡 **Geen geavanceerde instellingen nodig.** Laat de velden OAuth-client-ID en clientgeheim leeg. De AdPage-server registreert Claude automatisch, dus je hoeft zelf geen inloggegevens aan te maken.

***

### Stap 3: Meld je aan met je AdPage-account

1. Selecteer **Verbinden** op de AdPage-connector.
2. Er wordt een inlogvenster van AdPage geopend. Meld je aan met je gebruikelijke AdPage-account.
3. Bevestig het toegangsverzoek.

Claude slaat de verbinding op en toont AdPage als **Verbonden**. Je hoeft dit maar één keer te doen — Claude vernieuwt zijn eigen toegang op de achtergrond.

> 🔎 **Wat gebeurt hier:** Dit is een standaard OAuth 2.0-authorisatiecodeflow met PKCE. Claude registreert zichzelf bij de AdPage-server, stuurt je naar de AdPage-inlogpagina, ontvangt een kortlevende code en wisselt die in voor een access token en een refresh token. Die tokens worden opgeslagen in je Claude-account en zijn gekoppeld aan je AdPage-gebruiker, zodat het audittraject per persoon traceerbaar blijft.

***

### Stap 4: Test de verbinding

1. Open een **nieuw gesprek** in Claude.
2. Zorg ervoor dat de **AdPage** connector is ingeschakeld voor het gesprek. Je vindt hem onder het menu voor tools of bijlagen in het berichtvak.
3. Stel een eenvoudige vraag, zoals:

   > *Welke containers zijn beschikbaar in mijn AdPage-account?*
4. Claude roept `list_containers` aan en geeft je containers terug.

Werkt het? Probeer iets groters:

> *Neem mijn hoofdcontainer. Vergelijk de Google Ads-uitgaven, conversies en ROAS van de afgelopen 30 dagen met de 30 dagen daarvoor, en vertel me welke campagnes slechter zijn geworden.*

Claude kiest de container, haalt de gegevens op, vergelijkt de perioden en legt het resultaat uit in het gesprek.

***

### Claude Code

Claude Code gebruikt dezelfde server. Voeg hem toe via de terminal:

```bash
claude mcp add --transport http adpage https://mcp.adpage.io/mcp
```

Voer vervolgens `/mcp` uit in Claude Code en selecteer **adpage** om je aan te melden. Dezelfde OAuth-flow opent in je browser.

Om de server te delen met iedereen die in een repository werkt, commit je een `.mcp.json` in plaats daarvan in de projectroot:

```json
{
  "mcpServers": {
    "adpage": {
      "type": "http",
      "url": "https://mcp.adpage.io/mcp"
    }
  }
}
```

Iedereen meldt zich nog steeds aan met zijn eigen AdPage-account, dus het bestand bevat geen geheimen en kan veilig worden gecommit.

***

### Wat kun je vragen?

| Vraag                                                                   | Wat Claude gebruikt                     |
| ----------------------------------------------------------------------- | --------------------------------------- |
| *Welk kanaal bracht vorige maand de meeste omzet binnen?*               | Attributie- en omzetrapporten           |
| *Toon de conversiefunnel voor mijn webshop over de afgelopen 14 dagen.* | Funnelanalyse                           |
| *Zitten er trackingfouten in mijn container?*                           | Datakwaliteit en platformgezondheid     |
| *Controleer mijn GTM-container op problemen met de toestemmingsmodus.*  | GTM-audit en toestemmingsvalidatie      |
| *Welke producten raakten uit voorraad terwijl ze nog verkeer kregen?*   | Voorraadgegevens van Shopify of Magento |
| *Vergelijk de prestaties van Meta Ads en Google Ads per apparaat.*      | Platformrapporten                       |

***

### Veelvoorkomende problemen

#### De connector verschijnt niet in mijn gesprek

Connectors zijn per gesprek ingeschakeld. Open het menu voor tools of bijlagen in het berichtvak en schakel **AdPage** het in. Bij een Team- of Enterprise-abonnement moet een beheerder mogelijk eerst de connector voor de organisatie toestaan.

#### ‘Kan geen verbinding maken’ bij het toevoegen van de connector

Controleer dat de URL exact `https://mcp.adpage.io/mcp`, zonder afsluitende slash, geen `?token=` erna, en zonder extra spaties. De Claude-connector gebruikt OAuth, dus er is geen token in de URL nodig — een Manus-achtige URL met een token werkt hier niet.

#### Het inlogvenster opent, maar er gebeurt niets

Je browser blokkeert waarschijnlijk de pop-up, of je bent in die browser aangemeld bij een ander AdPage-account. Sta pop-ups toe voor claude.ai, meld je af bij het andere account en selecteer **Verbinden** opnieuw.

#### Claude gebruikt AdPage niet automatisch

Claude beslist per vraag of een connector relevant is. Noem hem expliciet wanneer dat niet zo is:

> *Gebruik de AdPage-connector om …*

#### ‘Niet geautoriseerd’ nadat het eerder wel werkte

Je toegang is ingetrokken of verlopen. Open **Instellingen → Connectors** in Claude, koppel AdPage los en maak opnieuw verbinding.

#### Ik zie geen gegevens van een platform

AdPage MCP geeft alleen gegevens terug van integraties die verbonden zijn met je AdPage-container. In **Integraties → Containerintegraties**, controleer dat het platform actief is voor de container waar je naar vraagt. Dit omvat Google Analytics, Google Ads, Meta Ads, TikTok, LinkedIn, Magento en Shopify.

***

### Beveiliging en best practices

* **Iedereen verbindt met zijn eigen account.** De connector bevat geen gedeeld geheim, dus iedereen meldt zich aan als zichzelf en ziet alleen de containers waartoe hij al toegang heeft in AdPage.
* **Trek de toegang in tijdens offboarding.** Iemand verwijderen uit AdPage beëindigt ook zijn Claude-verbinding. Er is geen apart token om op te sporen.
* **De MCP is grotendeels alleen-lezen.** Claude kan GTM-containers niet wijzigen via MCP. Dat verandert alleen als je expliciet schrijfrechten inschakelt in AdPage, en die acties vereisen goedkeuring.
* **Controleer wat je deelt.** Antwoorden kunnen omzet- en klantgegevens bevatten. Behandel een Claude-gesprek als elk ander document met bedrijfsgegevens.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adpage.io/faq/faq-nl/marketingoptimalisatie/koppel-claude-aan-de-data-assistant.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
