Koneluettava pääsy Etlan tutkimukseen

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/mcpKopioi
  • Authorization URL
    https://mcp-bridge.etla.fi/authorizeKopioi
  • Token URL
    https://mcp-bridge.etla.fi/tokenKopioi
  • Client ID
    etla-geminiKopioi
  • Client Secret
    sxgfSzQdL9aW6biiFHECvWeOMQj2iKgLKopioi
  • Scopes
    etla.readKopioi

Liittäminen: Google Cloud -konsolissa Gemini Enterprise → Data stores → Create data store → Custom MCP Server (Preview) → syötä yllä olevat arvot → LoginCreate. 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ä: