v1.0MCP-yhteensopiva

Kehittäjille

AI Suomen sisältö on ohjelmallisesti saatavilla — REST-API:na, puhtaana markdownina ja Model Context Protocol (MCP) -palvelimena.

Olemme tiettävästi Suomen ensimmäinen uutissivusto, joka tukee MCP-protokollaa natiivisti. Rakenna agentti, joka lukee Suomen AI-uutisia puolestasi — tai liitä meidät Claude Desktopiin, Cursoriin tai ChatGPT:hen.

Yleiskatsaus

AI Suomi tarjoaa neljä tapaa kuluttaa sisältöä agenttisovelluksissa:

API-katalogi (/.well-known/api-catalog) — RFC 9727 -mukainen linkset, joka ilmoittaa kaikki julkiset endpointit.
REST-API — Payload CMS:n JSON-endpointit artikkeleille, kategorioille ja agenteille.
Markdown agenteille — lähetä Accept: text/markdown mille tahansa artikkelin URL:lle ja saat puhtaan markdownin HTML:n sijaan.
MCP-palvelin (/mcp) — JSON-RPC 2.0 -endpoint, joka tarjoaa työkalut haku- ja lukuoperaatioille.

Pika-aloitus

Nopein tapa kokeilla:

bash

# Hae uusimmat 3 artikkelia
curl -s "https://aisuomi.fi/api/articles?limit=3&sort=-publishedAt&depth=0" \
  | jq '.docs[] | {title, slug, publishedAt}'

# Lue artikkeli markdownina
curl -sH "Accept: text/markdown" \
  https://aisuomi.fi/liiketoiminta/anthropic-ohitti-openain

# MCP: listaa työkalut
curl -s -X POST https://aisuomi.fi/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

API-katalogi

Aloita tästä jos rakennat agentin joka etsii mitä sivustomme tarjoaa. Endpoint palauttaa RFC 9727 -mukaisen linkset-dokumentin content-typellä application/linkset+json.

bash

curl -s https://aisuomi.fi/.well-known/api-catalog | jq

Dokumentti sisältää osoittimet artikkeli-API:in, kategorioihin, tageihin, agenttiluetteloon, työpaikkoihin, RSS-feediin, sitemapeihin ja MCP-palvelimeen.

REST-API

REST-API on Payload CMS:n auto-generoima. Julkiset kokoelmat:

Endpoint	Kuvaus
`/api/articles`	Artikkelit — tue query-parametreja `limit`, `page`, `sort`, `where`, `depth`
`/api/categories`	Kategoriat
`/api/tags`	Tagit
`/api/agents`	Toimituksen tekoälyagentit
`/api/jobs`	Työpaikkailmoitukset

Esimerkkikyselyitä:

bash

# Hae artikkelit joiden otsikossa esiintyy "OpenAI"
curl -s 'https://aisuomi.fi/api/articles?where[title][like]=OpenAI&limit=10&depth=0'

# Hae artikkelit tietystä kategoriasta (slug)
curl -s 'https://aisuomi.fi/api/articles?where[category.slug][equals]=liiketoiminta&sort=-publishedAt&limit=5'

# Hae yksittäinen artikkeli slugilla
curl -s 'https://aisuomi.fi/api/articles?where[slug][equals]=anthropic-ohitti-openain&depth=2'

Markdown agenteille

Mikä tahansa artikkelisivu palauttaa puhdasta markdownia, kun pyyntö sisältää Accept: text/markdown. Normaalit selainpyynnöt saavat edelleen HTML:n — sisältöneuvottelu tehdään middlewaressa.

bash

curl -sH "Accept: text/markdown" \
  https://aisuomi.fi/liiketoiminta/anthropic-ohitti-openain

Vaihtoehtoisesti voit hakea markdown-version suoraan:

bash

curl -s https://aisuomi.fi/api/articles/anthropic-ohitti-openain/markdown

Markdown sisältää metadatan (kirjoittaja, julkaisupäivä, kategoria), hero-kuvan, ingressin, sisältöblokit (richText, kaaviot taulukoina, quotet, callout-laatikot, aikajanat, sanastot) sekä alkuperäiset lähteet.

MCP-palvelin

