# Forbind AI-assistenter (MCP)

<span data-t="appName">DM Champ</span> leverer en officiel **MCP-server** — et Model Context Protocol-endepunkt,
der lader AI-assistenter som **Claude Code**, **Claude Desktop**, **ChatGPT**,
**Cursor** og dine egne apps styre din <span data-t="appName">DM Champ</span>-konto direkte. Spørg i almindeligt sprog
("list mine aktive kampagner", "tilføj dette lead", "hvad kostede AI mig i denne uge?")
og assistenten kalder <span data-t="appName">DM Champ</span> API'et for dig.

Det er den samme v1-API, som er dokumenteret i [API-sektionen](../api/getting-started.md), og som godkendes med din egen API-nøgle. MCP-serveren opretter ét værktøj for hver handling i vores publicerede API-specifikation, så den dækker det meste, men ikke alt, af v1-API'en: kontakter, beskeder, kampagner, AI-agenter, vidensbase, aftaler, analyse, tags, lister og underkonti. Udsendelser, automatiseringer og handler er endnu ikke tilgængelige som MCP-værktøjer — brug REST-API'en direkte til disse. Inden for det, den eksponerer, er der ingen tilladelser pr. værktøj og ingen skrivebeskyttet standard, så API-nøglen er hele adgangskontrollen.

