# Yhdistä tekoälyavustajat (MCP)

<span data-t="appName">DM Champ</span> 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ää <span data-t="appName">DM Champ</span>-tiliäsi suoraan. Kysy selkokielellä
("listaa aktiiviset kampanjani", "lisää tämä liidi", "mitä tekoäly maksoi minulle tällä viikolla?")
niin avustaja kutsuu <span data-t="appName">DM Champ</span> APIa puolestasi.

Kyseessä on sama v1-rajapinta, joka on dokumentoitu [API-osiossa](../api/getting-started.md), 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:** <span data-t="appName">DM Champ</span> API-avaimesi (lähetetään `X-API-Key`-otsakkeena)
- **Vaatimukset:** tilaus, jossa on API-käyttöoikeus. [Luo API-avain →](api-access.md#generating-your-api-key)

> 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

```bash
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:

```json
{
  "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ää:

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

Käynnistä Claude Desktop uudelleen. <span data-t="appName">DM Champ</span>-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:** <span data-t="appName">DM Champ</span> 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ää <span data-t="appName">DM Champ</span>-työkaluja ilman erillistä
asiakasohjelmaa:

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

## 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](../agency/api-for-agencies.md):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.dmchamp.com/llms.txt` (hakemisto kaikista ohjesivuista linkkeineen kunkin sivun Markdown-versioon) tai `https://docs.dmchamp.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/getting-started.md#reading-these-docs-as-markdown).

## 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](api-access.md#generating-your-api-key) 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](api-access.md) — luo tai vaihda tämän yhteyden käyttämä avain.
- [Webhookit](webhooks.md) — tämän pull-pohjaisen MCP-yhteyden push-pohjainen vastine.