> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sovelluksesi MCP-palvelimena

> Anna Clauden, ChatGPT:n ja muiden tekoälyavustajien käyttää sovelluksesi tietoja

Jokaisella Macalyssa rakentamallasi projektilla voi olla oma [MCP](https://modelcontextprotocol.io)-palvelin. Silloin muut tekoälyavustajat voivat käyttää sovellustasi. Claudea tai ChatGPT:tä käyttävä ihminen voi sanoa esimerkiksi "lisää varaus perjantaille kello 10" tai "montako tilausta tällä viikolla tuli", ja avustaja hoitaa asian sovelluksesi kautta.

Sinä päätät, mitkä sovelluksen osat tarjoat käyttöön. Määrität sen [keskustelusi](/docs/fi/chat/overview) **MCP**-välilehdellä, josta löytyvät myös yhteystiedot.

<Callout icon="user">
  Käytettävissä kaikissa paketeissa
</Callout>

## Palvelimen luominen

Avaa **MCP**-välilehti ja napsauta **Luo MCP tälle sovellukselle**. Agentti selvittää, mitä sovelluksesi tekee, ja ehdottaa joukon työkaluja, esimerkiksi yhden kohteiden listaamiseen, yhden niiden luomiseen ja yhden niiden muokkaamiseen. Jos haluat erilaisia työkaluja, kerro agentille keskustelussa. Sen jälkeen agentti rakentaa työkalut sovelluksesi taustajärjestelmään.

Voit myös pyytää suoraan keskustelussa: "Muuta sovellukseni MCP-palvelimeksi, jotta Claude voi hallita varastoa." Myöhemmin **Lisää tai muuta työkaluja** MCP-välilehdellä vie sinut takaisin agentin luo säätämään, mitä on tarjolla.

Kun palvelin on olemassa, välilehdellä näkyvät sen **Palvelimen URL** ja tapa, jolla se todentaa käyttäjän:

* **Vaatii kirjautumisen**: Avustajat kirjautuvat sovelluksesi oman kirjautumisen kautta, joten jokainen pääsee käsiksi vain omiin tietoihinsa. Tätä tapaa Claude ja ChatGPT edellyttävät.
* **Käyttöoikeustunnus**: Yksi salainen avain. Sopii skripteihin ja Claude Codeen, mutta Claude- ja ChatGPT-sovellukset eivät voi käyttää sitä. Jos palvelimesi hyväksyy vain tunnuksen, napsauta **Lisää kirjautuminen**, niin agentti lisää sovellukseesi kirjautumisen.

<Note>
  Avustajat kirjautuvat julkaistun sovelluksesi kautta, joten projekti täytyy ensin julkaista. Jos keskustelu käyttää Testi-tietokantaa, Claude ja ChatGPT kirjautuvat silti Tuotanto-tietokantaan. Kun testiversio on valmis, valitse Tietokanta-välilehdellä Tuotanto. Katso [Tuotantotietokanta ja testitietokanta](/docs/fi/features/databases#tuotantotietokanta-ja-testitietokanta).
</Note>

## Avustajan yhdistäminen

**Yhdistä**-osiossa on vaiheittaiset ohjeet jokaiselle asiakasohjelmalle. Yhdistäminen tarvitsee tehdä vain kerran.

<Tabs>
  <Tab title="Claude">
    1. Avaa Claudessa **Settings → Connectors** ja napsauta **Add custom connector**.
    2. Anna liittimelle nimi ja liitä palvelimesi URL kenttään **Remote MCP server URL**.
    3. Napsauta **Connect**. Claude avaa sovelluksesi kirjautumissivun. Kirjaudu sisään ja hyväksy käyttöoikeus.
  </Tab>

  <Tab title="ChatGPT">
    1. Avaa ChatGPT:ssä **Settings → Apps & Connectors → Advanced settings** ja ota käyttöön **Developer mode**.
    2. Napsauta **Apps & Connectors** -kohdassa **Create**, anna nimi ja liitä palvelimesi URL. Pidä todennuksena **OAuth**.
    3. Kirjaudu sovellustililläsi ja hyväksy käyttöoikeus. Valitse keskustelussa sovelluksesi **+**-valikosta.
  </Tab>

  <Tab title="Claude Code">
    Kopioi MCP-välilehdellä näkyvä komento ja suorita se terminaalissa. Komento sisältää käyttöoikeustunnuksesi, joten älä jaa sitä kenenkään kanssa. Kirjoita sitten Claude Codessa `/mcp` ja viimeistele kirjautuminen selaimessa.
  </Tab>
</Tabs>

Mukautetut liittimet vaativat maksullisen Claude- tai ChatGPT-tilauksen, ja ne lisätään selain- tai työpöytäsovelluksesta, ei puhelinsovelluksesta.

## Mitä yhdistetyt avustajat voivat tehdä

Välilehden alareunan **Työkalut**-luettelo näyttää kaikki palvelimesi tarjoamat työkalut ja kunkin lyhyen kuvauksen. **Vain luku** -merkillä varustetut työkalut voivat vain katsella tietoja. **Voi poistaa tietoja** -merkillä varustetut työkalut voivat poistaa tietoja, joten ole huolellinen niiden oikeuksia määrittäessäsi.

Jos välilehti ilmoittaa, ettei palvelin vastaa, se voi olla vielä käyttöönotossa. Yritä hetken kuluttua uudelleen tai napsauta **Pyydä Macalya korjaamaan**, niin agentti tutkii asiaa.

## Käyttöesimerkkejä

* Varaussovellus, jossa asiakkaat pyytävät avustajaansa etsimään vapaan ajan ja varaamaan sen.
* Sisäinen CRM, jossa myyntitiimi kysyy ChatGPT:ltä asiakkaan historian ennen puhelua.
* Varastosovellus, jossa Claude tarkistaa varastosaldot ja kirjaa toimitukset.

Palvelin toimii sovelluksesi [API-verkkotunnuksessa](/docs/fi/features/domains#api-verkkotunnus-sovelluksesi-taustajärjestelmälle), joten sen osoite pysyy samana, vaikka nimeäisit sivuston uudelleen tai siirtäisit sen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.