# Onko ihmiselläsi nälkä?

> Kun Calori on yhdistetty, näet hänen ravintotavoitteensa, mitä hän on syönyt ja mitä on suunniteltu, ja voit tilata ateriat, jotka Calori valmistaa ja toimittaa Helsingissä ja Tukholmassa.

## Calorin MCP-palvelin

`https://mcp.calori.health/mcp`

Streamable HTTP · OAuth 2.1 -kirjautuminen sähköpostikoodilla

## Esimerkkejä

### Minulla on nälkä

- **Ihminen:** Minulla on nälkä. Mitä söisin?
- `get_days` → 600 kcal ja 35 g proteiinia jäljellä tänään; tänä iltana: Spicy Chicken & Sweet Potato, jääkaapissa
- **Agentti:** Sinulla on tänään jäljellä 600 kcal ja 35 g proteiinia. Illan Calori-ateria odottaa jo jääkaapissasi: Spicy Chicken & Sweet Potato, 550 kcal ja 32 g proteiinia.

### Korvapuusti

- **Ihminen:** Söin juuri korvapuustin.
- `find_food` → korvapuusti, 1 kpl (75 g): 280 kcal
- `log_food` → kirjattu välipalaksi
- **Agentti:** Kirjattu: 280 kcal. Sinulla on tänään vielä 820 kcal jäljellä, joten päivällinen mahtuu suunnitelmaan.

### Tilaa ensi viikko

- **Ihminen:** Tilaa ateriani ensi viikolle.
- `preview_week` → 6 ateriaa, 69 €, perillä sunnuntaina
- **Agentti:** Ensi viikolle 6 ateriaa hintaan 69 €, perillä sunnuntaina. Tilaanko?
- **Ihminen:** Kyllä, tilaa.
- `order_week` (käyttää rahaa) → tilattu
- **Agentti:** Valmista. Tilaus näkyy Calori-sovelluksessa.

### Poissa ensi viikolla

- **Ihminen:** Olen poissa ensi viikolla.
- `get_deliveries` → seuraava toimitus: sunnuntai
- `pause_weeks` → ensi viikko tauolla
- **Agentti:** Tauolla. Ensi viikolla mitään ei toimiteta eikä laskuteta, ja ateriat jatkuvat sitä seuraavalla viikolla.

## Calori lyhyesti

Calori asettaa päivittäiset tavoitteet energialle, proteiinille, hiilihydraateille ja rasvalle, pitää kirjaa syödystä ja suunnittelee kokkien valmistamat ateriat tavoitteiden mukaan. Seuranta toimii missä tahansa. Wolt toimittaa ateriat Helsingin ja Tukholman alueilla sunnuntaisin ja keskiviikkoisin, ja ne säilyvät jääkaapissa 4–5 päivää. Pääruoka maksaa 11,50 € ja välipala 5,50 €, vähintään kuusi ateriaa toimitusta kohden. Ensi viikon tilaukset lukkiutuvat keskiviikkona klo 15.00.

- Suomi: pääruoat 11,50 €, välipalat 5,50 €
- Ruotsi: pääruoat 129 kr, välipalat 59 kr

Seuraava tilausten määräaika: 2026-11-18 15:00 (Europe/Helsinki).

## Yhdistä Caloriin

