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 SettingsApps & Connectors.

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

  4. Bekreft advarselen som vises.

Legge til Propely som tilkobling

  1. Gå til SettingsApps & 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?