Tilslut den første MCP-server

Det vigtigste kort

En tilslutning består af tre oplysninger: det program, der startes, dets argumenter og adgangsdataene som miljøvariabler.
Adgangsdata hører aldrig hjemme i selve konfigurationsfilen, men i en miljøvariabel eller et nøglelager.
De tre hyppigste fejl: forkert sti til programmet, manglende genstart af programmet og en adgangsnøgle med for vidtgående rettigheder.
Før driften står en kort tjekliste – frem for alt spørgsmålet om, hvad et fejlgreb højst kan anrette.

Model Context Protocol er en åben standard, hvorigennem en sprogmodel kan tilgå værktøjer og data – filer, kalender, et CRM, en database. Fordelen frem for enkeltløsninger: det, der én gang findes som MCP-server, fungerer med enhver applikation, der taler protokollen.

Den første tilslutning er det punkt, hvor mange giver op – ikke fordi det er kompliceret, men fordi fejlmeddelelserne er uspecifikke.

De tre dele af en tilslutning

Serveren

Et lille program, der stiller en datakilde eller et værktøj til rådighed. Det kører på jeres maskine eller på en server og startes efter behov – I behøver ikke skrive det selv, til de gængse systemer findes der færdige.

Klienten

Den applikation, I arbejder i, og som taler til serveren. Den starter den, spørger den, hvilke værktøjer den tilbyder, og lægger dem frem for modellen.

Konfigurationen

En lille fil, der fortæller klienten: start dette program, med disse argumenter, med disse adgangsdata. Mere står der ikke i den – og netop her sker de fleste fejl.

Opsætningen i seks trin

Vælg server. Begynd med en læsende adgang til noget ukritisk – et filkatalog, en dokumentation. Ikke med CRM'et.
Kontrollér kørselsmiljøet. De fleste servere kræver Node.js eller Python. Kontrollér versionen, før I går i gang: node --version henholdsvis python --version.
Opret adgangsnøglen – så snæver som muligt. Hvis serveren kun skal læse, så giv den kun læserettigheder. Det er det trin, der hyppigst gøres for gavmildt.
Skriv konfigurationen ind. Program, argumenter, miljøvariabler. Brug absolutte stier, ikke relative.
Afslut programmet helt, og start det igen. Ikke bare lukke vinduet – konfigurationen læses ved starten.
Kontrollér, om værktøjerne er der. Klienten viser, hvilke værktøjer en server tilbyder. Kommer der intet frem dér, er serveren ikke startet.

Bemærk Skriv aldrig en adgangsnøgle direkte i en konfigurationsfil, der ligger i et projektkatalog. Sådanne filer havner erfaringsmæssigt i sikkerhedskopier, i versionsstyringer og i skærmbilleder. Brug en miljøvariabel eller styresystemets nøglelager.

De faldgruber, der ikke står i nogen dokumentation

Stien passer ikke

Den hyppigste fejl overhovedet. Applikationen starter serveren i et andet miljø end jeres kommandolinje – et program, der findes i terminalen, er dér muligvis ukendt.

Løsning: Skriv den fulde sti ind. På macOS og Linux findes den med which node, på Windows med where node.

Ingen genstart

Konfigurationen læses, når applikationen starter. At lukke vinduet er ikke nok – på macOS kører applikationen videre.

Løsning: Afslut helt, og start igen. Lyder banalt, koster regelmæssigt en halv time.

Nøglen har for mange rettigheder

En adgangsnøgle med skrive- og sletterettigheder bemærkes ikke ved opsætningen. Den bemærkes, når en anvisning misforstås.

Løsning: Opret to nøgler – en læsende til hverdagen, en skrivende kun dér, hvor skrivning faktisk er nødvendig.

Serveren starter, men melder intet

En server, der bryder ned ved starten, viser sig i klienten som regel bare som tom – uden fejlmeddelelse.

Løsning: Kør startkommandoen én gang manuelt i kommandolinjen. Dér står der så, hvad der mangler.

Vidste du det?

En MCP-server beskriver sine egne værktøjer – navn, formål, forventede oplysninger. Modellen får først at vide under kørslen, hvad den kan.

Deraf følger noget praktisk: kvaliteten af disse beskrivelser bestemmer i høj grad, hvor pålideligt et værktøj bliver brugt. En server med beskrivelsen «søger kontakter» bliver betjent dårligere end en med «søger kontakter efter firmanavn eller e-mailadresse; giver højst 50 træf tilbage; finder ikke slettede poster». Den, der selv bygger en server, investerer tiden bedst i disse tekster.

Tjekliste før driften

