DM Champ Docs

Anslut AI-assistenter (MCP)

DM Champ 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 DM Champ-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 DM Champ-API:et åt dig.

Det är samma v1-API som dokumenteras i API-avsnittet, 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 DM Champ-API-nyckel (skickas som X-API-Key-huvud)
  • Kräver: en plan med API-åtkomst. Skapa en API-nyckel →

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

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:

{
  "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:

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

Starta om Claude Desktop. DM Champ-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 DM Champ-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 DM Champ-verktyg utan en separat klient:

{
  "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, 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.youraiconnector.com/llms.txt (ett index över varje hjälpsida med en länk till varje sidas Markdown-version) eller https://docs.youraiconnector.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.

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 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 — generera eller rotera nyckeln som denna anslutning använder.
  • Webhooks — den push-baserade motsvarigheten till denna pull-baserade MCP-anslutning.