Failiem.lv API un MCP piekļuve izstrādātājiem, vibe koderiem un programmēšanas aģentiem

Atjauninājums, 2026. gada oktobris: Failiem.lv MCP savienotājs vairs nav tikai lasīšanas režīmā. Ar lietotāja piekrišanu AI asistenti var arī izveidot mapes, pievienot, pārdēvēt un pārvietot failus un strādāt ar Failiem.lv DVS darbiem, un tie var pieslēgties, pierakstoties Failiem.lv, nevis izmantojot API piekļuves tokenu. Aktuālie rīki, ierobežojumi un iestatīšana ir aprakstīti Failiem.lv MCP dokumentācijā (angļu valodā). Tālāk aprakstīta pirmā MCP versija, kas tika izlaista 2026. gada jūlijā.

Pēdējās nedēļās Failiem.lv ir paplašinājis publisko API dokumentāciju un izlaidis pirmo mitinātā Model Context Protocol (MCP) savienotāja versiju. Šie atjauninājumi atvieglo Failiem.lv mākoņkrātuves integrēšanu lietotnēs, uzņēmumu darba procesos, automatizācijas rīkos un izstrādes vidēs ar mākslīgā intelekta atbalstu.

Atjaunotajā dokumentācijā vienuviet apkopots jaunām integrācijām ieteiktais REST API V2, saderīgie V1 galapunkti, mašīnlasāma OpenAPI specifikācija un MCP lietošanas norādes. Tā paredzēta gan izstrādātājiem, gan programmatūras un programmēšanas aģentiem, kuriem nepieciešams precīzs Failiem.lv iespēju apraksts.

Kam var izmantot Failiem.lv API?

Failiem.lv REST API ļauj autorizētām lietotnēm programmatiski strādāt ar mākoņkrātuves failiem un mapēm. Atkarībā no galapunkta un konta piekļuves tiesībām integrācijas var:

• veidot mapes un augšupielādēt failus no uzņēmuma sistēmām vai automatizētiem procesiem;
• iegūt mapju satura sarakstus un failu vai mapju metadatus;
• lejupielādēt failus apstrādei, piegādei, dublēšanai vai sinhronizācijai;
• pārdēvēt, pārvietot, dzēst un atjaunot saturu;
• integrēt failu kopīgošanu, priekšskatīšanu, konvertēšanu, elektronisko parakstīšanu vai dokumentu aprites procesus;
• veidot klientu portālus, augšupielādes veidlapas, multivides apstrādes procesus, arhīvus un iekšējās integrācijas, izmantojot Failiem.lv krātuvi.

Jaunām integrācijām ieteicams izmantot API V2, ja tajā ir pieejams attiecīgais galapunkts. Dokumentētie V1 galapunkti joprojām ir pieejami saderībai un funkcijām, kurām vēl nav V2 ekvivalenta.

Dokumentācija cilvēkiem un programmatūrai

Failiem.lv API dokumentācija apkopo API aprakstus vienuviet. Izstrādātāji var izmantot OpenAPI specifikāciju ar koda ģeneratoriem, API klientiem, testēšanas rīkiem un automatizācijas platformām. Swagger UI ļauj interaktīvi iepazīt API, savukārt Markdown apraksti ir ērti lietojami gan izstrādātājiem, gan valodas modeļiem.

Šī struktūra ir īpaši noderīga integrācijas izstrādes laikā. Izstrādātājs var pārskatīt pieprasījumu parametrus un atbilžu laukus, bet programmēšanas aģents — meklēt tajos pašos avotos, pirms veido integrāciju, testus vai datu pārveidošanas kodu. Tas mazina minējumus un palīdz saglabāt ģenerētā koda atbilstību aktuālajam API aprakstam.

MCP piekļuve programmēšanas aģentiem

Mitinātais Failiem.lv MCP galapunkts ir pieejams adresē https://api.files.fm/api/mcp. MCP nodrošina standartizētu veidu, kā saderīgi AI klienti un programmēšanas aģenti var atrast pieejamos rīkus un resursus.

Savienotāja pirmā versija tikai lasīšanas režīmā ļauj autentificētam aģentam:

• atrast Failiem.lv kontam pieejamos failus un mapes;
• pārlūkot mapju saturu un apskatīt metadatus;
• meklēt failu nosaukumos un pieejamajos indeksētajos metadatos;
• lasīt pieejamos failus dokumentācijā norādīto izmēra un formāta ierobežojumu ietvaros;
• meklēt Failiem.lv API dokumentācijā.

Tas palīdz, piemēram, atrast projektu specifikācijas, lasīt tehnisko dokumentāciju, sameklēt pārskatus, apkopot teksta failu saturu, salīdzināt saglabātos materiālus vai palīdzēt izstrādātājam rakstīt kodu darbam ar Failiem.lv API. Publiskās API dokumentācijas meklēšana ir pieejama arī bez piekļuves privātiem konta failiem.

Pirmā versija bija tikai lasīšanai

Pirmā MCP versija apzināti neveica augšupielādi, pārdēvēšanu, pārvietošanu, dzēšanu, atjaunošanu, kopīgošanu vai citas failu izmaiņas, un tās privātajiem rīkiem bija nepieciešams Failiem.lv API piekļuves tokens. Rezultāti atbilst esošajām konta failu un mapju piekļuves tiesībām. Pieprasījumu biežuma un failu lasīšanas apjoma ierobežojumi palīdz padarīt automatizētu lietošanu paredzamu.

Pašreizējais savienotājs pēc skaidras piekrišanas var veikt arī kontrolētas izmaiņas: izveidot mapes un pievienot, pārdēvēt un pārvietot failus, taču joprojām nedzēš un nepārraksta failus un nemaina kopīgošanu. Pārējās darbības, kas maina datus, ir pieejamas REST API, kur lietotnes var nodrošināt skaidru datu pārbaudi, piekļuves tiesību kontroli, apstiprināšanu un kļūdu apstrādi.

Kā sākt

Izstrādātāji var izveidot un atsaukt API piekļuves tokenus Failiem.lv konta iestatījumos, savienot saderīgu MCP klientu ar mitināto galapunktu, pierakstoties Failiem.lv, vai izmantot REST un OpenAPI dokumentāciju tiešas integrācijas izveidei. Reālās automatizācijās jāizmanto HTTPS, tokenus nedrīkst glabāt pirmkodā vai URL adresēs, un, kur iespējams, jāizmanto atsevišķi konti vai tokeni ar ierobežotu piekļuvi.

MCP savienotājs tikai lasīšanas režīmā bija pirmais solis plašākai aģentu izmantošanai Failiem.lv darba procesos. Turpinām pilnveidot API, dokumentāciju un kontrolētas automatizācijas iespējas, ņemot vērā reālās integrāciju vajadzības un lietotāju atsauksmes.