DM Champ Docs

Yhdistä tekoälyavustajat (MCP)

DM Champ toimittaa virallisen MCP-palvelimen – Model Context Protocol -päätepisteen, jonka avulla tekoälyavustajat, kuten Claude Code, Claude Desktop, ChatGPT, Cursor ja omat sovelluksesi, voivat käyttää DM Champ-tiliäsi suoraan. Kysy selkokielellä (“listaa aktiiviset kampanjani”, “lisää tämä liidi”, “mitä tekoäly maksoi minulle tällä viikolla?”) niin avustaja kutsuu DM Champ APIa puolestasi.

Kyseessä on sama v1-rajapinta, joka on dokumentoitu API-osiossa, ja se todennetaan omalla API-avaimellasi. MCP-palvelin luo yhden työkalun jokaiselle julkaistun API-määrityksemme toiminnolle, joten se kattaa suurimman osan, mutta ei kaikkea v1-rajapinnasta: yhteystiedot, viestit, kampanjat, tekoälyagentit, tietokannan, tapaamiset, analytiikan, tunnisteet, listat ja alitilit. Lähetykset, automaatiot ja kaupat eivät ole vielä käytettävissä MCP-työkaluina – käytä niihin suoraan REST APIa. Sen tarjoamien toimintojen osalta ei ole työkalu- tai käyttäjäkohtaisia oikeuksia eikä oletusarvoista vain luku -tilaa, joten API-avain toimii koko pääsynhallintana.

  • Päätepiste: https://mcp.youraiconnector.com/mcp
  • Todennus: DM Champ API-avaimesi (lähetetään X-API-Key-otsakkeena)
  • Vaatimukset: tilaus, jossa on API-käyttöoikeus. Luo API-avain →

API-avaimesi toimii omalla tililläsi samoilla oikeuksilla kuin muu rajapinta – ja se voi lukea hallinnoimiasi asiakastilejä, jos sinulla on toimistotilaus (katso alta). Käsittele sitä kuin salasanaa. Voit peruuttaa sen milloin tahansa kohdasta Asetukset → Integraatiot → API-avain, mikä katkaisee avustajan pääsyn välittömästi.

Claude Code

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

Suorita sitten /mcp Claude Codessa varmistaaksesi, että se näyttää dm-champ ✓ connected.

Oletusarvoisesti palvelin lisätään paikalliseen laajuuteen (vain sinä, tämä projekti). Käytä --scope user-komentoa tehdäksesi siitä saatavilla kaikissa projekteissasi, tai --scope project to commit it to a repo’s .mcp.json tiimillesi:

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

Claude Desktop

Muokkaa claude_desktop_config.json-tiedostoasi (Settings → Developer → Edit Config) ja lisää:

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

Käynnistä Claude Desktop uudelleen. DM Champ-työkalut ilmestyvät työkalujen valikkoon.

ChatGPT

Mukautetut MCP-liittimet ovat käytettävissä ChatGPT Business-, Enterprise- ja Pro-versioissa. Työtilan omistajan tai ylläpitäjän on ensin otettava käyttöön developer mode / custom connectors työtilan asetuksista – ilman tätä liittimen luomismahdollisuus ei tule näkyviin.

Luo sitten liitin seuraavilla tiedoilla:

  • URL: https://mcp.youraiconnector.com/mcp
  • Todennus: Mukautetut otsakkeet
  • Otsakkeen nimi: X-API-Key
  • Otsakkeen arvo: DM Champ API-avaimesi

URL-osoitteen on päätyttävä osoitteeseen /mcp. Pelkän https://mcp.youraiconnector.com-osoitteen liittäminen on yleisin virhe – ChatGPT tarkistaa kyseisen osoitteen, ei löydä sieltä mitään ja näyttää virheen “Unable to add connector URL”.

Cursor ja muut MCP-asiakasohjelmat

Useimmat MCP-yhteensopivat editorit käyttävät samaa .mcp.json-rakennetta kuin yllä (HTTP-palvelin, jossa on url ja X-API-Key-otsikko). Lisää dm-champ-palvelin, joka osoittaa kohteeseen https://mcp.youraiconnector.com/mcp, ja liitä API-avaimesi otsikkoon.

Claude API (integroi omaan sovellukseesi)

Voit yhdistää MCP-palvelimen ohjelmallisesti Claude APIn MCP-liittimellä, joten rakentamasi agentti voi käyttää DM Champ-työkaluja ilman erillistä asiakasohjelmaa:

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

Mitä voit tehdä

MCP-palvelimen paljastaman v1-rajapinnan osan sisällä avustaja valitsee oikean työkalun automaattisesti:

  • Kampanjat: listaa, luo, päivitä, keskeytä/jatka, tarkastele bottiasetuksia.
  • Yhteystiedot: etsi, luo, lisää tunnisteita, lisää listoille, tuo.
  • Tietopankki / UKK: lisää, muokkaa, tuo massana, hyväksy tekoälyn ehdotuksia.
  • Viestit: lue keskusteluja, lähetä viesti yhteystiedolle.
  • Ajanvaraukset: listaa, varaa, peruuta.
  • Tehtävät: luo, suorita, listaa.
  • Analytiikka: viestitilastot, krediittien käyttö, tekoälyn kustannukset.
  • Kanavat: tarkista yhteystila, aloita yhteysprosessi.

