Kytke tekoälyavustaja Alenna.fi:hin

1. Hanki avain

Rajapinta vaatii Alenna.fi-tilin, MCP-oikeuden ja henkilökohtaisen avaimen.

1. Kirjaudu sähköpostilla. Saat vahvistuskoodin ja -linkin, salasanaa ei tarvita. Ensimmäinen kirjautuminen luo tilin.
2. Pyydä MCP-oikeutta osoitteesta [email protected]. Lähetä viesti samasta sähköpostiosoitteesta, jolla kirjauduit, ja kerro, mihin avustajaan aiot kytkeä rajapinnan. Kun oikeus on lisätty, Oma tili -sivulle tulee kohta MCP-rajapinta.
3. Luo avain: Oma tili → MCP-rajapinta → anna avaimelle nimi (esimerkiksi Claude kotikoneella) → Luo uusi avain. Avain näytetään vain kerran, joten kopioi se heti talteen, esimerkiksi salasanojen hallintaan. Nimen voi lisätä tai vaihtaa myöhemmin.

Tee jokaiselle avustajalle oma avain. Silloin näet Oma tili -sivulta, milloin kutakin on viimeksi käytetty, ja voit perua yhden avaimen muiden toimiessa. Avaimet toimivat niin kauan kuin tililläsi on MCP-oikeus. Alla olevissa esimerkeissä alenna_OMA_AVAIMESI korvataan omalla avaimellasi.

2. Claude Code

Aja päätteessä:

claude mcp add --transport http alenna https://www.alenna.fi/api/mcp/ --header "Authorization: Bearer alenna_OMA_AVAIMESI"

Tarkista yhteys komennolla claude mcp list: Alenna.fi-palvelimen alenna tila on Connected. Claude Coden sisällä saman näkee komennolla /mcp.

• Oletuksena palvelin on käytössä vain siinä projektissa, jossa komennon ajoit. Lisää --scope user, niin se on käytössä kaikissa projekteissasi.
• Älä käytä tasoa --scope project: se tallentaa avaimen projektin .mcp.json-tiedostoon, joka päätyy helposti versionhallintaan.

3. Claude Desktop

Claude Desktop yhdistää etäpalvelimeen mcp-remote-sillan kautta. Silta tarvitsee koneelle Node.js:n.

1. Avaa järjestelmän valikkopalkista Claude → Settings… → Developer → Edit Config. Tiedosto claude_desktop_config.json aukeaa.
2. Lisää siihen Alenna.fi. Jos tiedostossa on jo muita palvelimia, lisää pelkkä alenna-kohta olemassa olevan mcpServers-kohdan sisään.
3. Tallenna, sulje Claude Desktop kokonaan ja käynnistä se uudelleen.

{
  "mcpServers": {
    "alenna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.alenna.fi/api/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer alenna_OMA_AVAIMESI"
      }
    }
  }
}

Otsakkeessa ei ole välilyöntiä kaksoispisteen jälkeen, ja avain annetaan env-kohdassa. Näin asetus toimii myös Windowsissa, jossa välilyönnit argumenteissa eivät välity oikein.

4. VS Code

Tallenna projektin kansioon tiedosto .vscode/mcp.json ja käynnistä palvelin. VS Code kysyy avaimen, kun palvelin käynnistyy ensimmäisen kerran, joten avain ei tallennu tähän tiedostoon. Palvelimen voi lisätä myös komentopaletin toiminnolla MCP: Add Server.

{
  "servers": {
    "alenna": {
      "type": "http",
      "url": "https://www.alenna.fi/api/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:alenna-avain}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "alenna-avain",
      "description": "Alenna.fi MCP-avain",
      "password": true
    }
  ]
}

5. Grok (xAI)

Grok käyttää etä-MCP-palvelimia xAI:n Responses API:n mcp-työkalun kautta (xAI: Remote MCP Tools). Anna palvelimen osoite, nimi ja avain:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-4.7",
  "input": "Milloin huomenna kannattaa ladata sähköauto 20 %:sta 80 %:iin? Auto on Renault Scenic 87 kWh.",
  "tools": [
    {
      "type": "mcp",
      "server_url": "https://www.alenna.fi/api/mcp/",
      "server_label": "alenna",
      "server_description": "Suomen pörssisähkön hinnat ja kulutuksen ajoitus",
      "authorization": "alenna_OMA_AVAIMESI"
    }
  ]
}'

• Käytä uusinta Grok-mallia, jonka tilisi sallii.
• authorization lähetetään palvelimelle Authorization-otsakkeena. Alenna.fi hyväksyy avaimen sekä Bearer-etuliitteen kanssa että ilman.
• allowed_tools-kentällä voit rajata käyttöön vain osan työkaluista. xAI:n Python SDK:ssa sama tehdään mcp(…)-työkalulla samoilla kentillä (allowed_tool_names).
• Jos teet oman botin (esimerkiksi Telegramiin tai Slackiin), lisää yllä oleva tools-määrittely botin API-kutsuun ja säilytä avain botin palvelimen ympäristömuuttujassa, älä koodissa.

6. Muut avustajat

Avustajat, joihin voi lisätä etä-MCP-palvelimen ja oman otsakkeen, toimivat samoin: siirtotavaksi HTTP tai Streamable HTTP, osoitteeksi https://www.alenna.fi/api/mcp/ ja otsakkeeksi Authorization: Bearer alenna_OMA_AVAIMESI. Jos avustaja osaa vain paikallisia palvelimia, käytä Claude Desktopin tapaan mcp-remote-siltaa. OAuth-kirjautumista vaativat avustajat eivät vielä toimi.

7. Testaa yhteys

Näillä komennoilla näet, että avain toimii, ennen kuin kytket sen avustajaan. Komennot on kirjoitettu macOS:n ja Linuxin päätteeseen.

KEY=alenna_OMA_AVAIMESI
URL=https://www.alenna.fi/api/mcp/

# 1. Kättely
curl -s $URL -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

# 2. Työkalut
curl -s $URL -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Halvin kolmen tunnin jakso
curl -s $URL -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"find_cheapest_window","arguments":{"duration_minutes":180}}}'

Kättely palauttaa palvelimen nimen alenna-fi, työkalulista kymmenen työkalua ja viimeinen kutsu halvimman kolmen tunnin jakson julkaistuista hinnoista.

8. Mitä avustaja voi kysyä

Avustaja valitsee työkalun itse. Kokeile esimerkiksi:

• ”Milloin tänään on halvin kolmen tunnin jakso?”
• ”Milloin huomenna kannattaa ladata sähköauto 20 %:sta 80 %:iin?”
• ”Paljonko sauna maksaa nyt ja halvimmillaan tänään?”
• ”Kannattaisiko minun vaihtaa 9 sentin kiinteään sopimukseen?”
• ”Mikä on oma kokonaishintani juuri nyt?”