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.