Hva er MCP?

MCP (Model Context Protocol) er en åpen standard som lar AI-agenter koble seg til eksterne systemer. Tenk på det som en "USB-port" for AI: i stedet for å kopiere og lime inn data kan AI lese og søke i Propely direkte.

Når MCP er satt opp kan du for eksempel spørre om følgende:

"Vis meg alle eiendommene mine i Propely"
"Finn åpne oppgaver på Storgata 10"
"Søk etter serviceavtaler for brannvern"
"Hvem er jeg logget inn som?"

Forutsetninger

Dette trenger du for å sette opp og bruke en MCP-tilkobling:

En aktiv Propely-brukerkonto
En konto hos Claude (Pro, Max, Team eller Enterprise), eller ChatGPT (Plus, Pro, Enterprise eller Edu). Oppsett med Microsoft Copilot krever spesifikke lisenser - se mer informasjon i avsnittet Sette opp MCP i Copilot.

Tilgjengelige verktøy

Når MCP-tilkoblingen er etablert får AI-agenten tilgang til en rekke verktøy. Tabellen viser noen eksempler på disse, og den fullstendige listen finner du ved å utvide seksjonen nedenfor.

Verktøy	Beskrivelse	Eksempel
list_properties	Viser en oversikt over dine eiendommer	"Vis alle eiendommene mine"
list_all_properties	Viser eiendommer inkludert alle detaljer	"Gi meg full info om porteføljen"
get_property	Hent detaljer om én spesifikk eiendom	"Vis detaljer for Storgata 10"
list_all_tasks	Hent oppgaver og avvik, med filtrering på eiendom, dato m.m.	"Vis åpne oppgaver fra siste måned"
search_files	Søk i dokumenter og filer	"Finn serviceavtaler for brannvern"
get_current_user	Vis info om innlogget bruker	"Hvem er jeg logget inn som?"

Komplett liste over tilgjengelige MCP-verktøy

Bruker
• get_current_user — vis informasjon om innlogget bruker (ID, e-post, navn)
• get_user — hent detaljer om én bruker basert på ID (navn eller e-post)

Eiendommer
• list_properties — enkel liste: ID, navn, adresse
• list_all_properties — alle eiendommer med fullstendig informasjon inkludert
• get_property — hent detaljer om én eiendom på ID (navn) med infofelter

Leietaker-enheter
• list_property_units — leietaker-enheter på én eiendom, med infofelter
• get_unit — hent detaljer én enhet på navn/ID (krever ID eller navn på eiendommen)

Oppgaver og rutiner
• list_all_tasks — vis oppgaver/avvik, med filtre og sideveksling
• list_all_routines — vis alle rutiner (gjentakende oppgavemaler)
• create_routine — opprett rutine
• update_routine — oppdater en eksisterende rutine

Leverandørgrupper
• list_all_contractor_groups — vis alle leverandørgrupper, valgfritt navnesøk

Samlinger og elementer
• list_all_collections — vis alle dokumentasjonssamlinger (rom, systemer, avtaler …)
• list_all_collection_custom_fields — definisjoner på felt i samlingen for å tolke/skrive til disse
• list_all_collection_items — elementer i én samling på tvers av eiendommer
• get_collection_item — ett element med felt- og typespesifikke data
• list_collection_item_tasks — oppgaver/avvik registrert på et bestemt element
• create_collection_item — opprett element på en eiendom
• update_collection_item — rediger navn, felter, systeminfo, mappe, arkivstatus

Prosjekter
• list_all_projects — vis alle prosjekter, kan filtrere på eiendom/type
• get_project — vis et bestemt prosjekt, søker på navn/ID
• list_project_information_types — dokumentasjonskategoriene på prosjektet
• list_project_contractors — entreprenører på prosjektet med frister
• list_project_requirements — dokumentasjonskrav og status per krav
• list_project_files — filer levert i prosjektet, med fulltekstsøk

Filer og dokumenter
• search_files — søk i filnavn og innhold på tvers av alle eiendommer
• list_collection_item_files — dokumenter vedlagt et spesifikt samlingselement
• search_collection_item_documents — søk blant innhold i dokumentasjon på et bestemt element, med sidetreff
• read_document_text — les dokumenttekst, evt. sideintervall, med [page N]-markører
• upload_collection_item_files — last opp dokumenter til et element (URL eller base64)
• get_file_download_url — midlertidig nedlastings-URL (utløper etter én time)

Sette opp MCP i Claude

Claude støtter MCP via Connectors-innstillingen. Oppsettet fungerer i Claude-appen (desktop og web) og synkroniseres automatisk til mobil.

Legge til tilkoblingen

Gå til claude.ai eller åpne Claude-appen (desktop).
Velg Customize i venstremenyen, og trykk deretter på Connectors.
Klikk + og deretter Add custom connector.
Skriv inn følgende URL: https://api.propely.com/mcp
Trykk Connect for å verifisere med din Propely-bruker.
Du blir sendt til Propely sin innloggingsside. Logg inn med din vanlige Propely-bruker.
Etter innlogging er tilkoblingen klar.

Aktivere Propely i en samtale

Etter at tilkoblingen er satt opp må du aktivere den i samtalen du vil bruke den i.

