eewookskehittäjille
Version 0.2 dokumentaatioAPI 0.2.0 on käytössä ja varmennettu. Tarkista saatavuus ennen integraation käyttöönottoa.

MCP-yhteys

Ewooksissa on yksi tunnistautumista edellyttävä HTTP POST -päätepiste. Työkalun nimi välitetään JSON-RPC-viestissä, ei erillisenä REST-osoitteena.

Tuetut viestit

Metodi Toiminta
initialize Palauttaa neuvotellun protokollaversion, palvelinversion ja ominaisuudet
notifications/initialized Ilmoitus ilman id-kenttää; HTTP 202 ja tyhjä vastausrunko
ping Palauttaa tyhjän tulosobjektin
tools/list Listaa neljä työkalua ja niiden JSON-parametriskeemat
tools/call Suorittaa fleetiin rajatun lukutoiminnon

Palvelin tukee protokollaversioita 2025-03-26, 2025-06-18 ja 2025-11-25. Suosi versiota 2025-11-25 ja käytä initialize-vastauksen palauttamaa versiota. Tuntematon, erikseen lähetetty MCP-Protocol-Version-otsake hylätään.

Pyynnön rakenne

{
  "jsonrpc": "2.0",
  "id": 42,
  "method": "tools/call",
  "params": {
    "name": "list_drives",
    "arguments": {
      "from": "2026-11-20",
      "to": "2026-11-20",
      "pagination": "snapshot",
      "limit": 100
    }
  }
}

Käytä id-kentässä kokonaislukua tai merkkijonoa ja yhdistä vastaus samaan tunnisteeseen. JSON-RPC:n eräpyyntötaulukoita ei tueta. Pyyntörungon on oltava JSON-objekti, jonka enimmäiskoko on 65 536 tavua.

Nykyinen toteutus palauttaa tavallisia JSON-vastauksia. Se ei edellytä pitkää GET-yhteyttä, SSE-tilausta tai Mcp-Session-Id-tunnistetta. HTTP GET hylätään koodilla 405.

Työkalun vastaus

Onnistunut työkalukutsu palauttaa saman aineiston sekä rakenteisena JSONina että tekstimuodossa:

{
  "jsonrpc": "2.0",
  "id": 42,
  "result": {
    "content": [{"type": "text", "text": "{\"period\":{\"from\":\"2026-11-20\",\"to\":\"2026-11-20\"},\"drives\":[],\"pagination\":\"snapshot\",\"next_cursor\":null,\"snapshot_at\":\"2026-11-21T10:00:00Z\",\"expires_at\":\"2026-11-21T10:15:00Z\"}"}],
    "structuredContent": {
      "period": {"from": "2026-11-20", "to": "2026-11-20"},
      "drives": [],
      "pagination": "snapshot",
      "next_cursor": null,
      "snapshot_at": "2026-11-21T10:00:00Z",
      "expires_at": "2026-11-21T10:15:00Z"
    },
    "isError": false
  }
}

Käytä ensisijaisesti structuredContent-kenttää. Tekstiesitys ei ole toinen aineistoerä, joten sitä ei yhdistetä samoihin tietueisiin uudelleen. Epäonnistuneen kutsun käsittely kuvataan virheohjeessa.

Taustaohjelmat ja selaimet

Palvelinohjelma ei yleensä lähetä selaimen Origin-otsaketta. Selainten alkuperät on rajattu palvelimella. Tällä ohjesivustolla ei ole selaimessa API-avainta käsittelevää kokeilukonsolia; avaimet ja kalustotiedot kuuluvat integraation taustapalveluun.

Protokollan alkuperäinen määrittely on MCP-spesifikaatiossa.

Ewooksin kehittäjäohjeet · Päivitetty 21.11.2026 · Esimerkkitiedot ovat synteettisiä