MCP-palvelimen ominaisuudet ja audit-loki

Kun Intric muodostaa yhteyden MCP-palvelimeen, se hakee palvelimelta listan sen työkaluista. Alusta kutsuu näitä työkaluja ominaisuuksiksi. Ominaisuudet-sivulla päätät jokaisesta ominaisuudesta erikseen, saako sitä käyttää lainkaan ja pitääkö jonkun hyväksyä jokainen suoritus. Sama asetus ratkaisee, mitä audit-lokiin myöhemmin kirjautuu. Osa valinnoista jättää jäljen jokaisesta suorituksesta, osa ei jätä mitään.

Vain organisaation adminit voivat muuttaa näitä asetuksia. Jos otat palvelinta vasta käyttöön, katso Oman MCP-palvelimen yhdistäminen Intriciin. Sivulta AI-työkalut näet, miten hyväksyntätilat liittyvät muihin AI-työkaluihin.

Ominaisuudet-sivun löytäminen

1. Siirry kohtaan Admin → AI-työkalut ja avaa MCP-välilehti.
2. Avaa MCP-palvelin.
3. Klikkaa kohdan Toiminnot ja käyttöoikeudet alta Ominaisuudet.

Rivillä näkyy yhteenveto jo ennen kuin avaat sen, esimerkiksi 12 työkalua · 3 automaattista. Jos rivillä lukee Ei haettu, Intric ei ole vielä lukenut palvelimen listaa. Hae lista painikkeella Päivitä ominaisuudet.

Videolla näkyy Outlook-integraatio. MCP-palvelimen Ominaisuudet-sivu toimii samalla tavalla.

Hyväksyntätilat

Jokainen ominaisuus näkyy listassa nimellään ja palvelimen antamalla kuvauksella. Kumpaakaan et voi muokata Intricissä, koska molemmat tulevat palvelimelta. Jokaisen ominaisuuden vieressä on kolmiasentoinen kytkin:

Tila	Mitä keskustelussa tapahtuu
Pois	Assistentti ei tiedä ominaisuudesta mitään eikä siksi voi käyttää sitä.
Kysy	Ennen jokaista suoritusta käyttäjä näkee, mitä assistentti haluaa lähettää työkalulle, ja valitsee Hyväksy tai Hylkää.
Auto	Ominaisuus toimii heti eikä kysy käyttäjältä mitään.

Anna käyttäjien hyväksyä itse

Kun Kysy on valittuna, voit lisäksi rastittaa valintaruudun Käyttäjät voivat ottaa automaattisen hyväksynnän käyttöön. Hyväksyntäkorttiin tulee silloin kaksi uutta vaihtoehtoa:

• Salli aina tälle avustajalle: Intric ei enää pyydä tältä käyttäjältä lupaa ennen ominaisuuden suorittamista, kun hän keskustelee juuri tämän assistentin kanssa.
• Salli aina kaikkialla: Intric ei enää pyydä tältä käyttäjältä lupaa ennen ominaisuuden suorittamista missään hänen keskustelussaan.

Käyttäjän täytyy ensin vahvistaa valintansa, ja valinta koskee vain häntä itseään. Keskustelussa näkyy näiden suoritusten kohdalla merkintä Hyväksytty automaattisesti.

Huom.: Käyttäjä ei vielä voi perua automaattista hyväksyntää, jonka hän on kerran antanut. Adminina voit pysäyttää kaikki ominaisuuden automaattiset hyväksynnät: aseta ominaisuus tilaan Kysy ilman valintaruutua tai tilaan Pois. Hyväksynnät kuitenkin säilyvät, ja ne tulevat taas voimaan, jos rastitat valintaruudun uudelleen.

Kun ominaisuuksia on paljon

