# Koneluettava pääsy Etlan tutkimukseen

**Published:** 2026-06-03  
**URL:** https://www.etla.fi/ai-rajapinnat/

Etla tarjoaa kielimalleille, agenteille ja kehittäjille *rakenteisen, suoran pääsyn* verkkosisältöönsä: julkaisut, tutkimushankkeet, tutkijat, uutiset ja tapahtumat — ilman valikoita, mainoksia tai skriptejä.

## llms.txt

llms.txt on koneluettava hakemisto Etlan julkaisuista. Se on sijoitettu domainin juureen, ja se listaa suhdanne-ennusteet, toimialakatsaukset, raportit, muistiot ja working paperit — kunkin Markdown-linkin ja lyhyen tiivistelmän kanssa. Tiedosto on tarkoitettu kielimallien reaaliaikaiseen lukemiseen, jotta sisältö välittyy oikein ja oikein lähdemerkittynä.

Sijainti

 `https://www.etla.fi/llms.txt`
 Kopioi

Jokaiseen julkaisuun pääsee myös suoraan Markdown-muodossa lisäämällä julkaisun osoitteen perään `.md`. Myös kategoria- ja listaussivut ovat saatavilla Markdownina samalla tavalla (esim. `https://www.etla.fi/julkaisut/muistiot.md`).

## MCP-palvelin

Model Context Protocol (MCP) -palvelin antaa tekoälyagenteille suoran, työkalupohjaisen pääsyn Etlan sisältöön: suodatettuun hakuun, yksittäisen sisällön (minkä tahansa tyypin) noutoon ja julkaisusarjojen listaukseen. Sisältö on julkista.

MCP-endpoint

 `https://www.etla.fi/wp-json/mcp/etla`
 Kopioi

- `search-content`Hae kaikkea Etlan sisältöä (julkaisut, tutkimushankkeet, uutiset, lausunnot, kolumnit, asiantuntijat, tapahtumat). Suodata sisältötyypin, julkaisusarjan, tagin, avainsanan, JEL-koodin, kirjoittajan, kielen tai päiväyksen mukaan; tulokset relevanssijärjestyksessä.
- `get-content`Nouda yksittäisen sisällön täydet, tyyppikohtaiset metatiedot ID:n, slugin tai URL:n perusteella — ja halutessa Markdown-sisältö. Toimii kaikille sisältötyypeille; liittyvät kohteet (tutkimushanke, tutkimusryhmä, kirjoittajat) palautetaan linkitettyinä viittauksina.
- `list-series`Listaa kaikki Etlan julkaisusarjat (esim. Raportit, Working Papers, Muistiot, Suhdanne) — kunkin julkaisumäärä, viimeisin päiväys ja kielet. Hyödyllinen yleiskuva ennen kohdennettua hakua.

## Gemini Enterprise

Gemini Enterprise edellyttää MCP-palvelimilta OAuth-autentikointia, jota Etlan suora MCP-endpoint ei käytä. Siksi Etla tarjoaa *OAuth-sillan*, jonka kautta mikä tahansa Gemini Enterprise -organisaatio voi liittää Etlan sisällön omaan ympäristöönsä. (Suoraa endpointia `/wp-json/mcp/etla` käyttävät esim. Claude, Gemini CLI ja Antigravity sellaisenaan.)

Custom MCP Server -connectorin asetukset

- MCP Server URL

    `https://mcp-bridge.etla.fi/mcp`Kopioi
- Authorization URL

    `https://mcp-bridge.etla.fi/authorize`Kopioi
- Token URL

    `https://mcp-bridge.etla.fi/token`Kopioi
- Client ID

    `etla-gemini`Kopioi
- Client Secret

    `sxgfSzQdL9aW6biiFHECvWeOMQj2iKgL`Kopioi
- Scopes

    `etla.read`Kopioi

Liittäminen: Google Cloud -konsolissa **Gemini Enterprise → Data stores → Create data store → Custom MCP Server (Preview)** → syötä yllä olevat arvot → **Login** → **Create**. Kun data store on *Active*: **Actions → Reload custom actions → Enable actions**, ja liitä data store Gemini Enterprise -appiisi.

Edellyttää Gemini Enterprise -lisenssiä (Standard/Plus/Frontline). Organisaation ylläpitäjän tulee lisäksi sallia custom MCP -data storet (organisaatiopolitiikka) ja myöntää Discovery Engine -oikeudet. Sisältö on julkista ja read-only — OAuth-kerros vain täyttää Geminin pakollisen autentikointivaatimuksen, joten Client Secret on jaettu, ei-luottamuksellinen arvo.

## Koneluettava löydettävyys

MCP-palvelimen metatiedot — endpoint, transport, kyvykkyydet ja työkalut — on julkaistu vakiintumassa olevissa `.well-known`-poluissa, jotta agentit ja aggregaattorit löytävät ne automaattisesti.

Server card

 `https://www.etla.fi/.well-known/mcp/server-card.json`
 Kopioi

Discovery-dokumentti

 `https://www.etla.fi/.well-known/mcp.json`
 Kopioi

## Käyttö ja attribuutio

Etlan julkaisut ovat julkisia. Kun käytät tai siteeraat sisältöä — myös tekoälyn tuottamissa vastauksissa — pyydämme mainitsemaan lähteen, jotta lukija löytää alkuperäisen julkaisun ja sen tekijät. Suositeltava lähdeviittaus löytyy kunkin julkaisun yhteydestä.

Esimerkki lähdeviittauksesta

Wang, Maria & Kuusi, Tero (10.6.2026). *Hiilirajamekanismin laajennus epäsuoriin päästöihin: vaikutukset Suomelle*, Etla Raportti nro 178, <https://pub.etla.fi/ETLA-Raportit-Reports-178.pdf>

## Yhteydenotot

Kysymykset koneluettavasta pääsystä, MCP-integraatiosta tai sisällön AI-käytöstä:

<api@etla.fi>

---

## Additional Information