# API-avaimet ja tekoälyavustajat (MCP)

Postbird on rakennettu siten, että tekoälyavustaja tai omat työkalusi voivat hoitaa julkaisemisen. Claude, ChatGPT, Claude Code, Cursor, n8n, Make tai omat skriptisi voivat suunnitella ja julkaista postauksia brändeillesi. Kaikki löytyy **API ja MCP** -välilehdeltä.

::: master-only
<figure><img src="../.gitbook/assets/v2-postbird-api.png" alt="API- ja MCP-sivu: Yhdistä tekoälyavustaja MCP-osoitteella, välilehdet asetuksille Claudea, ChatGPT:tä, Claude Codea, Cursoria ja n8n:ää, Makea varten, skriptejä numeroiduilla vaiheilla, ja sen alapuolella API-avainten osio"><figcaption><p>API ja MCP: osoite tekoälyavustajille, vaiheittaiset asetukset avustajakohtaisesti sekä API-avaimesi.</p></figcaption></figure>
:::

## Yhdistä tekoälyavustaja

MCP on tapa, jolla tekoälyavustajat kytkeytyvät työkaluihin. Osoite on:

```
https://mcp.postbird.ai/mcp
```

- **Claude** (verkko tai työpöytäversio): Asetukset, Liittimet (Connectors), **Lisää mukautettu liitin** (Add custom connector), nimeä se Postbirdiksi ja liitä osoite. Napsauta **Lisää**, sitten **Yhdistä** ja hyväksy kirjautuminen.
- **ChatGPT**: Asetukset, Liittimet (tai Sovellukset), **Luo**, nimeä se Postbirdiksi, liitä osoite ja valitse OAuth kirjautumistavaksi. Tallenna, yhdistä ja hyväksy.
- **Claude Code** ja **Cursor**: liitä osoite ja API-avain (alla). Kunkin työkalun välilehti näyttää tarkat vaiheet.

Kun yhteys on muodostettu, avustaja voi listata brändisi ja kanavasi, luonnostella, ajastaa ja julkaista postauksia, lisätä kuvia linkin kautta, lukea kalenteria ja julkaisulokia sekä tuoda useita postauksia kerralla (tarkista ne ensin, tuo ne ja peru tuonti tarvittaessa). Pyydä sitä vain esimerkiksi: "ajasta postaus kevätmenustamme jokaiselle Sunrise Dentalin kanavalle perjantaille klo 10:00". Se voi myös ehdottaa hashtageja verkostoittain, säilyttää tallennetut hashtag-ryhmäsi, luoda tekoälyllä kuvia brändin mediaksi sekä lukea ja vastata postauksiesi kommentteihin [Saapuneet](inbox.md)-kansiossa: vastaa, tykkää, piilota tai poista, jos verkosto sen sallii, merkitse keskustelut tehdyiksi ja ehdota vastausta. Avustajan kautta pyydetyt tekoälyluonnokset, hashtag-ehdotukset, tekoälykuvat ja vastausehdotukset maksavat saman verran kuin sovelluksessa ([Kirjoita tekoälyllä ja hashtageilla](ai-drafts.md)).

## API-avaimet

Avaimen avulla työkalu voi toimia puolestasi brändiesi parissa ilman salasanaasi.

1. Anna **API-avaimet**-kohdassa avaimelle nimi (esimerkiksi "Claude Code kannettavallani").
2. Valitse **Vain luku** (Read only), jos työkalun tulisi vain tarkastella brändejä, kanavia, postauksia ja kalenteria ilman, että se luo, muuttaa tai julkaisee mitään.
3. Napsauta **Luo avain** ja kopioi se heti. Avaimet alkavat merkeillä `pb_live_`. Turvallisuussyistä se näytetään vain kerran; jos kadotat sen, peruuta se ja luo uusi.

Luo yksi avain per työkalu, jotta voit myöhemmin kytkeä yksittäisen työkalun pois päältä **Peruuta**-toiminnolla. Kuka tahansa, jolla on avain, voi julkaista brändiesi puolesta, joten käsittele sitä kuin salasanaa.

Tiimin jäsenen luoma avain toimii kyseisen jäsenen roolilla ja brändeillä, ja se seuraa heitä, jos heidän roolinsa muuttuu tai he lähtevät tiimistä. Vain sinä ja ylläpitäjät voitte luoda avaimia. Katso [Tiimin roolit](team-roles.md).

## Tavalliset verkkopyynnöt (n8n, Make, skriptit)

Jokainen avustajan toiminto on myös tavallinen verkkopyyntö. Lähetä avaimesi `X-API-Key`-otsakkeessa. n8n-, Make- ja skriptivälilehden **API-kuvaus**-linkki on standardikuvaus jokaisesta pyynnöstä, jonka n8n ja Make voivat tuoda suoraan.