# AI-assistenten verbinden (MCP)

<span data-t="appName">DM Champ</span> levert een officiële **MCP-server** — een Model Context Protocol-eindpunt
dat AI-assistenten zoals **Claude Code**, **Claude Desktop**, **ChatGPT**,
**Cursor** en je eigen apps in staat stelt om je <span data-t="appName">DM Champ</span>-account direct aan te sturen. Vraag het in gewone taal
("lijst mijn live campagnes op", "voeg deze lead toe", "wat heeft AI me deze week gekost?")
en de assistent roept de <span data-t="appName">DM Champ</span> API voor je aan.

Het is dezelfde v1 API als gedocumenteerd in de [API-sectie](../api/getting-started.md), geauthenticeerd
met je eigen API-sleutel. De MCP-server bouwt één tool voor elke operatie in onze gepubliceerde API-
specificatie, dus het dekt het grootste deel, maar niet alles, van de v1 API: contacten, berichten, campagnes,
AI-agents, kennisbank, afspraken, analytics, tags, lijsten en sub-accounts. Broadcasts,
Automatiseringen en Deals zijn nog niet beschikbaar als MCP-tools — gebruik hiervoor rechtstreeks de REST API.
Binnen wat het blootstelt zijn er geen machtigingen per tool en geen standaard
alléén-lezen-modus, dus de API-sleutel is de volledige toegangscontrole.