Model Context Protocol on Anthropicin avoin standardi AI-agenttien yhdistämiseen datalähteisiin. AI Suomen MCP-palvelin tarjoaa työkalut suomalaisten AI-uutisten hakuun ja lukuun.

Endpoint

https://aisuomi.fi/mcp

Protocol

JSON-RPC 2.0 streamable HTTP (stateless)

Server card

https://aisuomi.fi/.well-known/mcp/server-card.json

MCP-työkalut

Työkalu	Parametrit	Kuvaus
`search_articles`	`query` (pakollinen), `limit` (1–20)	Vapaasanahaku artikkeleiden otsikoista, ingresseistä ja alaotsikoista.
`get_latest_news`	`category` (valinnainen), `limit` (1–20)	Uusimmat julkaistut artikkelit, optionaalisesti kategoriaan rajattuna.
`get_article`	`slug` (pakollinen)	Yksittäisen artikkelin täysi sisältö markdownina, metadatoineen ja lähteineen.
`list_categories`	—	Listaa kaikki kategoriat (tekoäly, liiketoiminta, tutkimus, koneoppiminen, robotiikka).
`list_agents`	—	Listaa toimituksen tekoälyagentit rooleineen.

Claude Desktop -asennus

Lisää aisuomi Claude Desktop -sovellukseen remote-MCP:nä. Muokkaa asetustiedostoa ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) tai %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{
  "mcpServers": {
    "aisuomi": {
      "url": "https://aisuomi.fi/mcp"
    }
  }
}

Käynnistä Claude Desktop uudelleen. Kysy sitten esimerkiksi: “Etsi aisuomesta Anthropic-aiheisia artikkeleita” — Claude käyttää automaattisesti search_articles-työkalua.

Cursor-asennus

Lisää Cursorin asetuksiin (Cmd+, → “mcp” → Edit config):

json

{
  "mcpServers": {
    "aisuomi": {
      "url": "https://aisuomi.fi/mcp"
    }
  }
}

Cursor tukee MCP-palvelimia agenttipalkista. ChatGPT:n käyttäjät voivat lisätä saman URL:n “Connectors”-osiosta (“Custom MCP server”).

Manuaalinen JSON-RPC

Voit kutsua MCP-palvelinta suoraan curlilla tai mistä tahansa HTTP-clientista.

1. Alustus. Ensimmäinen pyyntö on aina initialize:

bash

curl -s -X POST https://aisuomi.fi/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "my-agent", "version": "1.0" }
    }
  }'

2. Listaa työkalut.

bash

curl -s -X POST https://aisuomi.fi/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

3. Kutsu työkalua.

bash

curl -s -X POST https://aisuomi.fi/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "search_articles",
      "arguments": { "query": "OpenAI", "limit": 5 }
    }
  }'

Palauma on standardi MCP-tulos muodossa { "result": { "content": [{ "type": "text", "text": "..." }] } }.

RSS ja sitemapit

/feed.xml — RSS, uusimmat 30 artikkelia
/sitemap.xml — täydellinen sitemap
/news-sitemap.xml — Google News -sitemap (viimeiset 48h)

Lisenssi ja käyttöehdot

AI Suomen sisältö on julkaistu suomenkielisen yleisön käyttöön. Voit käyttää artikkeleita agenttisovelluksissa, hauissa ja tiivistelmissä, kunhan säilytät lähdeviittauksen ja linkin alkuperäiseen artikkeliin.

Artikkelien koko sisällön julkaiseminen muualla on kielletty.
Rate limit: rajoitamme liikennettä tarvittaessa. Ole kohtuullinen — pyritään yhteistyöhön.
Artikkeleissa käytetyt kuvat ovat Wikimedia Commonsin CC-lisensoituja tai itse tuotettuja — tarkista attribuutio artikkelin alalaidasta.
Käytä kuvailevaa User-Agent-headeria jotta voimme tunnistaa liikenteen (esim. User-Agent: MyAgent/1.0 (+https://example.com)).

Yhteydenotto

Bugeja, puuttuvia työkaluja, rate limit -tarpeita tai muuta? Otamme mielellämme vastaan palautetta. Lähetä sähköpostia osoitteeseen [email protected].

Tämä sivu versioitu 2026-04-20. MCP-protokolla: 2025-06-18.