• Haku ja suodatin Kaikki / Pois / Kysy / Auto auttavat löytämään ominaisuuden. Listan yläpuolella oleva rivi kertoo, montako ominaisuutta kussakin tilassa on.
• Aseta kaikki … tilaan ja Pois / Kysy / Auto muuttavat palvelimen jokaisen ominaisuuden tilan. Toiminto ohittaa käyttämäsi haun ja suodattimen.
• Mikään muutos ei tule voimaan ennen kuin tallennat. Valmis vie sinut takaisin palvelimen paneeliin. Klikkaa siellä Tallenna muutokset. Palauta kumoaa Ominaisuudet-sivulla tekemäsi muutokset.

Oletukset ja huomioitavaa

• Uusi ominaisuus on aluksi tilassa Kysy. Poikkeus on ominaisuus, joka ei palvelimen oman merkinnän mukaan tarvitse lupaa. Sellainen on aluksi tilassa Auto.
• Kun kytket palvelimen päälle, jokainen ominaisuus palaa oletustilaansa. Jos kytket MCP-palvelimen pois päältä ja sitten takaisin päälle, itse asettamasi ominaisuudet palaavat oletustiloihinsa. Tarkista Ominaisuudet-sivu aina, kun olet kytkenyt palvelimen takaisin päälle.
• Voit muuttaa asetuksia vain, kun palvelin on päällä.
• Jos yhtään ominaisuutta ei jää päälle, palvelin kytkeytyy itse pois. Kun asetat jokaisen ominaisuuden tilaan Pois, koko palvelin voi kytkeytyä pois päältä.
• Asetus seuraa ominaisuuden nimeä. Jos palvelin nimeää työkalun uudelleen, Intric pitää sitä uutena ominaisuutena, joka alkaa oletustilasta. Jos ominaisuus katoaa ja palaa myöhemmin samalla nimellä, se saa vanhan asetuksensa takaisin.
• Resurssit ja kehotteet eivät näy listassa. MCP-palvelin voi tarjota muutakin kuin työkaluja: resursseja (sisältöä, jota assistentti voi lukea) ja kehotteita. Intric käyttää niitä, mutta ne eivät näy tällä sivulla. Ne toimivat automaattisesti, ellei palvelin merkitse niitä luvanvaraisiksi.
• Tila on sama kaikkialla. Mikään Space tai assistentti ei voi ohittaa ominaisuuden tilaa. Assistenttiin lisäät tai siitä poistat aina koko palvelimen, ja myös turvallisuusluokitus koskee koko palvelinta eikä yksittäisiä ominaisuuksia.

Ominaisuuksien päivittäminen

Päivitä ominaisuudet pyytää palvelimelta sen nykyisen listan ja korvaa sillä Intriciin tallennetun listan. Intric päivittää listan myös itse, kun tallennat palvelimelle uuden URL-osoitteen tai yhdistät OAuth-tilin. Painike ei ole käytettävissä kolmessa tilanteessa:

• palvelin on pois päältä
• palvelimen paneelissa on tallentamattomia yhteysmuutoksia
• palvelin käyttää OAuthia, etkä ole yhdistänyt tiliäsi

Miten asetukset näkyvät audit-lokissa

Audit-loki näyttää jokaisen merkinnän sen teknisellä tapahtumanimellä, esimerkiksi TOOL_UPDATE. Avaa merkintä, niin näet sen kaikki tiedot. Samat tiedot ovat mukana myös CSV-viennissä.

Asetusten muuttaminen

Kun tallennat muutokset Ominaisuudet-sivulla, lokiin tulee yksi merkintä TOOL_UPDATE. Sama tapahtuma syntyy, kun muutat, onko palvelin organisaatiosi käytettävissä, tai kun muutat palvelimen turvallisuusluokitusta.

• Toimija: admin, joka tallensi muutokset.
• Resurssi: tyyppi MCPTool. Resurssin nimi on aina mcp eikä palvelimen nimi, joten erota palvelimet toisistaan resurssin tunnuksen avulla.
• Tiedot: muuttuneen kohdan vanha ja uusi arvo. Ominaisuuden asetus näyttää tältä:

