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 kelvollisellaX-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.