# Anslut AI-assistenter (MCP)

<span data-t="appName">DM Champ</span> levererar en officiell **MCP-server** — en Model Context Protocol-slutpunkt
som låter AI-assistenter som **Claude Code**, **Claude Desktop**, **ChatGPT**,
**Cursor** och dina egna appar styra ditt <span data-t="appName">DM Champ</span>-konto direkt. Fråga på vanligt språk
("lista mina aktiva kampanjer", "lägg till detta lead", "vad kostade AI mig den här veckan?")
och assistenten anropar <span data-t="appName">DM Champ</span>-API:et åt dig.

Det är samma v1-API som dokumenteras i [API-avsnittet](../api/getting-started.md), autentiserat
med din egen API-nyckel. MCP-servern bygger ett verktyg för varje åtgärd i vår publicerade API-
specifikation, så den täcker det mesta, men inte allt, av v1-API:et: kontakter, meddelanden, kampanjer,
AI-agenter, kunskapsbas, möten, analys, taggar, listor och underkonton. Sändningar,
automatiseringar och affärer är ännu inte tillgängliga som MCP-verktyg — använd REST-API:et direkt för dessa.
Inom det som exponeras finns inga behörigheter per verktyg och ingen skrivskyddad
standard, så API-nyckeln utgör hela åtkomstkontrollen.

- **Slutpunkt:** `https://mcp.youraiconnector.com/mcp`
- **Autentisering:** din <span data-t="appName">DM Champ</span>-API-nyckel (skickas som `X-API-Key`-huvud)
- **Kräver:** en plan med API-åtkomst. [Skapa en API-nyckel →](api-access.md#generating-your-api-key)

> Din API-nyckel agerar på **ditt eget konto**, med samma behörigheter som
> resten av API:et — och kan läsa klientkonton som du hanterar, om du har en
> byråplan (se nedan). Behandla den som ett lösenord. Du kan när som helst återkalla den via
> Inställningar → Integrationer → API-nyckel, vilket omedelbart bryter assistentens åtkomst.

## Claude Code

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

Kör sedan `/mcp` inuti Claude Code för att bekräfta att den visar **dm-champ ✓ ansluten**.

Som standard läggs servern till med **lokal** omfattning (endast du, detta projekt).
Använd `--scope user` för att göra den tillgänglig i alla dina projekt, eller `--scope
project` to commit it to a repo's `.mcp.json` för ditt team:

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

## Claude Desktop

Redigera din `claude_desktop_config.json` (Inställningar → Utvecklare → Redigera konfiguration) och
lägg till:

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

Starta om Claude Desktop. <span data-t="appName">DM Champ</span>-verktyg visas i verktygsmenyn.

## ChatGPT

Anpassade MCP-anslutningar finns tillgängliga i ChatGPT Business, Enterprise och Pro. En
arbetsyteägare eller administratör måste först aktivera **developer mode / custom connectors**
i arbetsytans inställningar — utan detta visas aldrig alternativet för att skapa en anslutning.

Skapa sedan anslutningen med:

- **URL:** `https://mcp.youraiconnector.com/mcp`
- **Autentisering:** Anpassade huvuden
- **Huvudnamn:** `X-API-Key`
- **Huvudvärde:** din <span data-t="appName">DM Champ</span>-API-nyckel

URL:en måste sluta på `/mcp`. Att bara klistra in `https://mcp.youraiconnector.com` är det vanligaste
misstaget — ChatGPT kontrollerar den exakta adressen, hittar ingenting där och
visar **"Unable to add connector URL"**.

## Cursor och andra MCP-klienter

De flesta MCP-kompatibla redigerare använder samma `.mcp.json`-format som visas ovan (en HTTP-
server med en `url` och ett `X-API-Key`-huvud). Lägg till en `dm-champ`-server som pekar
på `https://mcp.youraiconnector.com/mcp` och klistra in din API-nyckel i huvudet.

## Claude API (bygg in det i din egen app)

Du kan ansluta MCP-servern programmatiskt med Claude API:ets MCP-
anslutning, så att en agent du bygger kan använda <span data-t="appName">DM Champ</span>-verktyg utan 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"
    }
  ]
}
```

## Vad du kan göra

Inom den del av v1-API:et som MCP-servern exponerar väljer assistenten rätt verktyg automatiskt:

- **Kampanjer:** lista, skapa, uppdatera, pausa/återuppta, inspektera bot-konfiguration.
- **Kontakter:** sök, skapa, tagga, lägg till i listor, importera.
- **Kunskapsbas / FAQ:** lägg till, redigera, massimportera, godkänn AI-förslag.
- **Meddelanden:** läs konversationer, skicka ett meddelande till en kontakt.
- **Bokningar:** lista, boka, avboka.
- **Uppgifter:** skapa, slutför, lista.
- **Analys:** meddelandestatistik, kreditförbrukning, AI-kostnad.
- **Kanaler:** kontrollera anslutningsstatus, starta ett anslutningsflöde.

## Frågor om dina klienters konton (byråer)

En anslutning täcker varje konto du hanterar. Du behöver inte lägga till en andra anslutning
per klient: på en byråplan kan assistenten läsa alla klientkonton under dig,
så du kan ställa frågor om alla i en och samma konversation.

Ange bara klientens namn:

- "Hur många kontakter har Bella's Bistro?"
- "Vad kostade AI för var och en av mina klienter den här veckan?"
- "Vilka kampanjer är aktiva för Northside Dental, och vad är statusen för deras kanaler?"

Detta omfattar läsning av kontakter, meddelanden, chattar, kampanjer, möten, uppgifter, taggar,
händelser, vanliga frågor, kunskapsbaskällor, telefonnummer, kanaler, webhooks och analys.
Vi kontrollerar att kontot verkligen är ditt innan något körs — om du frågar efter ett konto som inte är det
returneras "hittades ej". Utelämna klienten så läser assistenten ditt eget
konto, precis som tidigare.

**Att ändra en klients konto** är mer begränsat. Att ställa in AI-agenter, anpassade funktioner, WhatsApp-mallar, ingångspunkter, kanalanslutningar, kampanjstatus och att köpa ett nummer fungerar för en namngiven klient; de flesta andra skrivåtgärder körs fortfarande på ditt eget konto, så utför dessa från klientens egen nyckel eller från [REST API](../agency/api-for-agencies.md), som täcker mer.

Detta är också svaret för en klient som driver **flera företag under en
inloggning**. Ge varje företag ett eget konto och bjud sedan in klientens e-postadress som
teammedlem på alla: de loggar in en gång och växlar mellan sina varumärken med
kontoväljaren i sidofältet.

## Ge din assistent hjälp-dokumentationen

MCP-servern ger en assistent ditt **konto**; den ger den inte denna dokumentation. Om du även vill att den ska kunna svara korrekt på "hur gör jag…"-frågor, peka den mot `https://docs.dmchamp.com/llms.txt` (ett index över varje hjälpsida med en länk till varje sidas Markdown-version) eller `https://docs.dmchamp.com/llms-full.txt` (hela dokumentationen i en Markdown-fil). Båda är publika, kräver ingen nyckel och återskapas vid varje ändring i dokumentationen. Se [Läsa dessa dokument som Markdown](../api/getting-started.md#reading-these-docs-as-markdown).

