Dokumentacija DI asistentams

Kaip prijungti šią dokumentaciją prie Claude, ChatGPT, Cursor ar VS Code per MCP, kad asistentas atsakinėtų remdamasis vadovu.

Prijunkite šią dokumentaciją prie savo dirbtinio intelekto (DI) asistento — Claude, ChatGPT, Copilot, Cursor ar kito. Tada, paklausus apie portalą, asistentas atsakymą susiras šiame vadove ir pateiks nuorodą į puslapį.

MCP serverio adresasStreamable HTTP

https://guides.dataportal.gov.lt/api/mcp

Be prisijungimo. Serveris viešas, raktų nereikia.
Tik skaitymui. Asistentas ieško ir skaito, bet nieko nekeičia.
Visada aktualus. Tas pats turinys, kurį matote svetainėje.

Kas yra MCP?

MCP (Model Context Protocol) — atviras standartas, kuriuo DI asistentai jungiasi prie išorinių šaltinių ir įrankių. Jį 2024 m. pristatė Anthropic, o dabar palaiko dauguma didžiųjų DI įrankių. Pavadinimą verta išskaidyti:

Modelmodelis

Kalbos modelis — DI asistento „smegenys". Jis daug žino, bet tik tai, ko išmoko iki tam tikros datos.

Contextkontekstas

Informacija, kurią modelis mato atsakydamas. Kuo tikslesnis kontekstas, tuo tikslesnis atsakymas.

Protocolprotokolas

Bendros taisyklės, kaip modelis kreipiasi į išorinį šaltinį: ko paklausti ir kokio atsakymo laukti.

MCP dažnai lyginamas su USB-C jungtimi: vienas kištukas tinka daugybei įrenginių. Taip ir čia — šią dokumentaciją prijungiame vieną kartą, o ja naudotis gali bet kuris MCP palaikantis asistentas.

Kam to reikia? Be ryšio su šaltiniu asistentas atsako iš atminties. Portalas galėjo pasikeisti po to, kai modelis buvo apmokytas, o mygtuko pavadinimą ar API parametrą jis gali tiesiog išsigalvoti. Su MCP asistentas pirmiausia pasitikrina šiame vadove, o atsakymą pagrindžia nuoroda, kurią galite atsiversti patys:

Klausiate
„Kaip atsisiųsti tik išfiltruotas eilutes?"
Asistentas ieško
Per MCP ieško šioje dokumentacijoje.
Skaito puslapį
Gauna aktualų vadovo tekstą.
Atsako su nuoroda
Atsakymas remiasi vadovu — galite pasitikrinti.

Kaip prijungti

claude.ai svetainėje ar Claude programėlėje:

Atverkite Settings → Connectors ir spustelėkite Add custom connector.

Įrašykite pavadinimą (pavyzdžiui, LDP dokumentacija) ir serverio adresą https://guides.dataportal.gov.lt/api/mcp. Autentifikacijos laukų nepildykite.

Spustelėkite Add. Pokalbyje, mygtuke + arba įrankių meniu, įjunkite šią jungtį.

Savų jungčių pridėjimas priklauso nuo Claude plano ir organizacijos nustatymų.

Terminale:

claude mcp add --transport http ldp-docs https://guides.dataportal.gov.lt/api/mcp

Patikrinkite komanda claude mcp list arba sesijoje — /mcp.

Atverkite Settings → Apps & Connectors → Advanced settings ir įjunkite Developer mode.

Grįžę į Apps & Connectors, spustelėkite Create, įrašykite pavadinimą ir serverio adresą, autentifikacijai pasirinkite No authentication.

Pokalbyje jungtį pasirinkite per mygtuką +.

Kūrėjo režimas pasiekiamas ne visuose ChatGPT planuose.

Faile .cursor/mcp.json (projektui) arba ~/.cursor/mcp.json (visiems projektams):

{
  "mcpServers": {
    "ldp-docs": {
      "url": "https://guides.dataportal.gov.lt/api/mcp"
    }
  }
}

