# Kehittäjät: yhdistä ohjelmisto tai tekoälyavustaja

Avaa tilivalikosta ”Kehittäjät”. Sivun nimi on ”API-asiakas”. Valinta näkyy asiantuntijatilassa ja on merkitty BETA-tunnuksella.

### API-asiakkaan luominen

API-asiakkaiden luominen edellyttää maksullista tilausta tai voimassa olevaa kokeilujaksoa. Asiakkaita voi olla enintään 5.

1. Avaa ”Luo API-asiakas”. Jos sinulla on jo asiakas, napsauta ”Uusi API-avain”.
2. Anna integraatiolle tunnistettava nimi kentässä ”Tunnus”.
3. Napsauta ”Luo API-avain” ja tallenna `client_id` ja `client_secret`. Salaisuus näytetään vain kerran.

<div class="alert">
<p><span class="lead">Tärkeää</span></p>
<p>Pidä salaisuus luottamuksellisena kuten salasana. Käytä sitä vain palvelimella, älä koskaan selainkoodissa tai julkisessa sovelluksessa. Älä liitä sitä keskusteluun tekoälyavustajan kanssa.</p></div>

### Ohjelmiston yhdistäminen

Ohjelmisto vaihtaa nämä tunnistetiedot käyttötunnukseen osoitteessa `https://api2.rentila.com/oauth/token` käyttäen menetelmää `client_credentials`. Sen jälkeen se kutsuu API:a käyttötunnuksella. Käytä samaa tunnusta sen vanhenemiseen asti ja pyydä sitten uusi.

Avaa ”Yhteyden muodostusohjeet” nähdäksesi yhteysesimerkkejä ja ”API-dokumentaatio” tutustuaksesi toimintoihin ja niiden parametreihin.

### Avustajan yhdistäminen MCP:n kautta

1. Lisää MCP-yhteensopivaan asiakasohjelmaan palvelin osoitteella `https://api2.rentila.com/mcp`.
2. Aloita yhdistäminen. Valitse selaimessa avautuvalla Rentila-sivulla tilisi maa ja anna tavalliset kirjautumistietosi.
3. Anna kaksivaiheisen tunnistautumisen koodi pyydettäessä ja palaa asiakasohjelmaan.

Tätä selaimen kautta tehtävää yhteyttä varten ei tarvitse luoda API-asiakasta. Voit sitten pyytää esimerkiksi: ”Listaa kiinteistöni” tai ”Mitä vuokria sain lokakuussa?”. Jotkin toiminnot muuttavat tietojasi: tarkista pyyntö ja asiakasohjelman tarjoamat vahvistukset.

”Claude MCP” kopioi asetuslinkin, jonka voit avata selaimessa. ”Claude Code”, ”Codex” ja ”Cursor” kopioivat asetustekstin valittuun työkaluun. Anna salasanasi vain Rentilan kirjautumissivulla.

### API-asiakkaiden hallinta

Luettelossa näkyvät nimi, `client_id`, luontipäivä ja viimeisin kirjautuminen. Salaisuus pysyy piilossa. Poista asiakas roskakorikuvakkeesta ja vahvista.

Jos kadotat salaisuuden, luo uusi asiakas ja päivitä ohjelmistosi. Jos salaisuus vuotaa, poista myös vaarantunut asiakas. Jos sinulla on jo 5 asiakasta, poista käyttämätön asiakas ennen uuden luomista.

---

https://www.rentila.fi/support/developers-api-mcp
