# Tekoälyagenttien ja MCP:n dokumentaatio | MerchandAise

- slug: developers-ai-agents-mcp
- locale: fi
- localeResolved: fi
- canonical: https://www.merchandaise.com/fi/developers/ai-agents-mcp

Tutustu MerchandAisen MCP-ohjeisiin, palvelimen löytämiseen ja tekoälyagenttien suunnittelu- ja tarjousopastustyökaluihin työtilan oikeuksilla ja käyttäjän hyväksynnöillä.

## Ymmärrä, mitä avustaja voi tehdä
Tuetuissa istunnoissa käyttäjä voi kuvailla idean, nähdä tuotteen vuorovaikutteisena 3D:nä ja pyytää muutoksia. Avustaja käyttää samoja tuotetietoja ja suunnitelman tilaa kuin MerchandAisen työnkulku. Ajantasaiset työkalut määrittävät, mitä se voi lukea tai muuttaa.
Palvelinkortti ja ulkoisten työkalujen tiedot ovat julkisia löytämistä varten. Jokainen työkalukutsu noudattaa silti ilmoitettuja turvallisuus- ja työtilarajoja. Ostajan, vedoksen ja tuotannon hyväksynnät pysyvät näkyvinä ja niiden vastuuhenkilö on tunnistettavissa.

