---
title: "Rakenna Claude Coden, Codexin tai Cursorin avulla"
description: "Asenna ThunderPhone Agent Skills, yhdistä ThunderPhone MCP -palvelimeen ja anna koodausagentille ajantasainen tuotedokumentaatio."
---

ThunderPhone tarjoaa koodausagenteille kolme tasoa:

| Taso | Mitä se antaa agentille |
| --- | --- |
| [Agenttitaidot](https://github.com/thunderphone/skills) | Kohdennetut menettelyt agentteihin, kehotteisiin, numeroihin, puheluihin, työkaluihin, webhookeihin, tietämykseen, testaukseen, kampanjoihin, widgetteihin, reaaliaikaisiin kehyksiin ja migraatioihin. |
| MCP | Todennetut työkalut kattavat agentit, numerot, puhelut, testauksen, tietämyksen, työkalut/webhookit, kampanjat, äänet, tuonnit ja dokumentaation niiden tullessa saataville; hae ajantasainen luettelo kutsumalla `tools/list`. |
| [Raakadokumentaatio](https://thunderphone.com/docs/llms.txt) | Ajantasaiset Markdown-lähteet tuotteen toiminnasta ja API-yksityiskohdista. |

Taidot kertovat, miten työ tehdään. MCP antaa koodausagentin tarkastella organisaatiotasi ja toimia siinä. Raakadokumentaatio tarjoaa lähdemateriaalin kysymyksiin, jotka eivät kuulu ladattuun taitoon.

## Asenna projektiin

Tämä lohko asentaa taidot, tuo avaimen nykyisen komentotulkin käyttöön ja lisää projektikohtaisen MCP-palvelimen Claude Codeen. Korvaa paikkamerkki lukemalla todellinen arvo salaisuuksien hallinnasta; älä liitä avainta tietovarastoon tai chattiin.

```bash
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
  --header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
  thunderphone https://api.thunderphone.com/v1/mcp
```

Codexissa korvaa viimeinen komento seuraavalla:

```bash
codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY
```

Cursor lukee projektin määrityksen tiedostosta `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

VS Code käyttää samaa palvelinta `servers`-avaimen alla tiedostossa `.vscode/mcp.json`:

```json
{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

<Warning>
  Organisaation API-avain voi lukea organisaation tietoja ja suorittaa käytössä
  olevia toimintoja. Säilytä se salaisuuksien hallinnassa, rajaa käyttö
  tarkoitettuun projektiin ja tarkista tietoja muuttavat työkalukutsut ennen
  hyväksyntää.
</Warning>

## Esimerkki-istunto: kaksikielinen hammashoitolan vastaanottoagentti

1. Pyydä koodausagenttia lataamaan `create-agent`,
   `thunderphone-prompt-builder`, `build-tool-integration`, `add-knowledge` ja
   `test-agent`. Kerro sille, että sen tulee suunnitella ensin eikä vielä luoda resursseja.
2. Anna sille varmennetut tiedot vastaanotosta, tuetut tehtävät, eskalointisäännöt ja
   kaksi vaadittua kielialuetta. Pyydä sitä tarkistamaan aktiivinen puheluääniluettelo ja tuetut
   kielet sen sijaan, että se keksisi äänen tai kielialueen.
3. Pyydä yhtä tuotantokehotetta, joka perustuu yleisiin periaatteisiin ja faktoihin. Agentin
   tulee vaihtaa soittajan tuettuun kieleen, pitää puhe tiiviinä,
   esittää yksi kysymys kerrallaan ja välttää soittajan vastausskriptejä.
4. Pyydä sitä määrittämään rajattu ajanvaraustyökalu ja liittämään vain vastaanottoagentin
   tarvitsemat tiedot. Testaa työkalun onnistuminen, vapaita aikoja ei ole -tilanne, virheellinen syöte,
   aikakatkaisu ja siirto ihmiselle ennen käyttöönottoa.
5. Luo skenaarioita molemmille kielille, keskeytyksille, korjauksille, puuttuville
   tiedoille, tietokysymyksille, ajanvarauksen epäonnistumisille ja eskaloinnille. Suorita
   ne, tarkista litteroinnit ja työkalun todisteet, korjaa pienin yleinen sääntö
   ja suorita sama joukko uudelleen.
6. Tarkista tarkka luonnos ja testitulokset ja valtuuta sitten erikseen käyttöönotto
   ja numeron liittäminen. Soita hallittu audiopuhelu kummallakin kielellä ennen
   kuin siirrät oikean liikenteen palveluun.

Käytä [Python- tai TypeScript SDK:ta](/api-reference/sdks) tyypitettyihin REST-pyyntöihin.

Käytä RESTiä MCP:n sijaan, kun toteutus tarvitsee deterministisiä kuormia, versioituja
testiaineistoja, joukkokoordinointia tai toimintoa, jota ei ole nykyisessä MCP:n
työkaluluettelossa. API alkaa osoitteesta `https://api.thunderphone.com/v1`; katso
[API-johdanto](/api-reference/introduction) ja
[MCP-opas](/fi/guides/thunderphone-mcp-server).