Povezivanje prvog MCP poslužitelja: upute

Najvažnije ukratko

Poveznica se sastoji od tri podatka: programa koji se pokreće, njegovih argumenata i pristupnih podataka kao varijabli okoline.
Pristupni podaci nikad ne idu u samu konfiguracijsku datoteku nego u varijablu okoline ili u spremište ključeva.
Tri najčešće pogreške: kriva putanja do programa, izostalo ponovno pokretanje aplikacije i pristupni ključ s preširoko postavljenim pravima.
Prije produkcijskog rada dolazi kratak popis za provjeru – prije svega pitanje što jedan promašaj najviše može učiniti.

Model Context Protocol otvoreni je standard preko kojega jezični model može pristupiti alatima i podacima – datotekama, kalendaru, CRM-u, bazi podataka. Prednost u odnosu na pojedinačna rješenja: ono što jednom postoji kao MCP poslužitelj radi sa svakom aplikacijom koja govori taj protokol.

Prva je poveznica točka na kojoj mnogi odustanu – ne zato što bi bila složena, nego zato što su poruke o pogreškama neodređene.

Tri dijela jedne poveznice

Poslužitelj

Mali program koji stavlja na raspolaganje izvor podataka ili alat. Radi na vašem računalu ili na poslužitelju i pokreće se po potrebi – ne morate ga sami pisati, za uobičajene sustave postoje gotovi.

Klijent

Aplikacija u kojoj radite i koja se obraća poslužitelju. Ona ga pokreće, pita ga koje alate nudi i predočava ih modelu.

Konfiguracija

Mala datoteka koja klijentu govori: pokreni ovaj program, s ovim argumentima, s ovim pristupnim podacima. Više ondje ne piše – a upravo se ovdje događa većina pogrešaka.

Postavljanje u šest koraka

Odaberite poslužitelj. Počnite pristupom samo za čitanje nečemu nekritičnom – mapi s datotekama, dokumentaciji. Ne CRM-u.
Provjerite izvedbenu okolinu. Većina poslužitelja treba Node.js ili Python. Provjerite inačicu prije nego što počnete: node --version odnosno python --version.
Izradite pristupni ključ – što uže moguće. Ako poslužitelj treba samo čitati, dajte mu samo prava čitanja. To je korak koji se najčešće radi preširoko.
Upišite konfiguraciju. Program, argumenti, varijable okoline. Koristite apsolutne putanje, ne relativne.
Potpuno zatvorite aplikaciju i pokrenite je iznova. Ne samo zatvoriti prozor – konfiguracija se čita pri pokretanju.
Provjerite jesu li alati ondje. Klijent prikazuje koje alate poslužitelj nudi. Ako se ondje ništa ne pojavi, poslužitelj se nije pokrenuo.

Pozor Nikad ne pišite pristupni ključ izravno u konfiguracijsku datoteku koja leži u mapi projekta. Takve datoteke po iskustvu završavaju u sigurnosnim kopijama, u sustavima za upravljanje inačicama i na snimkama zaslona. Koristite varijablu okoline ili spremište ključeva operacijskog sustava.

Prepreke kojih nema ni u jednoj dokumentaciji

Putanja nije točna

Najčešća pogreška uopće. Aplikacija pokreće poslužitelj u drugoj okolini nego vaša naredbena linija – program koji se u terminalu pronađe ondje je možda nepoznat.

Rješenje: Upišite punu putanju. Na macOS-u i Linuxu doznaje se s which node, na Windowsu s where node.

Nema ponovnog pokretanja

Konfiguracija se čita pri pokretanju aplikacije. Zatvoriti prozor nije dovoljno – na macOS-u aplikacija nastavlja raditi.

Rješenje: Potpuno zatvoriti i pokrenuti iznova. Zvuči banalno, a redovito košta pola sata.

Ključ ima previše prava

Pristupni ključ s pravima pisanja i brisanja pri postavljanju ne upada u oči. Upast će u oči kad neka uputa bude krivo shvaćena.

Rješenje: Izradite dva ključa – jedan za čitanje za svakodnevni rad, jedan za pisanje samo ondje gdje se pisanje zaista treba.

Poslužitelj se pokrene, ali ništa ne javlja

Poslužitelj koji pri pokretanju prekine rad u klijentu se najčešće pojavi jednostavno kao prazan – bez poruke o pogrešci.

Rješenje: Izvedite naredbu za pokretanje jednom ručno u naredbenoj liniji. Ondje onda piše što nedostaje.

Jeste li znali?

MCP poslužitelj opisuje vlastite alate – naziv, svrhu, očekivane podatke. Model tek u trenutku izvođenja saznaje što može.

Iz toga slijedi nešto praktično: kvaliteta tih opisa bitno određuje koliko se pouzdano neki alat koristi. Poslužitelj s opisom «Traži kontakte» bit će lošije upotrijebljen od onoga s «Traži kontakte po nazivu tvrtke ili adresi e-pošte; vraća najviše 50 pogodaka; ne pronalazi izbrisane zapise.» Tko sam gradi poslužitelj, vrijeme najbolje ulaže u te tekstove.