Åpne en ny samtale i Claude
Klikk +-knappen i meldingsfeltet
Velg Connectors
Slå på Propely-koblingen
Du kan nå stille spørsmål om dine Propely-data.

Tips: Du trenger kun å aktivere tilkoblingen én gang. Etter det vil Propely være tilgjengelig som en kobling i alle nye samtaler.

Sette opp MCP i ChatGPT

ChatGPT støtter MCP via Developer Mode. Oppsettet fungerer på web og i desktop-appen.

Aktivere Developer Mode

Gå til chatgpt.com eller åpne ChatGPT-appen.
Gå til Settings → Apps & Connectors.
Velg Advanced settings og slå på Developer Mode.
Bekreft advarselen som vises.

Legge til Propely som tilkobling

Gå til Settings → Apps & Connectors, og velg Add new connector.
Lag et navn for tilkoblingen, for eksempel Propely.
Skriv inn følgende URL: https://api.propely.com/mcp
Sett autentisering til OAuth.
Kryss av for I trust this application og trykk Create.
Du blir sendt til Propely sin innloggingsside. Logg inn med din vanlige Propely-bruker. Etter innlogging er tilkoblingen klar.

Sette opp MCP i Microsoft Copilot Studio

Oppsettet med Copilot forutsetter at brukerne har riktige lisenser. Copilot-lisens legges til per bruker, men for å koble opp MCP må organisasjonen i tillegg ha en egen faktureringsplan i Power Platform. Dette settes opp i Lisensiering → Copilot Studio. Trykk Ny faktureringsplan og sørg for å opprette en plan koblet til Copilot Studio.

Deretter går man til Microsoft Copilot Studio for å opprette en egen agent som gis tilgang til Propely MCP: https://copilotstudio.microsoft.com/. Klikk Agenter og deretter Ny agent.

Agenten som er satt opp i eksempelet over ble gitt navnet Propely og følgende instruksjon:
"Du er en Propely-assistent som skal hjelpe med å hente og oppdatere data i Propely gjennom MCP-serveren som er tilgjengelig."

Instruksjonen kan med fordel gjøres mer utfyllende ved behov.

I menyen til høyre inne på agenten går man til seksjonen Verktøy for å legge til MCP-serveren. Klikk pluss-ikonet og deretter Legg til. Du får valg om å legge til en ny Model Context Protocol (MCP).

Fyll inn info om Propely MCP med navn og beskrivelse. Servernettadresse skal være https://api.propely.com/mcp
Autentisering settes til OAuth 2.0 og Konfigurasjonstype skal være dynamisk (med oppdagelse).

I neste steg oppretter man en ny tilkobling for å autentisere seg med Propely-brukeren sin.

Propely MCP er nå lagt til i den nyopprettede Propely-agenten, og det vil være mulig å hente ut data fra Propely under Forhåndsvisning.

For å få tilgang til Propely-agenten i Copilot, trykk på pluss-tegnet ved siden av Kanaler i menyen til høyre og velg deretter Teams + Microsoft 365. Velg Bruk og del, så Vis i Copilot.

Til slutt må Propely-agenten deles med resten av organisasjonen.

Du kan også finne mer informasjon i Microsofts dokumentasjon om MCP i Copilot Studio.

Webinar: Propely MCP - Koble AI-agenter til FDV-systemet ditt

I dette webinaret viser vi hvordan du kan koble en AI-assistent som Claude, ChatGPT eller Copilot til Propely ved hjelp av MCP, en åpen standard som lar AI jobbe mot dataene dine i plattformen.

Sjekk ut webinaret vårt her.

Ofte stilte spørsmål

Kan AI se data fra andre selskap?

Nei. AI har kun tilgang til samme data som du selv har tilgang til i Propely. Den bruker din innlogging og ser derfor kun dine eiendommer, oppgaver og filer.

Kan AI endre eller slette data i Propely?

Nei. MCP-tilkoblingen er skrivebeskyttet. AI kan kun lese og søke i data, og kan ikke opprette, endre eller slette noe.

Krever tilkoblingen en spesiell Propely-lisens?

Nei, alle aktive Propely-brukere kan koble til via MCP. Du trenger imidlertid en betalt plan hos Claude eller ChatGPT (se forutsetninger).

Må jeg logge inn på nytt etter tilkobling?

Som regel er dette ikke nødvendig. Tilkoblingen bruker automatisk oppdaterbare nøkler som fornyes i bakgrunnen. Hvis du har vært inaktiv i en lengre periode kan det hende du må logge inn på nytt.

Fungerer tilkoblingen på mobil?

Hvis du bruker Claude vil tilkoblinger kunne synkroniseres til mobilappen. Med ChatGPT er oppsettet støttet på web og i desktop-appen.

Hva gjør jeg hvis tilkoblingen ikke fungerer?

Prøv følgende:

Slett tilkoblingen og legg den til på nytt.
Sjekk at du bruker riktig URL: https://api.propely.com/mcp
Kontakt support hvis problemet vedvarer.

Hjelp og support

Har du spørsmål eller trenger hjelp med oppsettet? Ta kontakt med oss via chat eller send en e-post til [email protected].

Relaterte artikler

Koble AI-agenter til Propely