Yhdistä tekoälyavustajat (MCP) #

Your AI Connector toimittaa virallisen MCP-palvelimen – Model Context Protocol -päätepisteen, jonka avulla tekoälyavustajat, kuten Claude Code, Claude Desktop, Cursor ja omat sovelluksesi, voivat hallita Your AI Connector-tiliäsi suoraan. Kysy selkokielellä (“list my AI agents”, “add this lead”, “what did AI cost me this week?”), niin avustaja kutsuu Your AI Connector-rajapintaa puolestasi.

Se on sama v1-rajapinta, jota käytät API-avaimella, todennettuna omalla API-avaimellasi. MCP-palvelin luo yhden työkalun jokaiselle julkaistun API-määrityksemme toiminnolle, joten se kattaa suurimman osan, muttei kaikkea, v1-rajapinnasta: yhteystiedot, viestit, kampanjat, tekoälyagentit, mukautetut toiminnot, tietokannan, tapaamiset, analytiikan, tunnisteet, listat, lähetykset, kaupat, kanavayhteydet ja alitilit. Automaatiot voidaan listata ja lukea, mutta niitä ei voi vielä luoda tai muokata MCP:n kautta; luo ne sovelluksessa. Sen tarjoamien toimintojen sisällä ei ole työkalukohtaisia käyttöoikeuksia eikä oletusarvoista vain luku -tilaa, joten API-avain toimii koko käyttöoikeuksien hallintana.

• Päätepiste: https://mcp.youraiconnector.com/mcp
• Todennus: Your AI Connector API-avaimesi (lähetetään X-API-Key-otsikkotietona)
• Vaatimukset: tilaus, jossa on API-pääsy. 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 ai-connector https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Suorita sitten /mcp Claude Codessa varmistaaksesi, että se näyttää ai-connector ✓ 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": {
    "ai-connector": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop #

Lisää palvelin mukautettuna liittimenä (custom connector). Se määritetään Claude-tililläsi, joten se toimii sekä Claude Desktopissa että osoitteessa claude.ai (ilmaiset Claude-tilit voivat lisätä yhden mukautetun liittimen).

1. Avaa Customize → Connectors, napsauta + Add ja valitse Add custom connector.
2. Anna sille nimi ja syötä https://mcp.youraiconnector.com/mcp URL-osoitteeksi.
3. Valitse kohdassa Authentication vaihtoehto No sign in. MCP-palvelimella ei ole kirjautumissivua: kirjautumisvaihtoehdon valitseminen johtaa virheeseen “Couldn’t register with … sign-in service”.
4. Lisää kohdassa Request headers otsikko nimeltä X-API-Key, jonka arvona on API-avaimesi.
5. Napsauta Add. Your AI Connector-työkalut näkyvät uuden keskustelun työkalupalkissa.

Eikö Request headers -kenttää näy? Claude Desktop -versiosi on vanhentunut: päivitä se tai käytä sen sijaan asetustiedostoa. Asetustiedosto (claude_desktop_config.json, Settings → Developer → Edit Config) suorittaa ohjelmia vain tietokoneellasi ja ohittaa url-merkinnän, joten se tarvitsee pienen mcp-remote-sillan, joka vaatii Node.js 18 -version tai uudemman:

{
  "mcpServers": {
    "ai-connector": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.youraiconnector.com/mcp",
        "--header",
        "X-API-Key:${AI_CONNECTOR_KEY}"
      ],
      "env": { "AI_CONNECTOR_KEY": "YOUR_API_KEY" }
    }
  }
}

Pidä X-API-Key:${AI_CONNECTOR_KEY} täsmälleen sellaisena kuin se on kirjoitettu, ilman välilyöntiä kaksoispisteen jälkeen (Windowsissa välilyönti rikkoo otsikon), ja aseta avaimesi vain kohtaan env. Sulje sen jälkeen Claude Desktop kokonaan (Windowsissa napsauta tehtäväpalkin kuvaketta hiiren kakkospainikkeella → Quit) ja avaa se uudelleen.

ChatGPT #

ChatGPT ei voi muodostaa yhteyttä MCP-palvelimeen tällä hetkellä. Sen mukautettu yhdistinlomake tarjoaa vain OAuth- tai Ei todennusta -vaihtoehdot, ja Your AI Connector MCP - palvelin kirjautuu sisään API-avaimellasi, joka lähetetään pyynnön otsikkotiedoissa. OAuthin valitseminen epäonnistuu virheeseen “could not discover OAuth settings”, ja “Ei todennusta” -vaihtoehto hylätään, koska jokainen pyyntö vaatii avaimen.

Käytä avustajaa, jonka avulla voit määrittää pyynnön otsikkotiedot: Claude Code, Claude Desktop, Cursor tai muu MCP-asiakasohjelma tai Claude API.

ChatGPT voi silti lukea ohjedokumentaatiota ilman yhteyttä: katso Ohjedokumentaatio on sisäänrakennettu julkisia llms.txt-tiedostoja varten.

Cursor ja muut MCP-asiakasohjelmat #

Useimmat MCP-yhteensopivat editorit käyttävät samaa yllä näkyvää .mcp.json-muotoa (HTTP-palvelin, jossa on url ja X-API-Key-otsikkotieto). Lisää ai-connector-palvelin, joka osoittaa kohteeseen https://mcp.youraiconnector.com/mcp, ja liitä API-avaimesi otsikkotietoon.

Claude API (integroi omaan sovellukseesi) #

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

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my AI agents" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "ai-connector",
      "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:

