MCP API · kehittäjille

Tuo Findu omaan agenttiisi.

Hae tarkistettuja suomalaisia mielen hyvinvoinnin palveluita, kohdista niitä tilanteeseen ja tarkista palveluntarjoajia samasta rajapinnasta.

Yhdistä Finduun → Tutustu 12 työkaluun
12
julkista työkalua
HTTP
Streamable-yhteys
FI / EN
haku kahdella kielellä

01

Nimeä vaihtoehtoja. Kerro miksi.

Findu palauttaa yksittäisiä palveluita ja kertoo, miksi ne voivat sopia kuvattuun tilanteeseen. Se ei diagnosoi, arvioi kiireellisyyttä tai laita palveluntarjoajia paremmuusjärjestykseen.

Jokaisessa tietueessa kulkee last_verified, eli päivä jolloin palveluntarjoajan sivu viimeksi tarkistettiin toimivaksi.

02 · CONNECT

Yksi päätepiste, yksi avain.

Myönnämme jokaiselle integraatiolle oman avaimen. Kerro viestissä lyhyesti mitä rakennat, niin saat oikean käyttöoikeustason ja rajat.

Pyydä avain sähköpostilla → Claude Code MCP -ohjeet ↗

findu · MCP

CLAUDE CODE

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer fu_read_..." \
  findu https://findingyou.fi/mcp/v1/

MUUT STREAMABLE HTTP -ASIAKKAAT

URL          https://findingyou.fi/mcp/v1/
Authorization: Bearer fu_read_...

Käytä päätepisteessä loppukauttaviivaa. Ilman sitä palvelin palauttaa uudelleenohjauksen.

03 · TOOLS

Pieni pinta, oikeat tehtävät.

Kaksitoista julkista työkalua kattavat kohdistamisen, hakemiston, tarkistamisen, paikalliset uutiset, kriisiresurssit ja ehdotukset.

KOHDISTA findu_match

Kun lähtökohta on ihmisen oma tilanne.

Kuvaa tarve omin sanoin. Findu palauttaa enintään kymmenen tarkistettua palvelua osuvuuden mukaan sekä perustelut, lähdetiedot ja turvarajan.

situation + location? + language?

HAKEMISTO

  • findu_services_search Rajaa kategorian ja paikan mukaan.
  • findu_service_get Hae yksi täysi palvelutietue.
  • findu_locations Katso hakemiston paikkakunnat.
  • findu_categories Katso kategoriat ja julkaisumäärät.

TARKISTA

  • findu_provider_check Tarkista nimi tai tarkka URL.
  • findu_provider_check_batch Tarkista enintään 100 viitettä verify-avaimella.

PAIKALLINEN TIETO

  • findu_news Selaa toimitettuja hyvinvointiuutisia.
  • findu_news_read Lue yksi uutiskooste lähteineen.

TURVA

  • findu_crisis_resources Suomen kriisi- ja kiireellisen avun yhteystiedot. Ei vaadi avainta.

YHTEYS JA EHDOTUKSET

  • findu_whoami Tarkista avaimen taso ja rajat.
  • findu_suggest_service Ehdota palvelua julkaisemattomaan tarkistusjonoon.

04 · BOUNDARY

Turvaraja kuuluu integraatioon.

Findu palauttaa tiedon, mutta sinun mallisi päättää mitä käyttäjä näkee. Nämä säännöt ovat osa avaimen käyttöehtoja.

  1. 01

    Nimeä vain palautetut palvelut.

    Älä keksi palvelua, puhelinnumeroa tai osoitetta tulosten rinnalle.

  2. 02

    Pysähdy crisis-vastaukseen.

    Kun crisis on true, näytä instruction ja yhteystiedot. Älä muotoile hakua uudelleen.

  3. 03

    Näytä last_verified.

    Kerro käyttäjälle milloin palveluntarjoajan sivu viimeksi tarkistettiin.

  4. 04

    Kysy hakemistoa reaaliajassa.

    Älä julkaise hakemistoa omana aineistona tai rakenna siitä vanhenevaa kopiota.

05 · PRIVACY

Hakutekstiä ei tallenneta.

findu_match-kutsu voi kuvata ihmisen mielenterveyttä. Alkuperäinen teksti ei päädy levylle, eikä telemetriataulussa ole sille saraketta.

Lue koko tietosuojaseloste →

TALLENNETAAN

Työkalu, avain, kesto, tila, tulosmäärä sekä johdetut kategoriat, paikkakunta, kieli ja palautetut palvelut.

EI TALLENNETA

Ihmisen oma hakuteksti, viesti tai prompti. Sisältönäytteiden säilytys vaatii erillisen sopimuksen ja on normaalisti pois päältä.

RAKENNA FINDUN PÄÄLLE

Kerro mitä agenttisi yrittää löytää.

Pyydä integraatioavain →