Popis za provjeru prije produkcijskog rada

Pitanje	Zašto se broji
Što promašaj najviše može učiniti?	Određuje jesu li prava pisanja opravdana
Je li pristup zabilježen?	Bez zapisa se naknadno ništa ne može rekonstruirati
Tko zna pristupni ključ?	Određuje tko ga mora zamijeniti pri promjeni osoblja
Jesu li osobni podaci u pristupu?	Tada nastupaju obveze zaštite podataka – i kod pružatelja modela
Kako se brzo isključuje?	Mora biti razjašnjeno prije nego što zatreba

Iz prakse

Četvrti se redak pri isprobavanju gotovo uvijek preskoči, a ima najviše posljedica. Čim poslužitelj ima pristup podacima o klijentima, ti se podaci prenose pružatelju modela – a to je obrada po nalogu sa svime što uz nju ide.

Za prvi pokušaj to znači: uzeti mapu s nekritičnim datotekama, a ne popis klijenata. Razlika između «isprobavanja» i «u pogonu» nije tehničke naravi – ona nastaje u trenutku kad su u igri stvarni podaci.

Prompt

Pomozi mi postaviti i provjeriti moju prvu MCP poveznicu.

Moje stanje:
- Operacijski sustav: [macOS / Windows / Linux]
- Aplikacija u kojoj radim: [klijent]
- Što želim povezati: [izvor podataka ili alat]
- Treba li pristup čitati ili i pisati? [čitati / oboje]
- Jesu li osobni podaci u pristupu? [da / ne / nejasno]

Zadaci:
1. Navedi podatke koje moram upisati u konfiguraciju i objasni
   svaki u jednoj rečenici.
2. Reci mi kako na svom operacijskom sustavu doznajem punu
   putanju do programa.
3. Navedi najuža moguća prava za pristupni ključ. Obrazloži
   zašto opsežnija prava nisu potrebna.
4. Daj mi tri koraka provjere kojima utvrđujem radi li
   poslužitelj – i što u kojem slučaju treba učiniti ako ne radi.
5. Ako su osobni podaci u pristupu: navedi što prije toga mora
   biti uređeno.

Za same pristupne podatke ne pitaj – njih upisujem kao varijablu
okoline.

Zaključak

Tehnička je prepreka niža nego što se čini: tri podatka u konfiguracijskoj datoteci, jedno ponovno pokretanje, gotovo. Tri pogreške koje se ponavljaju jesu relativna umjesto apsolutne putanje, zaboravljeno ponovno pokretanje i preširoko postavljen pristupni ključ.

Prava odluka nije tehnička: ona leži u tome čemu odobravate pristup. Počnite s nečim kod čega je promašaj bez posljedica – i pitanja zaštite podataka riješite prije nego što su u igri stvarni podaci o klijentima, a ne poslije.

Česta pitanja

Kako se postavlja MCP poslužitelj?

U šest koraka: odabrati poslužitelj za nekritičan izvor podataka, provjeriti izvedbenu okolinu (najčešće Node.js ili Python), izraditi pristupni ključ s najužim mogućim pravima, upisati program, argumente i varijable okoline u konfiguraciju, potpuno iznova pokrenuti aplikaciju i provjeriti pojavljuju li se alati u klijentu.

Treba li znanje programiranja za MCP poveznicu?

Ne, ako za ciljni sustav postoji gotov poslužitelj. Postavljanje se sastoji od upisivanja tri podatka u konfiguracijsku datoteku. Znanje programiranja treba tek onaj tko piše vlastiti poslužitelj za sustav za koji ga nema.

Zašto se MCP poslužitelj ne pojavljuje u aplikaciji?

Najčešće iz jednog od tri razloga: putanja do programa navedena je relativno umjesto apsolutno i u okolini aplikacije se ne pronalazi, aplikacija nije potpuno zatvorena i iznova pokrenuta ili poslužitelj prekida rad pri pokretanju. Zadnji se slučaj pronalazi tako da se naredba za pokretanje jednom ručno izvede u naredbenoj liniji.

Gdje se spremaju pristupni podaci za MCP poslužitelj?

U varijabli okoline ili u spremištu ključeva operacijskog sustava – nikad izravno u konfiguracijskoj datoteci. Takve datoteke po iskustvu završavaju u sigurnosnim kopijama, sustavima za upravljanje inačicama i na snimkama zaslona. Smislena su usto dva odvojena ključa: jedan za čitanje za svakodnevni rad, jedan za pisanje samo ondje gdje se treba.

Na što treba paziti s obzirom na zaštitu podataka?

Čim poslužitelj ima pristup osobnim podacima, oni se prenose pružatelju modela – a to je obrada po nalogu s ugovorom, navođenjem u izjavi o zaštiti podataka i osnovom za prijenos u inozemstvo. Za prve je pokušaje zato mapa s nekritičnim datotekama pravo polazište.

Marketing koji se sam postavlja

Beta verzija Studio Enginea je otvorena. Osigurajte mjesto i sudjelujte od početka.

Pridruži se beti →

← Natrag na pregled