• Tekoälyagentit: listaa, luo, päivitä, keskeytä/jatka, tarkastele asetuksia.
• Yhteystiedot: etsi, luo, merkitse, lisää listoille, tuo.
• Tietokanta / 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 yhteyden tila, 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?”
• “Mitä tekoäly maksoi kullekin asiakkaalleni tällä viikolla?”
• “Mikä on Northside Dentalin kanavien tila, ja kuinka monta keskustelua tuli tällä viikolla?”

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 vaihtaminen toimii samalla tavalla. Jokainen toiminto, joka hyväksyy asiakastilin API:ssa, on käytettävissä nimetylle asiakkaalle: tekoälyagenttien, tietokannan, mukautettujen toimintojen, WhatsApp-mallien, sisääntulopisteiden, kanavayhteyksien, yhteystietojen, tunnisteiden, lähetysten, tapaamisten, kauppojen ja tehtävien määrittäminen sekä viestien lähettäminen. Poikkeuksia ovat toimistotason toiminnot, jotka suoritetaan aina omalla toimistotililläsi: itse asiakastilien hallinta (rajat, ominaisuudet, hinnoittelu, keskeyttäminen), tilannevedokset, tiimisi ja API-avaimet. Yhteystietojen lisääminen asiakkaan listalle tai niiden poistaminen sieltä ei ole vielä mahdollista nimetylle asiakkaalle; tee se kyseisen asiakkaan omalla avaimella tai heidän tilillään. Toimiston API-opas listaa tuetut toiminnot.

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.

Asiakkaan agentin testaaminen #

Pyydä avustajaa kokeilemaan asiakkaan agenttia (“lähetä ‘toimitatteko sunnuntaisin?’ asiakkaan X leipomoagentille ja näytä minulle, mitä se teki”). Se lähettää kokeiluviestin (Try Out) toimistoavaimellasi ja asiakkaan sub_account_id-tunnuksella, odottaa ja lukee vastauksen sekä mahdolliset agentin suorittamat toiminnot. Agentista ei tarvita kopiota. Jos avustaja ilmoittaa, ettet ole toimistotili, se on yhdistetty asiakkaan avaimella: yhdistä se uudelleen toimistotilisi avaimella. Katso Kokeileminen.

Asiakkaat, joilla on työkalurajoitus #

https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages

Ohjedokumentaatio on sisäänrakennettu #

MCP-palvelin antaa avustajalle pääsyn tiliisi ja tähän dokumentaatioon. Kolme työkalua lukee ohjedokumentaatiota reaaliajassa, joten avustaja voi tarkistaa, miten jokin ominaisuus toimii tai mitä on hiljattain muuttunut, sen sijaan että se arvailisi:

• docs_search: etsii kysymykseen vastaavat osiot ja palauttaa ne sivulinkin kera.
• docs_read: lukee yhden sivun kokonaan tai yhden sen osion.
• docs_list: listaa jokaisen sivun alueittain.

Mitään ei tarvitse määrittää, eivätkä ohjetyökalut koske tilitietoihisi. Kysy “miten sisääntulopisteet toimivat?” tai “mitä uutta automaatioissa on?”, niin avustaja etsii ensin dokumentaatiosta. Koska työkalut lukevat itse ohjesivustoa, avustajasi tietää ominaisuudesta heti, kun sen opas on julkaistu.

Avustaja, jota ei ole yhdistetty MCP:n kautta, voi silti lukea dokumentaatiota: osoita se kohteeseen https://docs.youraiconnector.com/llms.txt (hakemisto jokaisesta ohjesivusta 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ä.

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 #

• “Connection refused” tai “not found” — 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.
• “Could not discover OAuth settings” (ChatGPT) — ChatGPT tukee mukautetuissa liittimissä vain OAuth-tunnistautumista tai ei tunnistautumista lainkaan, ja MCP-palvelin käyttää API-avainta, joten ChatGPT ei voi muodostaa yhteyttä tällä hetkellä. Katso ChatGPT.
• “Couldn’t register with … sign-in service” tai “add an OAuth Client ID” (Claude Desktop) — mukautettu liitin lisättiin kirjautumisvaihtoehdon kanssa. Syötettävää OAuth-asiakastunnusta ei ole: poista liitin ja lisää se uudelleen valitsemalla Authentication → No sign in ja lisäämällä API-avaimesi X-API-Key-pyyntöotsikkona, kuten kohdassa Claude Desktop.
• Claude Desktop ei näytä työkaluja asetustiedoston muokkaamisen jälkeen — asetustiedosto ohittaa "url"-merkinnän; käytä mukautettua liitintä tai mcp-remote-lomaketta kohdassa Claude Desktop ja sulje sekä avaa sovellus kokonaan uudelleen.
• Työkalu palauttaa 403 — tilauksesi tai tiimiroolisi ei salli kyseistä toimintoa; MCP-palvelin ei aseta mitään ylimääräisiä rajoituksia, 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; yhdistä uudelleen päivittääksesi tiedot.
• Tietoturva- tai varmennevaroitus omalla verkkotunnuksellasi — DNS-tietueen osoittaminen meille ei yksinään 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 -kortin kautta kohdassa Settings → White Labeling — lisää CNAME-tietue rekisteröijäsi palvelussa, syötä isäntänimi MCP domain (AI assistants) -lohkoon ja napsauta Verify. Tämä on sama prosessi kuin muiden brändättyjen aliverkkotunnustesi kohdalla. Brändätty osoite jättää toimistotyökalut pois; jatka tavallisen, brändäämättömän osoitteen käyttöä niiden kohdalla. Käytä brändäämätöntä osoitetta, kunnes brändätty osoitteesi on vahvistettu: se on turvallista jakaa asiakkaiden kanssa.

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.