- **Eindpunt:** `https://mcp.youraiconnector.com/mcp`
- **Authenticatie:** je <span data-t="appName">DM Champ</span> API-sleutel (verzonden als de `X-API-Key`-header)
- **Vereist:** een abonnement met API-toegang. [Maak een API-sleutel aan →](api-access.md#generating-your-api-key)

> Je API-sleutel werkt op **je eigen account**, met dezelfde machtigingen als de
> rest van de API — en kan de klantaccounts lezen die je beheert, als je een
> agency-abonnement hebt (zie hieronder). Behandel het als een wachtwoord. Je kunt het op elk moment intrekken via
> Instellingen → Integraties → API-sleutel, wat de toegang van de assistent onmiddellijk blokkeert.

## Claude Code

```bash
claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"
```

Voer vervolgens `/mcp` uit in Claude Code om te bevestigen dat **dm-champ ✓ verbonden** wordt weergegeven.

Standaard wordt de server toegevoegd op **lokaal** niveau (alleen jij, dit project).
Gebruik `--scope user` om deze beschikbaar te maken in al je projecten, of `--scope
project` to commit it to a repo's `.mcp.json` voor je team:

```json
{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

## Claude Desktop

Bewerk je `claude_desktop_config.json` (Instellingen → Ontwikkelaar → Config bewerken) en
voeg toe:

```json
{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

Start Claude Desktop opnieuw op. <span data-t="appName">DM Champ</span>-tools verschijnen in het tools-menu.

## ChatGPT

Aangepaste MCP-connectors zijn beschikbaar op ChatGPT Business, Enterprise en Pro. Een
werkruimte-eigenaar of beheerder moet eerst **developer mode / custom connectors**
inschakelen in de instellingen van de werkruimte — zonder dit verschijnt de optie om een connector
te maken nooit.

Maak vervolgens de connector aan met:

- **URL:** `https://mcp.youraiconnector.com/mcp`
- **Authenticatie:** Aangepaste headers
- **Header-naam:** `X-API-Key`
- **Header-waarde:** je <span data-t="appName">DM Champ</span> API-sleutel

De URL moet eindigen op `/mcp`. Alleen `https://mcp.youraiconnector.com` plakken is de meest
voorkomende fout — ChatGPT controleert dat exacte adres, vindt daar niets en
toont **"Unable to add connector URL"**.

## Cursor & andere MCP-clients

De meeste MCP-compatibele editors gebruiken dezelfde `.mcp.json`-vorm als hierboven getoond (een HTTP-
server met een `url` en een `X-API-Key` header). Voeg een `dm-champ`-server toe die wijst
naar `https://mcp.youraiconnector.com/mcp` en plak je API-sleutel in de header.

## De Claude API (inbouwen in je eigen app)

Je kunt de MCP-server programmatisch verbinden met de MCP-connector van de Claude API, zodat een agent die je bouwt <span data-t="appName">DM Champ</span>-tools kan gebruiken zonder een aparte
client:

```json
{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}
```

## Wat u kunt doen

Binnen het deel van de v1 API dat de MCP-server blootstelt, kiest de assistent automatisch de juiste tool:

- **Campagnes:** weergeven, aanmaken, bijwerken, pauzeren/hervatten, bot-configuratie inspecteren.
- **Contacten:** zoeken, aanmaken, labelen, toevoegen aan lijsten, importeren.
- **Kennisbank / Veelgestelde vragen:** toevoegen, bewerken, bulk-import, AI-suggesties goedkeuren.
- **Berichten:** gesprekken lezen, een bericht sturen naar een contact.
- **Afspraken:** weergeven, boeken, annuleren.
- **Taken:** aanmaken, voltooien, weergeven.
- **Analytics:** berichtstatistieken, kredietverbruik, AI-kosten.
- **Kanalen:** verbindingsstatus controleren, een verbindingsstroom starten.

## Vragen over de accounts van je klanten (bureaus)

Eén verbinding dekt elk account dat je beheert. Je hoeft geen tweede verbinding toe te voegen
per klant: bij een agency-abonnement kan de assistent elk klantaccount onder jou lezen,
dus je kunt in één gesprek over ze allemaal vragen stellen.

Noem simpelweg de klant:

- "Hoeveel contacten heeft Bella's Bistro?"
- "Wat kostte AI deze week voor elk van mijn klanten?"
- "Welke campagnes zijn live voor Northside Dental, en wat is de status van hun kanalen?"

Dit omvat het lezen van contacten, berichten, chats, campagnes, afspraken, taken, tags,
gebeurtenissen, veelgestelde vragen, kennisbankbronnen, telefoonnummers, kanalen, webhooks en analytics.
We controleren of het account echt van jou is voordat er iets wordt uitgevoerd — vragen naar een account dat niet van jou is,
resulteert in "niet gevonden". Laat de klant weg en de assistent leest je eigen
account, precies zoals voorheen.

**Het wijzigen van een klantaccount** is beperkter. Het instellen van AI-agents, aangepaste functies, WhatsApp-sjablonen, toegangspunten, kanaalverbindingen, campagnestatus en het kopen van een nummer werken allemaal voor een benoemde klant; de meeste andere schrijfacties worden nog steeds uitgevoerd op uw eigen account, dus voer die uit vanaf de eigen sleutel van die klant of via de [REST API](../agency/api-for-agencies.md), die meer omvat.

Dit is ook het antwoord voor een klant die **meerdere bedrijven onder één
inloggegevens** beheert. Geef elk bedrijf een eigen account en nodig vervolgens het e-mailadres van de klant uit als
lid van het team voor al deze accounts: ze loggen één keer in en schakelen tussen hun merken met
de accountkiezer in de zijbalk.

## Je assistent voorzien van de helpdocumentatie

De MCP-server geeft een assistent toegang tot je **account**; het geeft deze niet toegang tot deze documentatie. Als je wilt dat de assistent ook "hoe doe ik..."-vragen correct beantwoordt, verwijs deze dan naar `https://docs.dmchamp.com/llms.txt` (een index van elke helppagina met een link naar de Markdown-versie van elke pagina) of `https://docs.dmchamp.com/llms-full.txt` (de volledige documentatie in één Markdown-bestand). Beide zijn openbaar, vereisen geen sleutel en worden bij elke wijziging in de documentatie opnieuw gegenereerd. Zie [Deze documentatie lezen als Markdown](../api/getting-started.md#reading-these-docs-as-markdown).

## Je API-sleutel vinden of genereren

De API-sleutel die deze verbinding gebruikt, bevindt zich onder **Instellingen → Integraties → API-sleutel** — een eigen sectie, los van Webhooks. Zie [API-toegang](api-access.md#generating-your-api-key) voor de exacte stappen.

## Probleemoplossing

- **"Unable to add connector URL" (ChatGPT) / "connection refused"** — het
  adres mist de `/mcp` aan het einde. Gebruik
  `https://mcp.youraiconnector.com/mcp`, niet `https://mcp.youraiconnector.com`.
- **`Needs authentication` / 401** — uw API-sleutel ontbreekt of is onjuist. Voeg de
  server opnieuw toe met een geldige `X-API-Key`.
- **Een tool retourneert `403`** — uw abonnement of teamrol staat die actie niet toe;
  de MCP-server dwingt niets extra's af, het is dezelfde machtigingscontrole als de
  API.
- **Tool niet gevonden** — de toollijst wordt live gegenereerd vanuit de API, dus deze
  komt altijd overeen met de huidige versie; maak opnieuw verbinding om te vernieuwen.
- **Een beveiligings- of certificaatwaarschuwing op uw eigen domein** — het verwijzen van een DNS-
  record naar ons is op zichzelf niet voldoende: het subdomein moet ook worden geverifieerd
  in het dashboard voordat het een beveiligde verbinding kan aanbieden. White-label
  bureaus kunnen het MCP-adres op hun eigen domein plaatsen (bijv.
  `mcp.youragency.com`) via de kaart **Aangepast domein** onder **Instellingen →
  White Labeling** — voeg eerst het CNAME toe bij uw registrar, voer daarna de
  hostnaam in het blok **MCP-domein (AI-assistenten)** in en klik op **Verifiëren**,
  dezelfde procedure als voor uw andere branded subdomeinen. Gebruik totdat het is geverifieerd het standaardadres hierboven — dit is
  niet voorzien van een merknaam, dus het is veilig om met klanten te delen.

---

## Volgende stappen

- [API-toegang](api-access.md) — genereer of roteer de sleutel die deze verbinding gebruikt.
- [Webhooks](webhooks.md) — de push-gebaseerde tegenhanger van deze pull-gebaseerde MCP-verbinding.