"llm_tool_settings": { "items": { "search_documents": "auto_approve" } }

Kukin tila tallentuu lokiin näin:

Ominaisuudet-sivulla	Audit-lokissa
Pois	denied
Kysy	ask
Kysy + Käyttäjät voivat ottaa automaattisen hyväksynnän käyttöön	consent_allowed
Auto	auto_approve

Palvelimeen itseensä tehdyt muutokset kirjautuvat erikseen. Tapahtumissa MCP_SERVER_CREATE, MCP_SERVER_UPDATE ja MCP_SERVER_DELETE resurssina on palvelimen nimi. MCP_SERVER_UPDATE kertoo, mitkä kentät muuttuivat, mutta ei niiden uusia arvoja. Muuttunut kenttä voi olla esimerkiksi URL-osoite tai API-avaimen tai asiakassalaisuuden kohdalla credentials.

Ominaisuuksien suorittaminen

Tila ratkaisee, mitä lokiin kirjautuu aina, kun assistentti käyttää ominaisuutta:

Tila	Mitä käyttäjä teki	Lokimerkintä
Pois	—	Ei mitään. Ominaisuutta ei voi suorittaa.
Kysy	Klikkasi Hyväksy	TOOL_USE_APPROVE
Kysy	Klikkasi Hylkää tai lähetti uuden viestin vastaamatta	TOOL_USE_REJECT
Kysy + käyttäjät voivat ottaa automaattisen hyväksynnän käyttöön	Valitsi Salli aina tälle avustajalle tai Salli aina kaikkialla	TOOL_AUTO_APPROVE_CONSENT_GRANT ja TOOL_USE_APPROVE
Kysy + käyttäjät voivat ottaa automaattisen hyväksynnän käyttöön	Ei mitään: aiemmin annettu “salli aina” kattoi suorituksen	TOOL_USE_AUTO_APPROVE
Auto	Ei mitään. Ominaisuus toimi kysymättä.	Ei mitään

Hyväksyntä-, hylkäys- ja automaattisen hyväksynnän merkinnät liittyvät keskusteluun. Niihin tallentuu ominaisuuden nimi ja tarkalleen se, mitä assistentti lähetti ominaisuudelle. Palvelimen nimi ja työkalun palauttama vastaus eivät tallennu. TOOL_AUTO_APPROVE_CONSENT_GRANT kertoo, onko hyväksyntä voimassa yhdelle assistentille vai kaikkialla, ja mistä assistentista on kyse.

Huom.: TOOL_USE_AUTO_APPROVE ja TOOL_AUTO_APPROVE_CONSENT_GRANT näkyvät lokissa, mutta tapahtumasuodattimessa niitä ei vielä ole. Löydät ne suodattamalla käyttäjän tai aikavälin mukaan tai hakemalla CSV-viennistä.

Mitä lokiin ei tallennu

• Tilassa Auto olevien ominaisuuksien suoritukset sekä automaattisesti toimivien resurssien ja kehotteiden suoritukset.
• Hyväksynnät ja hylkäykset suunnitelmien suorituksissa. Siellä annettu “salli aina” tallentuu lokiin kuitenkin.
• Päivitä ominaisuudet, käynnistitpä sen itse tai käynnistyikö se automaattisesti.
• OAuth-tilin yhdistäminen ja yhteyden katkaiseminen sekä yhteystarkistukset.
• Työkalun palauttama vastaus.

Jos tarvitset merkinnän ominaisuuden jokaisesta suorituksesta, valitse Kysy, älä Auto. Myös tila Kysy yhdessä valinnan Käyttäjät voivat ottaa automaattisen hyväksynnän käyttöön kanssa kirjaa jokaisen suorituksen. Kun käyttäjä on kerran valinnut “salli aina”, hänen suorituksensa kirjautuvat kuitenkin tapahtumana TOOL_USE_AUTO_APPROVE eivätkä hyväksyntänä.