Econex MCP

Econex MCP kobler AI-verktøy til Econex-data gjennom Model Context Protocol (MCP). Hva AI-verktøyet kan se og gjøre, styres av rettighetene brukeren har i Econex. Vanlig oppsett er lesetilgang for analyse og rapportering. Denne dokumentasjonsseksjonen samler oppsettguider for ChatGPT, Claude og Microsoft Copilot.

Dokumentasjonen er et arbeidsverktøy under utvikling. Menyvalg i ChatGPT, Claude og Copilot endres ofte. Guidene ble kontrollert mot leverandørenes egen dokumentasjon 5. oktober 2026.

MCP URL

https://sd.econex.no/api/mcp/portfolio
Econex MCP bruker OAuth med dynamisk klientregistrering. I ChatGPT, Claude, Copilot Studio og VS Code skal du normalt bare lime inn URL-en over og velge OAuth. Du skal ikke fylle inn Client ID eller Client Secret; klienten registrerer seg selv hos Econex. Unntaket er Microsoft 365 Copilot-connector i admin center, som krever en Client ID og Client Secret fra Econex.

Dette må Econex-administrator gjøre først

Før brukeren kobler til et AI-verktøy, må en administrator i Econex gi brukeren MCP-rettigheter. Uten disse får brukeren ikke godkjent koblingen, eller koblingen viser ingen verktøy.

  1. På brukerens medlemskap i organisasjonen: gi rettigheten mcp.portfolio.connect (Koble til porteføljeassistent). Uten denne får brukeren 0 verktøy.
  2. På hvert prosjekt brukeren skal se gjennom MCP: gi mcp.project.connect (Koble MCP til prosjektet) og mcp.project.read (Les prosjektdata gjennom MCP).
  3. På prosjekter med medlemsbegrensning må de samme rettighetene også ligge i brukerens egen begrensning. Ellers blir prosjektet ikke synlig via MCP, selv om brukeren har rettighetene på organisasjonsnivå.
  4. Gi bare tilgang til prosjektene brukeren faktisk skal bruke i AI-verktøyet.

Med lesetilgang får brukeren lesebaserte verktøy, blant annet for prosjekter og byggstruktur, alarmer, energi, komfort og ventilasjon, spjeld, rå telemetri og kalendere. Brukeren ser bare data fra prosjekter der rettighetene er gitt.

mcp.project.operate og mcp.project.configure gir AI-verktøyet mulighet til å styre og konfigurere anlegg via MCP, for eksempel endre driftsmodus eller settpunkter. Ikke gi disse rettighetene for vanlig rapportering og analyse.

Slik fungerer innloggingen

  1. Du legger til MCP-URL-en i AI-verktøyet og velger OAuth.
  2. AI-verktøyet registrerer seg automatisk hos Econex og åpner siden «Koble til Econex» i nettleseren.
  3. Er du ikke innlogget i Econex i den nettleseren, klikker du «Logg inn i Econex» og logger inn som vanlig.
  4. Kontroller at riktig organisasjon er valgt i Econex. Koblingen knyttes til organisasjonen som er valgt når du godkjenner.
  5. Klikk «Godkjenn tilgang». Du sendes tilbake til AI-verktøyet, som nå kan hente verktøylisten.

Teknisk bruker Econex OAuth authorization code med PKCE (S256), dynamisk klientregistrering og scopene mcp:portfolio og offline_access. Tilgangstokenet varer i én time og fornyes automatisk med et oppdateringstoken, så brukeren skal normalt ikke måtte logge inn på nytt. Metadata ligger på https://sd.econex.no/.well-known/oauth-protected-resource/api/mcp/portfolio med issuer https://sd.econex.no.

Før du starter

  • Avklar hvilke Econex-prosjekter og bygg brukeren skal ha tilgang til, og få Econex-administrator til å gi rettighetene over.
  • Avklar hvilken klient som skal brukes, og om du har riktig plan og rolle der. Se guiden for hver klient.
  • Ha Econex-innloggingen klar i samme nettleser som AI-verktøyet åpner.
  • Start med ett avgrenset bygg og korte tidsperioder når du tester oppsettet.

Oppsettguider

Les ChatGPT-guiden hvis du skal legge Econex MCP til som egendefinert MCP-server (app) i ChatGPT, personlig eller for et Business-, Enterprise- eller Edu-workspace.

Les Microsoft Copilot-guiden hvis du skal bruke Econex MCP i en Copilot Studio-agent, som Microsoft 365 Copilot-connector eller med GitHub Copilot i VS Code.

Les Claude-guiden hvis du skal legge Econex MCP til som custom connector i Claude (web, Desktop og mobil) eller i Claude Code.

Sikkerhetsmodell

Econex MCP skal brukes med minste nødvendige tilgang. AI-verktøyet får aldri flere rettigheter enn brukeren har i Econex, og hvert kall sjekkes mot rettighetene på nytt. Gi lesetilgang for analyse og rapportering. Styring og konfigurasjon av anlegg via MCP krever egne rettigheter og bør bare gis når det er et bevisst valg.

Du stopper en kobling ved å koble fra Econex i AI-verktøyet. Administrator kan også fjerne MCP-rettighetene i Econex, slik at koblingen ikke lenger gir tilgang.