Spørgsmål	Hvorfor det tæller
Hvad kan et fejlgreb højst anrette?	Afgør, om skriverettigheder er forsvarlige
Er adgangen logget?	Uden log kan intet rekonstrueres bagefter
Hvem kender adgangsnøglen?	Afgør, hvem der skal skifte den ved personaleudskiftning
Er der persondata inden for adgangen?	Så griber databeskyttelsespligter – også hos modellens udbyder
Hvordan slår man den hurtigt fra?	Skal være afklaret, før man får brug for det

Fra praksis

Den fjerde række springes næsten altid over, når man prøver sig frem, og den har de største følger. Så snart en server har adgang til kundedata, overføres disse data til modellens udbyder – det er en databehandling med alt, hvad dertil hører.

For det første forsøg betyder det: tag et katalog med ukritiske filer, ikke kundelisten. Forskellen mellem «prøve sig frem» og «i drift» er ikke af teknisk art – den opstår i det øjeblik, hvor rigtige data er i spil.

Prompt

Hjælp mig med at sætte min første MCP-tilslutning op og kontrollere den.

Min situation:
- Styresystem: [macOS / Windows / Linux]
- Applikation, jeg arbejder i: [KLIENT]
- Hvad jeg vil tilslutte: [datakilde eller værktøj]
- Skal adgangen læse eller også skrive? [læse / begge dele]
- Er der persondata inden for adgangen? [ja / nej / uklart]

Opgaver:
1. Nævn de oplysninger, jeg skal skrive ind i konfigurationen,
   og forklar hver af dem i én sætning.
2. Fortæl mig, hvordan jeg på mit styresystem finder den fulde
   sti til programmet.
3. Nævn de snævrest mulige rettigheder til adgangsnøglen.
   Begrund, hvorfor mere vidtgående rettigheder ikke er nødvendige.
4. Giv mig tre kontroltrin, hvormed jeg fastslår, om
   serveren kører – og hvad der skal gøres i hvert tilfælde, hvis ikke.
5. Hvis der er persondata inden for adgangen: nævn, hvad der skal
   være på plads forinden.

Spørg ikke efter selve adgangsdataene – dem skriver jeg ind som
miljøvariabel.

Konklusion

Den tekniske forhindring er lavere, end den virker: tre oplysninger i en konfigurationsfil, en genstart, færdig. De tre tilbagevendende fejl er en relativ i stedet for absolut sti, en glemt genstart og en for gavmild adgangsnøgle.

Den egentlige beslutning er ikke teknisk: den ligger i, hvad I giver adgang til. Begynd med noget, hvor et fejlgreb er uden følger – og få databeskyttelsesspørgsmålene på plads, før rigtige kundedata er i spil, ikke bagefter.

Ofte stillede spørgsmål

Hvordan sætter man en MCP-server op?

I seks trin: vælg en server til en ukritisk datakilde, kontrollér kørselsmiljøet (som regel Node.js eller Python), opret en adgangsnøgle med så snævre rettigheder som muligt, skriv program, argumenter og miljøvariabler ind i konfigurationen, genstart applikationen helt, og kontrollér, om værktøjerne dukker op i klienten.

Kræver en MCP-tilslutning programmeringskundskaber?

Nej, hvis der findes en færdig server til målsystemet. Opsætningen består i at skrive tre oplysninger ind i en konfigurationsfil. Programmeringskundskaber kræves først, når man skriver sin egen server til et system, der ikke har en.

Hvorfor dukker MCP-serveren ikke op i applikationen?

Som regel af en af tre grunde: stien til programmet er angivet relativt i stedet for absolut og findes ikke i applikationens miljø, applikationen blev ikke afsluttet helt og startet igen, eller serveren bryder ned ved starten. Det sidste tilfælde findes ved at køre startkommandoen én gang manuelt i kommandolinjen.

Hvor gemmer man adgangsdataene til en MCP-server?

I en miljøvariabel eller i styresystemets nøglelager – aldrig direkte i konfigurationsfilen. Sådanne filer havner erfaringsmæssigt i sikkerhedskopier, versionsstyringer og skærmbilleder. Fornuftigt er desuden to adskilte nøgler: en læsende til hverdagen, en skrivende kun dér, hvor den er nødvendig.

Hvad skal man være opmærksom på databeskyttelsesretligt?

Så snart en server har adgang til persondata, overføres disse til modellens udbyder – det er en databehandling med aftale, omtale i databeskyttelseserklæringen og et grundlag for overførslen til udlandet. Til de første forsøg er et katalog med ukritiske filer derfor det rigtige udgangspunkt.