Taito Claude Codeen
Frihetin taito Claude Codeen muuttaa terminaalisi yrityshallinnon assistentiksi. Se ei ole vain pääsy API:in — se on liiketoiminnan älykkyyttä: espanjalainen verokonteksti, työnkulkujen "reseptejä", muotoillut talousraportit ja luonnollisen kielen komennot.
Vaatimukset
- Claude Code asennettuna
- Frihet-tili, jolla on API-yhteys (maksulliset suunnitelmat)
- Frihetin MCP-palvelin konfiguroituna (katso ohjeet)
Asennus
Suositeltava: Yksi komento (yli 30 agenttia)
npx skills add Frihet-io/frihet-mcp
Asentaa taidon ja konfiguroi sen automaattisesti. Toimii Claude Coden, Cursorin, Copilotin, Codexten, Windsurfin, Gemini CLI:n ja yli 30 muun agentin kanssa.
Vaihtoehto: Manuaalinen kopiointi
curl -sL https://raw.githubusercontent.com/Frihet-io/frihet-mcp/main/skill/SKILL.md \
-o ~/.claude/skills/frihet-mcp/SKILL.md --create-dirs
Konfiguroi MCP-palvelin
Jos sinulla ei vielä ole sitä, lisää tämä tiedostoon ~/.claude/mcp.json:
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["-y", "@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_tu_clave_aqui"
}
}
}
}
Hanki API-avain: app.frihet.io > Asetukset > API > Luo avain.
Komennot
| Komento | Kuvaus |
|---|---|
/frihet status | Tilin yhteenveto: viimeisimmät laskut, odottavat maksut, kuukauden kulut |
/frihet invoice | Laskujen luominen, listaaminen tai hakeminen |
/frihet expense | Kulujen kirjaaminen ja tarkastelu |
/frihet clients | Asiakaskannan hallinnointi |
/frihet quote | Tarjousten luominen ja hallinnointi |
/frihet report | Talousyhteenvedot (P&L, neljännesvuosittainen, erääntyneet) |
/frihet webhooks | Automaatiotriggereiden konfigurointi |
/frihet setup | Ohjattu konfigurointi ja yhteyden testaus |
Esimerkkejä käytöstä
Luo lasku
/frihet invoice "Acme SL, 40 tuntia konsultointia hintaan 75 EUR/tunti, eräpäivä 1. maaliskuuta"
Claude luo laskun yksityiskohtineen, laskee ALV:n 21 %:lla ja vahvistaa annetun numeron.
Kirjaa kulut nopeasti
/frihet expense "47.50 bensiini 15. helmikuuta"
/frihet expense "Adobe CC 59.99 ohjelmisto"
/frihet expense "Asiakkaan lounas 23.40 ravintola"
Taito päättelee kategorian ja merkitsee, onko se vähennyskelpoinen espanjalaisten verosääntöjen mukaan.
Valmistele neljännesvuosittainen ALV
/frihet report quarterly
Laskee automaattisesti:
- Veloitettu ALV (laskuissa peritty)
- Maksettu ALV (vähennyskelpoisissa kuluissa maksettu)
- Maksettava tai hyvitettävä tulos
- Tiedot valmiina Modelo 303 -lomakkeelle
Erääntyneiden laskujen seuranta
/frihet report unpaid
Listaa erääntyneet laskut summan, viivästyspäivien mukaan järjestettynä ja ehdottaa seurantaa.
Kuukausisulku
/frihet report
Kuukauden kattava yhteenveto: laskutetut tulot, kulut, nettotulos, netto-ALV, maksamattomat laskut.
Integroitu verokonteksti
Taito tuntee espanjalaisen verokontekstin:
| Käsite | Yksityiskohta |
|---|---|
| Yleinen ALV | 21% |
| Alennettu ALV | 10% (elintarvikkeet, kuljetus) |
| Superalennettu ALV | 4% (leipä, kirjat, lääkkeet) |
| Ammattilaisten IRPF | 15% (7% ensimmäiset 3 vuotta) |
| Modelo 303 | Neljännesvuosittainen ALV: huhti, heinä, loka, tammi |
| Modelo 130 | Neljännesvuosittainen IRPF (suora arviointi) |
| Verifactu | Pakollinen: yrityksille tammikuu 2027, itsenäisille ammatinharjoittajille heinäkuu 2027 |
Taito tuntee myös kulujen vähennyskelpoisuuden säännöt (bensiini 50 %, ateriat enintään 26,67 EUR/päivä jne.) ja soveltaa niitä automaattisesti kuluja kirjattaessa.
Työnkulut
Taito sisältää 'reseptejä' yleisiin toimintoihin:
- Kuukausisulku — Yhteenveto tuloista, kuluista, ALV:sta ja nettotuloksesta
- 303-valmistelu — Neljännesvuosittaisen ALV:n esilaskenta erittelyineen riveittäin
- Asiakkaan luonti — Asiakkaan luonti + ensimmäinen lasku yhdellä askeleella
- Tarjouksesta laskuksi — Hyväksytyn tarjouksen muuttaminen laskuksi
- Kuluerä — Useiden kulujen kirjaaminen kerralla automaattisella kategorisoinnilla
- Erääntyneet — Erääntyneet laskut, järjestetty summan ja viivästyspäivien mukaan
Ero MCP-palvelimeen
| MCP-palvelin | Taito | |
|---|---|---|
| Kattavuus | 52 CRUD-työkalua | Työkalut + liiketoiminnan älykkyys |
| Konteksti | Ei mitään | Espanjalainen vero, vähennyskelpoisuus, kalenteri |
| Työnkulut | Yksittäiset toiminnot | Monivaiheiset 'reseptit' (sulku, 303, konversio) |
| Muoto | Raaka JSON | Luettavat taulukot ja yhteenvedot |
| Edellytys | API-avain | API-avain + MCP-palvelin |
Taito käyttää MCP-palvelinta taustalla. Se ei duplikoi logiikkaa, vaan lisää kontekstia.
Turvallisuus
- API-avainta hallinnoidaan yksinomaan ympäristömuuttujien kautta MCP-konfiguraatiossa
- Taito ei koskaan näytä, kirjaa tai tallenna API-avaintasi
- Kaikki tiedot kulkevat salattuna Claude Coden, MCP-palvelimen ja Frihetin API:n välillä
- MCP-palvelin ei tallenna mitään — stateless-silta