MCP

MCP serveris

Du standartiniai būdai prijungti DevData prie bet kurio AI agento: API raktas arba OAuth.

Prijungę DevData per MCP, savo AI agente iš karto turėsite įrankius Lietuvos įmonių paieškai, PVM mokėtojo tikrinimui, Sodros duomenims ir finansinėms ataskaitoms gauti. Agentas pats parinks, kurį įrankį iškviesti pagal jūsų klausimą.

MCP serverio adresas visiems klientams vienodas: https://mcp.devdata.lt. Prisijungti galima dviem būdais, ir abu jie veikia bet kurioje programoje, kuri palaiko nuotolinius MCP serverius (Streamable HTTP transportą). Programų nustatymų langai ir prisijungimo vedliai nuolat keičiasi, todėl čia aprašome ne konkrečias programas, o pačius metodus: jie lieka tie patys.

API raktas

Autentifikacijai naudojamas tas pats API raktas kaip REST API'ui, perduodamas Authorization antraštėje. Jei rakto dar neturite, žr. Kaip pradėti. Standartinė MCP konfigūracija atrodo taip:

{
  "mcpServers": {
    "devdata": {
      "url": "https://mcp.devdata.lt",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Ją galite panaudoti dviem vietose:

Programos nustatymuose. Dauguma agentų turi MCP serverių sekciją nustatymuose arba globalų konfigūracijos failą. Kur tiksliai įklijuoti, žiūrėkite savo programos dokumentacijoje.
Projekte, mcp.json faile. Daugelis agentų automatiškai pasiima MCP konfigūraciją iš projekto katalogo. Tikslus failo kelias ir pavadinimas priklauso nuo programos (pvz., .cursor/mcp.json ar .vscode/mcp.json).

Kai kurios programos naudoja šiek tiek kitokį formatą (kitą šakninį raktą ar YAML), bet reikšmės visada tos pačios dvi: serverio URL ir Authorization: Bearer sk_live_... antraštė.

OAuth

Jei nenorite niekur saugoti rakto, daugumoje programų užtenka pridėti nuotolinį MCP serverį adresu https://mcp.devdata.lt be jokių antraščių. Programa atidarys DevData prisijungimo langą naršyklėje: prisijungiate, spaudžiate Suteikti prieigą, ir įrankiai iškart veikia.

Suteiktą prieigą bet kada matote ir galite atšaukti per Prijungtos aplikacijos. Atšaukus, programa kitą kartą tiesiog paprašys prisijungti iš naujo.

Kurį būdą rinktis? Kasdieniam darbui patogiausias OAuth: jokio rakto kopijavimo, prieigą valdote paskyroje. API raktas geriau tinka, kai konfigūracija turi veikti be naršyklės: serveriuose, CI ar bendrame komandos projekte.

Įrankiai

Visi įrankiai reikalauja autentikacijos ir veikia vienodai abiem prisijungimo būdais (API raktas arba OAuth). Viešų įrankių nėra. Agentas pats parenka tinkamą pagal jūsų klausimą.

Įmonės paieška ir profilis

Įrankis	Aprašas
`search_companies`	Paieška pagal pavadinimą arba įmonės kodą
`get_company`	Pilna įmonės informacija pagal kodą (palaiko `expand`)
`resolve_company`	Suranda įmonę pagal kodą, PVM, Sodros kodą ar domeną

Įmonės duomenys

Įrankis	Aprašas
`list_financial_reports`	Finansinės ataskaitos pagal metus
`list_sodra_monthly`	Sodros mėnesiniai: darbuotojų skaičius, vidutinis atlyginimas
`list_sodra_changes`	Sodros darbuotojų pokyčiai
`list_tax_debts`	VMI mokesčių skolų istorija
`list_public_contracts`	Viešųjų pirkimų sutartys
`list_vehicles`	Registruotų transporto priemonių parkas (Regitra)
`list_lis_licenses`	Licencijos ir leidimai (RC LIS)
`list_insolvency_events`	Nemokumo įvykiai (AVNT)

Analizė per visą registrą

Įrankis	Aprašas
`count_companies`	Kiek įmonių atitinka filtrų rinkinį
`rank_companies`	Top-N įmonių pagal dabartinę metriką
`rank_financials`	Top-N pagal finansinę metriką konkretiems metams
`aggregate_companies`	Suma / vidurkis / min / max / kiekis per filtruotą aibę
`search_vehicles`	Cross-company Regitra paieška (kiek įmonių valdo TP)
`rank_employee_changes`	Top-N pagal Sodros darbuotojų pokyčius

Klasifikatoriai ir paslaugos

Įrankis	Aprašas
`get_legal_forms` / `get_company_statuses` / `get_reference`	Teisinės formos, statusai ir kiti klasifikatoriai
`get_usage`	Savaitės limitas, likutis ir naudojimas
`ping`	Ryšio ir autentikacijos testas

Sąrašas pildosi kartu su naujais duomenų rinkiniais. Naujausią visada matysite pačiame agente, prijungę serverį.

Pavyzdiniai klausimai

Paprastas:

Jūs: Patikrink, ar 304151376 yra PVM mokėtojas, ir pasakyk, kiek jis turi darbuotojų.

Agentas (kviečia get_company ir list_sodra_monthly): Įmonė kodu 304151376 yra Umbrella Corporation. PVM mokėtoja taip, kodas LT100012345678 nuo 1968-03-17. Pagal naujausius Sodros duomenis (2026-04) turi 12 darbuotojų, vidutinis atlyginimas 2 850 €.

Sudėtingesnis:

Jūs: Surask, kokios įmonės turi Rolls-Royce savo automobilių parke ir nesiverčia prekyba automobiliais.

Agentas (kviečia search_vehicles): Rolls-Royce parke turi kelios įmonės. Atmetus tas, kurių pagrindinė veikla yra prekyba automobiliais, lieka, pavyzdžiui, Umbrella Corporation (304151376): 1 Rolls-Royce, pagrindinė veikla nesusijusi su autoprekyba.

Dažni klausimai

Po konfigūracijos DevData įrankių nematau. Patikrinkite, ar paleidote programą iš naujo. Dauguma programų nustatymuose rodo MCP serverių sąrašą ir jų būseną: ten matysite, ar serveris prisijungė ir kokia klaida buvo (jei buvo).

Gaunu 401 Unauthorized. Raktas neteisingas arba atšauktas. Patikrinkite raktą API raktų skydelyje. Atkreipkite dėmesį, kad raktas turi prasidėti sk_live_. Jei jungiatės per OAuth, patikrinkite Prijungtas aplikacijas: galbūt prieiga buvo atšaukta, tada tiesiog prisijunkite iš naujo.

Gaunu 429 Too Many Requests. Viršijote savaitės užklausų limitą. Jis bendras visiems jūsų API raktams (REST API + MCP) ir atsinaujina kiekvieną pirmadienį. Limito būseną matote /usage endpoint'e arba skydelyje.

OAuth langas neatsidaro arba programa nesileidžia autorizuojama. Įsitikinkite, kad programa palaiko nuotolinius MCP serverius su OAuth. Jei ne, junkitės su API raktu: jis veikia visur.

Ankstesnis

REST API