## Löydä palvelin. Pyydä sitten oikea käyttöoikeus.
- **Tekoälyagentit ja MCP:** Yhdistä tekoälyavustaja Model Context Protocolin kautta. Löydä tuetut työkalut ja säilytä käyttäjän suunnitteluvalinnat, käyttöoikeudet ja vaaditut vahvistukset. Toteutusopas: Lue MCP-toteutusopas (/fi/developers/ai-agents-mcp#implementation-checklist). Koneluettava määritys: Julkinen MCP-palvelinkortti JSON (/.well-known/mcp/server-card). Käyttöoikeus: Julkinen. Julkinen löytämisasiakirja koneasiakkaille. Ulkoinen työkaluluettelo osoitteessa /api/v1/mcp/tools näyttää ajantasaiset työkalutiedot. Jokainen työkalukutsu noudattaa silti ilmoitettuja turvallisuus-, työtila- ja vahvistusrajoja. Ensisijainen sivu: /fi/developers/ai-agents-mcp. Ensisijainen osio: /fi/developers/ai-agents-mcp#mcp-tools.
- **API-dokumentaatio ja OpenAPI:** Etsi avustajien työkalujen ja suunnitteluistuntojen API-viite. Valitse sitten työnkulkuusi sopiva yhteisö-, toimittaja- tai yritysmääritys. Toteutusopas: Tutustu API-ohjeisiin (/fi/developers/api-integrations). Koneluettava määritys: Avustajatyökalujen OpenAPI JSON (/api/docs/openapi.json). Käyttöoikeus: Julkinen. Julkinen viite avustajien ja työkalujen rajapinnoille. Tuotantokäyttö ja tilauksiin vaikuttavat toiminnot edellyttävät yhä soveltuvaa valtuutusta. Ensisijainen sivu: /fi/developers/ai-agents-mcp. Ensisijainen osio: /fi/developers/ai-agents-mcp#api-docs.

## Palvelimen löytämisestä ensimmäiseen työnkulkuun
- **Vaihe 1: Löydä turvallisesti:** Tunnista MerchandAise ja sen ajantasaiset ulkoiset työkalut julkisen MCP-palvelinkortin ja työkaluluettelon avulla. Löytäminen ei yksin anna laajaa oikeutta laatia tarjouksia, muuttaa tilaa tai tilata.
- **Vaihe 2: Myönnä vain tarvittavat oikeudet:** Valtuuta vain avustajan tarvitsemat työkalut, työtila ja ympäristö. Erota vain lukuun perustuva tutkiminen toiminnoista, jotka muuttavat suunnitelman, tarjouksen, hyväksynnän tai tilauksen tilaa.
- **Vaihe 3: Vahvista ennen seurauksia:** Säilytä arkaluonteisten toimintojen nimenomainen ihmisen vahvistus, testaa vanhentunutta tilaa ja kieltäytymistä koskeva toiminta ja todenna palautuspolut ennen tuotantoliikenteen sallimista.

## Mitä agentin on säilytettävä
- **Yksi versioitu tuotteen tila:** Avustaja käyttää samaa suunnitelman, ostoaikomuksen, toimittajan vahvistaman tarjouksen, hyväksynnän ja tilauksen tilaa kuin muutkin MerchandAisen rajapinnat.
- **Kaupallisten ja toimittajatietojen yksityisyys:** Kun MerchandAise käsittelee ostajan maksutapahtuman, Hutter Products GmbH toimii sopimuksen myyjänä ja maksutapahtuman vastuullisena myyjänä (Merchant of Record) MerchandAise-brändin alla. Toimittajan yksityistä henkilöllisyyttä, yhteystietoja ja sisäisiä tietoja ei paljasteta agentille.
- **Vedoshyväksyntä säilyy ihmisellä:** 3D-näkymä ei ole fyysistä näyttöä. Vahvistettu tarjous kertoo mahdollisista asiakasnäytteistä, niiden kustannuksista, rajoituksista ja aikataulusta. Hyväksy täsmällinen digitaalinen vedos ja suorita pakolliset tekniset tarkistukset sekä vaadittu tai valittu näytteen hyväksyntä ennen massatuotantoa. Hyväksyttyjen tilausten nykyiset vaatimukset pysyvät sitovina.

## Ennen agentin tuotantokäyttöä
Löydettävissä oleva MCP-palvelin on vasta alku. Tuotantovalmius tarkoittaa rajattua avustajan roolia, vastuuhenkilöä jokaiselle seurauksia aiheuttavalle toiminnolle ja virheistä palautumista käyttäjälle turvalliseen tilaan.
- **Kartoita oikeudet seurausten mukaan:** Luokittele jokainen työkalu vain lukuun tarkoitetuksi, neuvovaksi, tilaa muuttavaksi, toimittajatietojen kannalta arkaluonteiseksi tai tilaukseen vaikuttavaksi ennen sen myöntämistä avustajalle.
- **Nimeä jokaisen vahvistuksen vastuuhenkilö:** Määritä, kuka vahvistaa tuotemuutokset, tarjoukset, digitaaliset vedokset, tuotantonäytteet ja tilaukset sekä mitä avustaja tekee, jos kyseinen henkilö ei ole käytettävissä.
- **Seuraa, kieltäydy ja palaudu:** Testaa virheelliset syötteet, vanhentunut tila, puuttuvat oikeudet, kieltäytymiset, uudelleenyritykset, telemetria ja palautuspolut ennen kuin tuotantoliikenne saavuttaa työnkulun.

## Usein kysyttyä
- **Mikä MCP on ja onko tämä julkinen ChatGPT-sovellus?:** MCP tarkoittaa Model Context Protocolia: tapaa, jolla avustaja löytää ja käyttää työkaluja. Nämä asiakirjat kuvaavat MerchandAisen integraatiomahdollisuuksia. Julkinen palvelinkortti ei vahvista saatavuutta ChatGPT:n sovelluskaupassa. ChatGPT-työtilan käyttö riippuu tilistäsi, sovelluksen asetuksista ja tuetusta ympäristöstä.
- **Mitä tekoälyagentti voi tehdä MerchandAisessa?:** Valtuutettu avustaja voi käyttää työtilalleen ja ympäristölleen hyväksyttyjä työkaluja, kuten tuotteiden löytämistä, suunnittelu- tai tarjousopastusta ja muita nimenomaisesti sallittuja toimintoja. Käytettävissä olevat työkalut ja niiden oikeudet määritetään integraation arvioinnissa.
- **Voiko tekoälyagentti tehdä tilauksia automaattisesti?:** Ei pelkän palvelimen löytämisen tai työkalujen luetteloinnin perusteella. Kaiken tilaukseen vaikuttavan työnkulun on säilytettävä tunnistautuminen, ostajan ja työtilan vahvistukset, ajantasainen hinnoittelu, digitaalisen vedoksen hyväksyntä sekä toimittajan vahvistama valmistettavuus, pakolliset tekniset tarkistukset ja tilaukselle sovittu täsmällinen asiakasnäytevalinta hyväksyntävaatimuksineen. Jo hyväksytyn tilauksen vaatimuksia ei voi hiljaisesti poistaa.
- **Onko MerchandAisen MCP-integraatio julkinen?:** MCP-palvelinkortti ja ulkoisten työkalujen ajantasaiset tiedot ovat julkisia koneellista löytämistä varten. Yksittäiset työkalukutsut noudattavat ilmoitettua turvallisuusmallia. Suojatut työtila-, toimittaja-, yritys-, tarjous- ja tilaustoiminnot säilyttävät vaaditut valtuutukset ja vahvistukset.

## Onko mielessäsi agentin työnkulku?
Kerro, ketä avustaja palvelee, mitä sen tulisi saada tehdä ja missä ihmisen on säilytettävä päätösvalta. Kartoitamme sopivat MCP-, API- ja hyväksyntärajat.
- **Arvioi agentin työnkulku:** /fi/contact?intent=agent-mcp-review
- **Tutustu API-määrityksiin:** /fi/developers/api-integrations
