Gå til hovedinnhold

Koble AI-agenter til Propely

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).

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

  1. Gå til claude.ai eller åpne Claude-appen (desktop).

  2. Velg Customize i venstremenyen, og trykk deretter på Connectors.

  3. Klikk + og deretter Add custom connector.

  4. Skriv inn følgende URL: https://api.propely.com/mcp

  5. Trykk Connect for å verifisere med din Propely-bruker.

  6. Du blir sendt til Propely sin innloggingsside. Logg inn med din vanlige Propely-bruker.

  7. 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.

  1. Åpne en ny samtale i Claude

  2. Klikk +-knappen i meldingsfeltet

  3. Velg Connectors

  4. Slå på Propely-koblingen

  5. 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

  1. Gå til chatgpt.com eller åpne ChatGPT-appen.

  2. Gå til Settings → Apps & Connectors.

  3. Velg Advanced settings og slå på Developer Mode.

  4. Bekreft advarselen som vises.

Legge til Propely som tilkobling

  1. Gå til Settings → Apps & Connectors, og velg Add new connector.

  2. Lag et navn for tilkoblingen, for eksempel Propely.

  3. Skriv inn følgende URL: https://api.propely.com/mcp

  4. Sett autentisering til OAuth.

  5. Kryss av for I trust this application og trykk Create.

  6. Du blir sendt til Propely sin innloggingsside. Logg inn med din vanlige Propely-bruker. Etter innlogging er tilkoblingen klar.

Andre AI-klienter

Microsoft Copilot Studio

Det er også mulig å koble Propely til en agent i Microsoft Copilot Studio via MCP. Dette oppsettet er rettet mot enterprise-brukere og krever konfigurasjon gjennom Power Platform. Se Microsofts dokumentasjon om MCP i Copilot Studio for veiledning. MCP-URLen er den samme: https://api.propely.com/mcp

Merk: Propely har ikke verifisert oppsettet for Copilot Studio. Ta kontakt med oss hvis du trenger hjelp.

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:

  1. Slett tilkoblingen og legg den til på nytt.

  2. Sjekk at du bruker riktig URL: https://api.propely.com/mcp

  3. 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].

Svarte dette på spørsmålet?