Tada Cursor Settings → MCP patikrinkite, ar serveris įjungtas.

Su GitHub Copilot — faile .vscode/mcp.json:

{
  "servers": {
    "ldp-docs": {
      "type": "http",
      "url": "https://guides.dataportal.gov.lt/api/mcp"
    }
  }
}

Arba komandų paletėje pasirinkite MCP: Add Server ir įveskite adresą. Įrankius rasite Copilot Chat agento režimu.

Tinka bet kuri programa, palaikanti MCP per Streamable HTTP — nurodykite serverio adresą.

Jei programa palaiko tik vietinius (stdio) serverius, naudokite tarpininką mcp-remote (reikia Node.js):

{
  "mcpServers": {
    "ldp-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://guides.dataportal.gov.lt/api/mcp"]
    }
  }
}

Ko paklausti

Prijungę klauskite įprastai — asistentas pats nuspręs, kada ieškoti dokumentacijoje:

Kaip dataportal.gov.lt atsisiųsti tik išfiltruotas eilutes XLSX formatu?
Ką reiškia brūkšnelis duomenų lentelėje?
Kaip leidybos kalendoriuje rasti artimiausius leidimus ir įsidėti datą į savo kalendorių?
Parašyk Python kodą, kuris per API gauna visas lentelės eilutes, ne tik pirmą puslapį.

Kalbos

Dokumentacijos paieška apima ir lietuvišką, ir anglišką puslapių tekstą, o atsakymą pateikia ta kalba, kuria klausiate — net jei klausime vartojate kitos kalbos terminą, pavyzdžiui, portalo mygtuko pavadinimą. Pačio portalo oficialiosios statistikos duomenys pateikiami abiem kalbomis — lietuviškai ir angliškai, tad duomenų galite ieškoti ir juos gauti jums patogesne kalba.

Asistento įrankiai

Serveris asistentui suteikia tris įrankius. Jie apima ir naudotojo vadovą, ir Duomenų API dokumentaciją, abiem kalbomis.

search_docs

Ieško dokumentacijoje — ta pati paieška kaip svetainėje, abiem kalbomis; puslapius grąžina klausimo kalba.

get_page

Perskaito visą puslapį — tekstą, lenteles ir ekrano nuotraukų aprašus.

list_pages

Parodo visų puslapių sąrašą ta tvarka, kaip meniu.

Privatumas

Serveriui nereikia prisijungti, jis nenaudoja slapukų ir tik skaito viešą dokumentaciją.

Serverį pasiekia tik tai, ką asistentas įrašo į įrankio užklausą — paieškos žodžiai ar puslapio adresas, o ne jūsų pokalbis.
Kas saugoma: kai paieška ar puslapio užklausa nieko neranda, užregistruojami jos žodžiai ir kalba — be jokių duomenų apie klausiantįjį, kad trūkstamas temas būtų galima papildyti.
Kaip ir visuose šios svetainės puslapiuose, serveriai saugo įprastus techninius prieigos žurnalus.

Patį pokalbį tvarko jūsų DI asistento teikėjas pagal savo sąlygas. Daugiau — portalo privatumo politikoje.

Be MCP

Jei jūsų įrankis MCP nepalaiko, dokumentaciją galima pateikti ir kitaip:

Vienas puslapis

Mygtukas Kopijuoti Markdown puslapio viršuje. Arba prie puslapio adreso pridėkite .mdx.

Turinio sąrašas

llms.txt — visi puslapiai su trumpais aprašais ir nuorodomis.

Viskas viename faile

llms-full.txt — visa dokumentacija lietuviškai. Yra ir angliškai.

Patarimai

Norite išbandyti serverį? Paleiskite npx @modelcontextprotocol/inspector, pasirinkite Streamable HTTP, įrašykite serverio adresą ir iškvieskite įrankius patys.
Asistentas neranda atsakymo? Paprašykite jo tiesiogiai: „paieškok dataportal dokumentacijoje".