## Hitta eller generera din API-nyckel

API-nyckeln som denna anslutning använder finns under **Inställningar → Integrationer → API-nyckel** — en egen sektion, separat från Webhooks. Se [API-åtkomst](api-access.md#generating-your-api-key) för de exakta stegen.

## Felsökning

- **"Unable to add connector URL" (ChatGPT) / "connection refused"** — adressen saknar `/mcp` i slutet. Använd `https://mcp.youraiconnector.com/mcp`, inte `https://mcp.youraiconnector.com`.
- **`Needs authentication` / 401** — din API-nyckel saknas eller är felaktig. Lägg till servern igen med en giltig `X-API-Key`.
- **Ett verktyg returnerar `403`** — din plan eller din roll i teamet tillåter inte den åtgärden; MCP-servern framtvingar inget extra, det är samma behörighetskontroll som för API:et.
- **Verktyget hittades inte** — verktygslistan genereras live från API:et, så den matchar alltid den aktuella versionen; återanslut för att uppdatera.
- **En säkerhets- eller certifikatvarning på din egen domän** — att peka en DNS-post mot oss räcker inte i sig: underdomänen måste också verifieras i instrumentpanelen innan den kan tillhandahålla en säker anslutning. White-label-byråer kan placera MCP-adressen på sin egen domän (t.ex. `mcp.youragency.com`) från kortet **Custom domain** under **Settings → White Labeling** — lägg till CNAME hos din registrar först, ange sedan värdnamnet i blocket **MCP domain (AI assistants)** och klicka på **Verify**, samma flöde som för dina andra varumärkesanpassade underdomäner. Tills den är verifierad, använd standardadressen ovan — den är inte varumärkesanpassad, så den är säker att dela med kunder.

---

## Nästa steg

- [API-åtkomst](api-access.md) — generera eller rotera nyckeln som denna anslutning använder.
- [Webhooks](webhooks.md) — den push-baserade motsvarigheten till denna pull-baserade MCP-anslutning.