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

# MCP

> Yhdistä Claude Desktop tai muu MCP-asiakasohjelma Flowgladiin, löydä organisaatiosi URL-osoite, ota malleja käyttöön ja ratkaise yleiset yhteysongelmat.

Yhdistä MCP-yhteensopiva agentti Flowgladiin, jotta voit työskennellä organisaatiosi liiketoimintatiedon ja operatiivisen kontekstin parissa.

Liitin voi löytää ja muokata Pageja, lukea tiedostoja ja yhdistettyjä tietueita, luoda Taskeja, hallita uudelleenkäytettäviä Skillejä sekä luoda tai ajaa Automaatioita. Käytettävissä olevat työkalut riippuvat yhdistetystä identiteetistä, myönnetyistä oikeuksista ja käyttöön otetuista tuoteominaisuuksista.

## Mallin käyttöönotto

Kun `templates.apply` on saatavilla `tools/list`-luettelossa, anna julkaistu `templateId` ja olemassa oleva `spaceId`, niin kaikki mallin resurssit luodaan. Applicationit, Automaatiot ja tavalliset File-kopiot kuuluvat kyseiseen Spaceen; Skillit kuuluvat organisaatiolle. Tiedostot käyttävät määritettyjä tiedostonimiään Spacen juuressa eivätkä koskaan korvaa olemassa olevia tiedostoja. Samannimisyysristiriita saa kyseisen komponentin epäonnistumaan, mutta toisistaan riippumattomat komponentit voivat jatkaa. Tiedoston valmistuminen tarkoittaa, että tavut ja metatiedot on tallennettu pysyvästi; se ei odota indeksointia.

Voit valinnaisesti antaa `connections`-arvon `{ connector, connectionId }`-objektien taulukkona, enintään yksi yhteys palveluntarjoajaa kohden. Annettujen yhteyksien on oltava käytettävissä, yhteensopivia ja tarvittaessa jo määritetty Spacelle. Pois jätetyt yhteydet jättävät resurssit odottamaan määritystä. Vastaus suosittelee soveltuvia yhteyksiä tai uuden yhteyden luomista, jos yhtään ei ole saatavilla.

Luonti suoritetaan yhdessä Trigger.dev-tehtävässä riippuvuusjärjestyksessä, ja komponenttien tulokset tallennetaan tehtävän metatietoihin ja tulosteeseen. Koko tehtävän automaattiset uudelleenyritykset on poistettu käytöstä; epäonnistunut tai keskeytynyt tehtävä voi jättää jälkeensä osittain luotuja resursseja. Vastaus kuittaa, että luonti on lisätty jonoon, ja sisältää suunnitellut komponentit ja yhteyssuositukset; se ei vahvista, että resurssien luonti on valmis. Käytä resurssien list/get-työkaluja niiden löytämiseen ja tarkasteluun. Onnistuneesti luodut resurssit säilyvät, vaikka jokin toinen komponentti epäonnistuisi.

Mallin käyttöönotto lykkää suoritettavuuden tarkistusta eikä aktivoi tai aja sen resursseja. Jokainen apply-kutsu luo uudet kopiot, myös uudelleenyrityksissä. Käytä resurssityökaluja tarkastellaksesi, mitä luotiin.

## Ennen yhdistämistä

Tarvitset:

* Flowglad-tilin, jolla on pääsy käytettävään organisaatioon.
* Organisaatiosi tuotannon MCP-URL-osoitteen.
* Agentin tai asiakasohjelman, joka tukee etä-MCP-palvelinta Streamable HTTP:n ja OAuthin kautta.
* Aiottuun työhön tarvittavat organisaatio- ja Space-oikeudet.
* Mahdolliset lähde-Connectionit tai tiedostot, jotka ovat jo asianomaisen Spacen käytettävissä.

