Rajapinta ja MCP

Tekoälyagenttisi kirjoittaa skriptin suoraan työtilaasi ja antaa esiintyjälle linkin värjättyyn prompteriin. Sama työtila, samat kategoriat, sama kirjasto kuin sovelluksessa.

Kuuluu Studio- ja Agency-tasoihin. Avaimet luodaan työtilan asetuksissa.

1. Avaa Asetukset → Rajapinta ja MCP – Luo avain ja valitse oikeudet: lukeminen, kirjoittaminen ja tekoäly. Avain näytetään kerran.
2. Lisää palvelin agenttiin – Liitä alla oleva osoite ja avain MCP-asiakkaasi asetuksiin.
3. Pyydä agenttia – «Kirjoita 45 sekunnin esittelyvideo uudelle asiakkaalle ja anna prompterilinkki.»

MCP

Streamable HTTP · Authorization: Bearer kn_pk_…

16 työkalua

• list_categories (read) – Työtilan skriptikategoriat (valinnaisesti alakategorioineen).
• list_subcategories (read) – Kategorian alakategoriat.
• list_brands (read) – Brändiäänet ja niiden sävyohjeet.
• get_scripts (read) – Skriptit suodattimilla; jaetuilla mukana prompterilinkki.
• get_script (read) – Yksi skripti tekstineen, lukuaika kolmella nopeudella ja prompterilinkki.
• search_scripts (read) – Haku otsikoista ja tekstistä.
• estimate_reading_time (read) – Sanamäärä ja kesto nopeuksilla 100, 140 ja 180 sanaa minuutissa.
• get_script_versions (read) – Skriptin versiohistoria.
• create_script (write) – Tallentaa skriptin; share: true palauttaa prompterilinkin.
• update_script (write) – Muuttaa tekstiä tai tietoja.
• get_prompter_link (write) – Linkki, jolla esiintyjä avaa skriptin värjättynä ilman tunnusta.
• archive_script (write) – Siirtää arkistoon, teksti säilyy.
• restore_script (write) – Palauttaa arkistosta.
• schedule_script (write) – Aktivoi skriptin myöhemmin.
• bulk_action (write) – Arkistoi, palauttaa, poistaa tai siirtää monta kerralla.
• generate_script (ai) – Tekoäly kirjoittaa puhuttavan skriptin, tallentaa sen ja antaa prompterilinkin.

REST

• GET /scripts – Listaa skriptit. Parametrit: language, status, category, tag, q, featured, limit, offset.
• GET /scripts/:id – Yksi skripti.
• POST /scripts – Luo skripti (title, content, language, category_id, tags, is_public).
• PUT /scripts/:id – Päivitä skripti.
• POST /scripts/:id/archive – Arkistoi.
• POST /scripts/:id/restore – Palauta arkistosta.
• POST /scripts/bulk – Joukkotoiminto (action, ids).
• DELETE /scripts/:id – Poista pysyvästi.
• GET /scripts/:id/versions – Versiohistoria.
• GET /categories – Kategoriat.
• POST /categories – Luo kategoria.
• GET /brands – Brändiäänet.

Mitä agentit tekevät tällä

Myyntiagentti: viikon videoviestit

Agentti lukee asiakaslistan, kirjoittaa jokaiselle oman 40 sekunnin viestin (generate_script) ja lähettää myyjälle prompterilinkit. Myyjä avaa linkin puhelimella ja lukee.

Sisältöagentti: julkaisukalenteri prompteriin

Agentti tekee maanantaina viikon käsikirjoitukset oikeisiin kategorioihin (create_script) ja ajastaa ne (schedule_script). Kuvauspäivänä ne odottavat kirjastossa.

Toimisto: asiakkaan hyväksymä teksti suoraan esiintyjälle

Kun asiakas hyväksyy tekstin omassa järjestelmässänne, REST-kutsu päivittää skriptin (PUT /scripts/:id) ja esiintyjän linkki näyttää uuden version.

Kysymyksiä

Millä tasolla rajapinta ja MCP ovat mukana?

Kuuluu Studio- ja Agency-tasoihin. Avaimet luodaan työtilan asetuksissa.

Miten agentti tunnistautuu?

Työtilakohtaisella avaimella Authorization: Bearer -otsakkeessa. Avaimet luodaan asetuksissa ja ne voi poistaa käytöstä milloin tahansa.