Palvelin yhdistää sinut käyttäjän omaan Calori-tiliin, samaan kuin Calori-sovelluksessa (uudella sähköpostiosoitteella syntyy uusi tili). Hän kirjautuu sähköpostikoodilla, hyväksyy sen, mitä saat tehdä, ja voi katkaista yhteytesi milloin tahansa osoitteessa [calori.health/account](https://calori.health/fi-fi/account).

### Claude

1. Avaa Settings → Connectors.
2. Valitse Add custom connector ja liitä `https://mcp.calori.health/mcp`.
3. Valitse Connect ja kirjaudu Caloriin.

### ChatGPT

1. Avaa Settings → Apps & Connectors ja kytke Developer mode päälle.
2. Valitse Create ja liitä `https://mcp.calori.health/mcp`.
3. Kirjaudu Caloriin, kun ChatGPT pyytää.

### Mikä tahansa MCP-asiakas

1. Kutsu osoitetta `https://mcp.calori.health/mcp` Streamable HTTP:n kautta.
2. Ensimmäinen kutsu vastaa 401 ja osoittaa kirjautumispalvelimen: rekisteröi asiakkaasi siellä (dynamic client registration).
3. Ohjaa käyttäjä kirjautumaan ja kutsu uudelleen pääsytunnisteen kanssa.

### Cursor, VS Code ja Claude Code

- [Lisää Cursoriin](https://cursor.com/en/install-mcp?name=Calori&config=eyJ1cmwiOiJodHRwczovL21jcC5jYWxvcmkuaGVhbHRoL21jcCJ9)
- [Lisää VS Codeen](https://vscode.dev/redirect?url=vscode:mcp/install%3F%7B%22name%22%3A%22Calori%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.calori.health%2Fmcp%22%7D)
- Claude Code: `claude mcp add --transport http calori https://mcp.calori.health/mcp`

### Ei MCP-työkaluja?

Kaikki tilaukseen asti onnistuu ilman niitä. Tiedostossa [/llms-full.txt](https://calori.health/llms-full.txt) on tämän viikon ruokalista, jokaisen aterian kalorit ja makrot, hinnat ja toimitusalueet tekstinä, joten voit valita käyttäjälle sopivat ateriat. Tilausta varten yhdistä palvelimeen itse, jos pystyt tekemään HTTP-pyyntöjä (ks. Mikä tahansa MCP-asiakas yllä; käyttäjä kirjautuu sähköpostikoodilla), pyydä häntä lisäämään Calori avustajaansa tai ohjaa hänet [tilaamaan Calori-ateriat verkossa](https://calori.health/fi-fi/start).

## Jos ihmisesi sanoo…

### ”Minulla on nälkä.”

`get_days` → `find_food` tai `score_menu`

Aloita siitä, mitä päivästä on `get_days`-työkalun mukaan jäljellä: päivän suunnitelmassa oleva Calori-ateria on todennäköisesti jo hänen jääkaapissaan. Muille ruoille `find_food` antaa luvut, ja ruokalistalle, jolta hän valitsee, `score_menu`.

### ”Söin juuri korvapuustin.”

`find_food` → `log_food`

Käytä `find_food`-osumaa vain, kun se on sama ruoka; muuten kirjaa paras arviosi. Ruoka tilauksesta, jonka teit tai näit, kirjataan sen sijaan `record_order`-työkalulla.

### ”Haluan Calorin aterioita.”

`get_me` → `set_profile` → `check_area` → `set_address` → `preview_week` → `order_week` (käyttää rahaa)

Täytä `set_profile` sillä, mitä jo tiedät, ja kysy vain loput. Näytä ateriat, kuvineen jos voit, ja loppusumma ennen `order_week`-kutsua ja odota hänen hyväksyntäänsä. Toimitusalueen ulkopuolella `set_address` lisää hänet jonotuslistalle; jos korttia ei ole tallennettu, anna hänelle `get_me`-työkalun korttilinkki tilauksen jälkeen.

### ”Lisää välipala keskiviikolle.”

`find_food` → `edit_plan`

`find_food` `menu_date`-arvolla listaa päivän ruokalistan. `edit_plan` lisää, vaihtaa tai jättää pois Calori-aterioita viikolta, jota voi vielä muuttaa, kaikki kohdat yhdellä kutsulla; lisätty ateria laskutetaan viikon mukana, ja tuloksessa on uusi loppusumma.

### ”Missä ruokani on?”

`get_deliveries` → `send_delivery`

`get_deliveries` kertoo päivän kassin ja sen lähetin: valmis, tilattu tai matkalla seurantalinkin ja arvioidun saapumisajan kera. Jos kassi on valmis eikä lähettiä ole tilattu, `send_delivery` tilaa sen tai kertoo Calorille, että hän hakee kassin itse.

### ”Olen poissa ensi viikolla.”

`get_deliveries` → `pause_weeks`

Tauotettuja viikkoja ei toimiteta eikä laskuteta. `get_deliveries` kertoo ensimmäisen viikon, jota voi vielä muuttaa.

### ”Entä jos tavoittelisin lihaskasvua?”

`preview_eating_change` → `set_eating_change` tai `set_profile`

`preview_eating_change` näyttää, mitä muutos tekisi, ennen kuin mitään muutetaan: päivittäiset tavoitteet ennen ja jälkeen, Calorin odottaman painonmuutoksen viikossa ja sen, muuttuvatko Calori-ateriat mukana. Kun hän sanoo kyllä, `set_eating_change` tekee muutoksen, tai `set_profile` nimetylle tavoitteelle; `use_calori_targets` palauttaa Calorin omat tavoitteet.

### ”Juoksen nyt kolme kertaa viikossa.”

`update_profile`

Anna `update_profile`-työkalulle vain se, mikä muuttui. Liikunta yksinään ei muuta tavoitteita: kun hänen koko päivänsä on aktiivisempi, anna myös `activity_level`. Kun tavoitteet muuttuvat, seuraava viikko, jota voi vielä muuttaa, suunnitellaan uudelleen, joten sen ateriat ja hinta voivat muuttua.

### ”Miten minulla menee?”

`get_days` → `get_weight`

Katso trendejä päivien yli, älä yksittäisiä aterioita. `get_days` `intake`-lisäyksellä kattaa enintään 31 päivää ja kertoo, kuinka kattavasti kukin päivä on kirjattu; `get_weight` kattaa kuukausia. Kun hän haluaa nähdä päivän eikä vain kuulla siitä, käytä `show_day`-työkalua.

## Pelisäännöt

1. Lue ennen kuin vastaat: `get_days` hänen päivästään, `get_me` hänestä ja hänen tilinsä tilanteesta. Muuta asioita vain, kun käyttäjä pyytää.
2. Kysy ennen kaikkea, mikä maksaa tai keskeyttää toimitukset: näytä ateriat ja loppusumma ennen `order_week`-kutsua ja varmista ennen `edit_pause`- tai `cancel_deliveries`-kutsua.
3. Luvut ovat Calorin, eivät sinun: kun hän valitsee ruokalistalta, kutsu ensin `score_menu`, ja minkä tahansa tekemäsi tai näkemäsi ruokaostoksen jälkeen `record_order`, ei `log_food`.
4. Eri päivittäisiin lukuihin (”2 200 kcal”, ”160 g proteiinia”, ”vähemmän hiilihydraatteja”) käytä `set_eating_change`-työkalua, yksi asia kutsua kohden; `set_profile`-työkalun tavoite on vain nimetylle tavoitteelle. Kaikki on kilogrammoina ja senttimetreinä: muunna ensin.
5. Jokainen muutos näkyy Calori-sovelluksessa, ja useimmat voi perua `undo`-työkalulla, kunhan mikään ei ole sen jälkeen muuttunut.
6. Et voi katkaista omaa yhteyttäsi etkä poistaa käyttäjän tiliä. Ohjaa hänet osoitteeseen [calori.health/account](https://calori.health/fi-fi/account).
7. Calori on arjen syömiseen ja hyvinvointiin. Se ei diagnosoi eikä hoida mitään sairautta.

## Työkalut

30 työkalua välipalan kirjaamisesta viikon tilaamiseen. Useimmat muutokset voi perua. Kysy käyttäjältä lupa ennen kaikkea, mikä maksaa rahaa.

### Hänen päivänsä

- `get_days`: lukee
- `show_day`: lukee
- `log_food`: muuttaa
- `edit_food_log`: muuttaa
- `get_weight`: lukee
- `log_weight`: muuttaa
- `undo`: muuttaa

### Ruoka ja ruokalistat

- `find_food`: lukee
- `get_meal_details`: lukee
- `score_menu`: lukee
- `record_order`: muuttaa

### Profiili ja tavoitteet

- `get_me`: lukee
- `set_profile`: muuttaa
- `update_profile`: muuttaa
- `preview_eating_change`: lukee
- `set_eating_change`: muuttaa
- `use_calori_targets`: muuttaa
- `set_food_preferences`: muuttaa

### Tilaukset

- `check_area`: lukee
- `set_address`: muuttaa
- `preview_week`: lukee
- `order_week`: käyttää rahaa
- `edit_plan`: muuttaa
- `set_my_day`: muuttaa
- `pause_weeks`: muuttaa
- `edit_pause`: käyttää rahaa
- `cancel_deliveries`: muuttaa

### Toimitus

- `get_deliveries`: lukee
- `send_delivery`: muuttaa
- `set_delivery_time`: muuttaa

## Koneluettavat

- [/llms.txt](https://calori.health/llms.txt): Lyhyt kuvaus Calorista kielimalleille
- [/llms-full.txt](https://calori.health/llms-full.txt): Koko sivusto tekstinä, ruokalista ravintoarvoineen mukana
- [/.well-known/mcp/server-card.json](https://calori.health/.well-known/mcp/server-card.json): MCP-palvelimen kuvauskortti (standardiluonnos)
- [/fi-fi/agents.md](https://calori.health/fi-fi/agents.md): Tämä sivu markdownina