[Flowgladin etusivun](https://www.flowglad.com/) julkaistu hinnoitteluosio sisältää MCP:n Free-, Plus- ja Max-tasoilla. Organisaatio- ja Space-oikeudet, OAuth-valtuutus ja yhdistettyjen lähteiden käyttöoikeudet ovat silti voimassa.

Yhteydet ulkoisiin liiketoimintajärjestelmiin on määritettävä Flowgladissa ja tuotava aiotun Spacen käyttöön, ennen kuin agentti voi käyttää niitä. Katso [Connectors](/docs/fi/connectors.md) ja [Spaces](/docs/fi/spaces.md).

## Organisaatiosi URL-osoitteen löytäminen

Tuotannon liitin käyttää organisaatiokohtaista URL-osoitetta:

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

Korvaa `{orgId}` todellisella Flowglad-organisaatiotunnuksellasi. Säilytä koko tunnus, mukaan lukien sen `org_`-etuliite. Älä syötä aaltosulkeita tai keksittyä organisaatiotunnusta.

Avaa Flowgladissa **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website**. Kopioi siellä näytetty organisaation MCP-URL. Käytä **Website**-ohjeita etä-URL-osoitteelle; erillinen **Desktop app** -välilehti sisältää komentorivipohjaiset asennusohjeet.

Jos et pääse näihin asetuksiin, kysy Flowglad-järjestelmänvalvojaltasi tai [tuelta](mailto:support@flowglad.com).

Käytä tälle liittimelle organisaation URL-osoitetta. Yhteyskohtainen URL voi paljastaa suppeamman työkalujoukon, eikä se ole vaihdettavissa tässä kuvattuun organisaation URL-osoitteeseen.

## Yhdistäminen Claude Desktopista

Katso [Claude Desktopin asennusvideo](https://youtu.be/6qqSnrqDJ2o) tai noudata alla olevia vaiheita.

[Flowgladin yhdistäminen Claude Desktopiin](https://www.youtube.com/embed/6qqSnrqDJ2o)

Käytä Claude Desktopin mukautetun liittimen työnkulkua Flowgladin lisäämiseen ja tilisi käyttöoikeuden valtuuttamiseen.

**1. Avaa mukautetun liittimen lomake.**

Siirry Claude Desktopissa kohtaan **Customize** → **Connectors** → **+ Add** → **Add Custom Connector**.

**2. Lisää Flowglad-liitin.**

Syötä liittimen nimeksi **Flowglad** tai valitse jokin muu nimi.

Liitä koko organisaatiosi MCP-URL URL-kenttään. Voit kopioida sen kohdasta [Settings > MCP](https://dashboard.flowglad.com/settings/mcp). Sen pitäisi näyttää tältä: `https://dashboard.flowglad.com/api/mcp/orgs/org_...`

Älä muuta muita liittimen asetuksia. Jatka valitsemalla **Add**. Joissakin Claude Desktopin versioissa tämän painikkeen nimi voi olla **Continue**.

**3. Myönnä Claudelle pääsy Flowgladiin.**

Jatka yhdistämisen työnkulkua valtuuttaaksesi Clauden käyttämään Flowglad-tiliäsi. Kirjaudu pyydettäessä sisään, vahvista aiottu Flowglad-organisaatio ja tarkista pyydetyt käyttöoikeudet ennen valtuuttamista.

Kun työnkulku on valmis, palaa Claude Desktopiin ja varmista, että Flowglad-yhteys on käytettävissä. Pyydä Claudea tarkistamaan Flowglad-yhteys ja listaamaan Spacet, joihin sinulla on pääsy.

OAuth Dynamic Client Registration on tarkoitettu yhdistämistapa. Älä lisää salasanaa, käyttötunnusta, API-avainta tai client secretiä palvelimen URL-osoitteeseen.

Nämä ohjeet kuvaavat Flowgladin yhdistämistä suoraan mukautettuna liittimenä; saatavuus hakemistossa on erillinen asia.

## Toisen MCP-asiakasohjelman yhdistäminen

Lisää sama organisaation URL etä-Streamable HTTP -MCP-palvelimeksi. Suorita asiakasohjelman OAuth-työnkulku Flowglad-tililläsi ja varmista sitten organisaatio ja käytettävissä olevat työkalut.

Asiakasohjelmien tuki vaihtelee. Onnistunut palvelinyhteys ei tarkoita, että asiakasohjelma tuo Flowglad Skillit automaattisesti. Skill discovery -laajennus ja `skills.list`-työkalu ovat eri rajapintoja. Katso [Skills](/docs/fi/skills.md) tuetusta löytämisestä ja pakettienhallinnan toiminnasta.

## Tietojen käsittely

Flowglad MCP:n käyttöä säätelee [Flowgladin tietosuojakäytäntö](https://www.flowglad.com/privacy-policy). Organisaation järjestelmänvalvojat näkevät kaikki organisaatioon tehdyt MCP-työkalukutsut kohdassa [Settings > Audit](https://dashboard.flowglad.com/settings/audit).

## Vianmääritys

| Oire | Seuraava vaihe |
| - | - |
| Yhteys epäonnistuu ennen kirjautumista | Tarkista koko HTTPS-URL ja organisaatiotunnus. Varmista, että asiakasohjelma tukee etä-MCP:tä OAuthilla. |
| Kirjautuminen onnistuu, mutta työ ei ole käytettävissä | Tarkista valittu organisaatio, Space-jäsenyys, MCP-valtuutus ja Spacen käytettävissä olevat Connectionit. |
| Kirjoitustyökalu ei ole käytettävissä tai se estetään | Varmista vaaditut organisaatio- ja Space-oikeudet. Yhdistä uudelleen, jos tarvitaan äskettäin myönnetty OAuth-scope. |
| Yhdistettyä palveluntarjoajaa ei voi lukea | Varmista, että sen valtuutus on aktiivinen ja Connection on tuotu aiotun Spacen käyttöön. |
| Pagea tai tiedostoa ei löydy | Varmista oikea Space, sen suorat ja linkitetyt käyttöoikeudet sekä se, että lähde on edelleen saatavilla. |
| Toiminto palauttaa job- tai run-tunnuksen | Tarkista sen lopullinen elinkaari- tai ajotila ennen onnistumisesta raportoimista tai uudelleenyrittämistä. |
| Kirjoitus aikakatkaistaan | Tarkista, valmistuiko se, ennen uudelleenyrittämistä. Jotkin toiminnot luovat uuden tietueen tai lisäävät työtä jonoon jokaisella kutsulla. |
| Käyttöoikeus vanhenee tai se perutaan | Yhdistä uudelleen OAuthin kautta ja varmista aiottu organisaatio ja valtuutus. Jos uudelleenyhdistäminen epäonnistuu edelleen, ota yhteyttä tukeen. |

Yleisiä tietoturvatietoja varten katso [Security](/docs/fi/security.md) ja [Trust Center](https://trust.flowglad.com). Jos yhdistämisessä on ongelmia, [ota meihin yhteyttä](mailto:support@flowglad.com).

Kun otat yhteyttä tukeen, liitä mukaan aika, asiakasohjelma, kyseinen työkalu, turvallinen virhekoodi ja pyyntötunnus, jos saatavilla. Älä koskaan liitä mukaan salasanoja, bearer-tunnuksia, evästeitä, allekirjoitettuja lataus-URL-osoitteita tai asiakasdataa.


## Related topics

- [Skillit](/docs/fi/skills.md)
- [Tervetuloa](/docs/fi/agents/introduction.md)
- [Automaatiot](/docs/fi/automations.md)


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