Kysyminen asiakkaidesi tileistä (toimistot)

Yksi yhteys kattaa jokaisen hallinnoimasi tilin. Sinun ei tarvitse lisätä toista yhteyttä asiakasta kohden: toimistotilauksessa avustaja voi lukea mitä tahansa alaisuudessasi olevaa asiakastiliä, joten voit kysyä niistä kaikista yhden keskustelun aikana.

Mainitse vain asiakkaan nimi:

  • “Kuinka monta yhteystietoa Bella’s Bistrolla on?”
  • “Paljonko tekoäly maksoi kullekin asiakkaalleni tällä viikolla?”
  • “Mitkä kampanjat ovat käynnissä Northside Dentalilla ja mikä on heidän kanaviensa tila?”

Tämä kattaa yhteystietojen, viestien, keskustelujen, kampanjoiden, tapaamisten, tehtävien, tunnisteiden, tapahtumien, UKK-tietojen, tietokantalähteiden, puhelinnumeroiden, kanavien, webhookien ja analytiikan lukemisen. Tarkistamme, että tili on todella sinun ennen kuin mitään suoritetaan – jos kysyt tiliä, joka ei ole sinun, vastaukseksi tulee “ei löytynyt”. Jätä asiakas pois, niin avustaja lukee omaa tiliäsi täsmälleen kuten aiemminkin.

Asiakkaan tilin muuttaminen on rajoitetumpaa. AI-agenttien, mukautettujen funktioiden, WhatsApp-mallien, sisääntulopisteiden, kanavayhteyksien, kampanjan tilan määrittäminen ja numeron ostaminen toimivat nimetylle asiakkaalle; useimmat muut kirjoitustoiminnot suoritetaan edelleen omalla tililläsi, joten tee ne kyseisen asiakkaan omalla avaimella tai REST API:n kautta, joka kattaa enemmän. Tämä on myös vastaus asiakkaalle, joka pyörittää useita yrityksiä yhden kirjautumisen alla. Anna jokaiselle yritykselle oma tili ja kutsu sitten asiakkaan sähköpostiosoite tiimin jäseneksi niihin kaikkiin: he kirjautuvat sisään kerran ja vaihtavat brändiensä välillä sivupalkin tilivalitsimella.

Ohjeiden antaminen avustajallesi

MCP-palvelin antaa avustajalle pääsyn tiliisi; se ei anna sille tätä dokumentaatiota. Jos haluat sen vastaavan oikein myös “miten teen…” -kysymyksiin, osoita se kohteeseen https://docs.youraiconnector.com/llms.txt (hakemisto kaikista ohjesivuista linkkeineen kunkin sivun Markdown-versioon) tai https://docs.youraiconnector.com/llms-full.txt (koko dokumentaatio yhdessä Markdown-tiedostossa). Molemmat ovat julkisia, eivät vaadi avainta, ja ne päivitetään jokaisen dokumentaatiomuutoksen yhteydessä. Katso Näiden ohjeiden lukeminen Markdown-muodossa.

API-avaimen etsiminen tai luominen

Tämän yhteyden käyttämä API-avain löytyy kohdasta Asetukset → Integraatiot → API-avain — se on oma osionsa, erillään Webhookeista. Katso API-käyttöoikeus tarkat ohjeet.

Vianmääritys

  • “Unable to add connector URL” (ChatGPT) / “connection refused” — osoitteen lopusta puuttuu /mcp. Käytä https://mcp.youraiconnector.com/mcp, älä https://mcp.youraiconnector.com.
  • Needs authentication / 401 — API-avaimesi puuttuu tai on väärä. Lisää palvelin uudelleen kelvollisella X-API-Key-avaimella.
  • Työkalu palauttaa 403 — tilauksesi tai tiimiroolisi ei salli kyseistä toimintoa; MCP-palvelin ei aseta mitään ylimääräistä, vaan kyseessä on sama käyttöoikeustarkistus kuin API:ssa.
  • Työkalua ei löydy — työkaluluettelo luodaan reaaliajassa API:sta, joten se vastaa aina nykyistä versiota; päivitä yhteys muodostamalla se uudelleen.
  • Tietoturva- tai varmennevaroitus omalla verkkotunnuksellasi — DNS-tietueen osoittaminen meille ei yksin riitä: aliverkkotunnus on myös vahvistettava hallintapaneelissa, ennen kuin se voi tarjota suojatun yhteyden. White-label-toimistot voivat asettaa MCP-osoitteen omalle verkkotunnukselleen (esim. mcp.youragency.com) Custom domain -kortista kohdasta Settings → White Labeling — lisää ensin CNAME-tietue rekisterinpitäjälläsi, syötä sitten isäntänimi MCP domain (AI assistants) -lohkoon ja napsauta Verify. Prosessi on sama kuin muiden brändättyjen aliverkkotunnustesi kohdalla. Käytä standardiosoitetta yllä, kunnes vahvistus on tehty — se ei ole brändätty, joten sen jakaminen asiakkaiden kanssa on turvallista.

Seuraavat vaiheet

  • API-käyttöoikeus — luo tai vaihda tämän yhteyden käyttämä avain.
  • Webhookit — tämän pull-pohjaisen MCP-yhteyden push-pohjainen vastine.