- **Endepunkt:** `https://mcp.youraiconnector.com/mcp`
- **Godkendelse:** din <span data-t="appName">DM Champ</span> API-nøgle (sendes som `X-API-Key`-header)
- **Kræver:** et abonnement med API-adgang. [Opret en API-nøgle →](api-access.md#generating-your-api-key)

> Din API-nøgle fungerer på **din egen konto** med de samme tilladelser som resten af API'en — og kan læse de klientkonti, du administrerer, hvis du har en bureauplan (se nedenfor). Behandl den som en adgangskode. Du kan til enhver tid tilbagekalde den under Indstillinger → Integrationer → API-nøgle, hvilket øjeblikkeligt afbryder assistentens adgang.

## Claude Code

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

Kør derefter `/mcp` i Claude Code for at bekræfte, at den viser **dm-champ ✓ connected**.

Som standard tilføjes serveren med **lokalt** omfang (kun dig, dette projekt).
Brug `--scope user` for at gøre den tilgængelig i alle dine projekter, eller `--scope
project` to commit it to a repo's `.mcp.json` for dit team:

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

## Claude Desktop

Rediger din `claude_desktop_config.json` (Indstillinger → Udvikler → Rediger konfiguration) og
tilføj:

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

Genstart Claude Desktop. <span data-t="appName">DM Champ</span>-værktøjer vises i værktøjsmenuen.

## ChatGPT

Brugerdefinerede MCP-connectorer er tilgængelige i ChatGPT Business, Enterprise og Pro. En
arbejdsområdeejer eller administrator skal først aktivere **developer mode / custom connectors**
i arbejdsområdets indstillinger — uden dette vises muligheden for at oprette en connector
aldrig.

Opret derefter connectoren med:

- **URL:** `https://mcp.youraiconnector.com/mcp`
- **Godkendelse:** Brugerdefinerede headere
- **Header-navn:** `X-API-Key`
- **Header-værdi:** din <span data-t="appName">DM Champ</span> API-nøgle

URL'en skal slutte med `/mcp`. At indsætte kun `https://mcp.youraiconnector.com` er den mest
almindelige fejl — ChatGPT tjekker den præcise adresse, finder intet der, og
viser **"Unable to add connector URL"**.

## Cursor & andre MCP-klienter

De fleste MCP-kompatible editorer bruger den samme `.mcp.json`-form som vist ovenfor (en HTTP-
server med en `url` og en `X-API-Key` header). Tilføj en `dm-champ`-server, der peger
på `https://mcp.youraiconnector.com/mcp`, og indsæt din API-nøgle i headeren.

## Claude API (indbyg det i din egen app)

Du kan forbinde MCP-serveren programmatisk med Claude API'ets MCP-
connector, så en agent, du bygger, kan bruge <span data-t="appName">DM Champ</span>-værktøjer uden en separat
klient:

```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"
    }
  ]
}
```

## Hvad du kan gøre

Inden for den del af v1-API'en, som MCP-serveren eksponerer, vælger assistenten automatisk det rigtige værktøj:

- **Kampagner:** list, opret, opdater, sæt på pause/genoptag, inspicer bot-konfiguration.
- **Kontakter:** søg, opret, tag, tilføj til lister, importér.
- **Vidensbase / FAQ'er:** tilføj, redigér, masseimport, godkend AI-forslag.
- **Beskeder:** læs samtaler, send en besked til en kontakt.
- **Aftaler:** list, book, annullér.
- **Opgaver:** opret, fuldfør, list.
- **Analyse:** beskedstatistik, kreditforbrug, AI-omkostninger.
- **Kanaler:** tjek forbindelsesstatus, start et forbindelsesflow.

## Spørgsmål om dine klienters konti (bureauer)

Én forbindelse dækker alle de konti, du administrerer. Du skal ikke tilføje en ekstra forbindelse pr. klient: På en bureauplan kan assistenten læse enhver klientkonto under dig, så du kan spørge om dem alle i én samtale.

Du skal blot nævne klienten:

- "Hvor mange kontakter har Bella's Bistro?"
- "Hvad kostede AI hver af mine klienter i denne uge?"
- "Hvilke kampagner er aktive for Northside Dental, og hvad er status på deres kanaler?"

Dette dækker læsning af kontakter, beskeder, chats, kampagner, aftaler, opgaver, tags, begivenheder, ofte stillede spørgsmål, vidensbasekilder, telefonnumre, kanaler, webhooks og analyse. Vi tjekker, at kontoen rent faktisk er din, før noget køres — hvis du spørger efter en, der ikke er din, returneres "ikke fundet". Udelad klienten, og assistenten læser din egen konto, præcis som før.

**Ændring af en klients konto** er mere begrænset. Opsætning af AI-agenter, brugerdefinerede funktioner, WhatsApp-skabeloner, indgangspunkter, kanalforbindelser, kampagnestatus og køb af et nummer fungerer alt sammen for en navngiven klient; de fleste andre skrivehandlinger kører stadig på din egen konto, så udfør dem fra klientens egen nøgle eller fra [REST API'en](../agency/api-for-agencies.md), som dækker mere.

Dette er også svaret til en klient, der driver **flere virksomheder under ét login**. Giv hver virksomhed sin egen konto, og inviter derefter klientens e-mail som teammedlem på dem alle: De logger ind én gang og skifter mellem deres brands med kontovælgeren i sidepanelet.

## Giv din assistent adgang til hjælpedokumentationen

MCP-serveren giver en assistent adgang til din **konto**; den giver den ikke adgang til denne dokumentation. Hvis du også ønsker, at den skal kunne besvare "hvordan gør jeg..."-spørgsmål korrekt, skal du pege den mod `https://docs.dmchamp.com/llms.txt` (et indeks over alle hjælpesider med et link til hver sides Markdown-version) eller `https://docs.dmchamp.com/llms-full.txt` (hele dokumentationen i én Markdown-fil). Begge er offentlige, kræver ingen nøgle og bliver genopbygget ved hver ændring i dokumentationen. Se [Læs disse dokumenter som Markdown](../api/getting-started.md#reading-these-docs-as-markdown).

## Find eller generer din API-nøgle

Den API-nøgle, som denne forbindelse bruger, findes under **Indstillinger → Integrationer → API-nøgle** — dens egen sektion, adskilt fra Webhooks. Se [API-adgang](api-access.md#generating-your-api-key) for de præcise trin.

## Fejlfinding

- **"Unable to add connector URL" (ChatGPT) / "connection refused"** — adressen mangler `/mcp` til sidst. Brug `https://mcp.youraiconnector.com/mcp`, ikke `https://mcp.youraiconnector.com`.
- **`Needs authentication` / 401** — din API-nøgle mangler eller er forkert. Tilføj serveren igen med en gyldig `X-API-Key`.
- **Et værktøj returnerer `403`** — dit abonnement eller din teamrolle tillader ikke den handling; MCP-serveren håndhæver ikke noget ekstra, det er den samme tilladelseskontrol som API'et.
- **Værktøj ikke fundet** — værktøjslisten genereres live fra API'et, så den matcher altid den aktuelle version; genopret forbindelsen for at opdatere.
- **En sikkerheds- eller certifikatadvarsel på dit eget domæne** — at pege en DNS-post mod os er ikke nok i sig selv: underdomænet skal også verificeres i dashboardet, før det kan levere en sikker forbindelse. White-label-bureauer kan placere MCP-adressen på deres eget domæne (f.eks. `mcp.youragency.com`) fra kortet **Custom domain** under **Settings → White Labeling** — tilføj CNAME hos din registrar først, indtast derefter værtsnavnet i blokken **MCP domain (AI assistants)** og klik på **Verify**, samme fremgangsmåde som for dine andre brandede underdomæner. Indtil det er verificeret, skal du bruge standardadressen ovenfor — den er uden branding, så den er sikker at dele med kunder.

---

## Næste skridt

- [API-adgang](api-access.md) — generer eller roter den nøgle, som denne forbindelse bruger.
- [Webhooks](webhooks.md) — den push-baserede modpart til denne pull-baserede MCP-forbindelse.