Sette opp Econex MCP i Microsoft Copilot

Denne guiden beskriver hvordan Econex MCP kobles til Microsoft Copilot-miljøer. Microsoft har flere Copilot-flater, og oppsettet er forskjellig for en Copilot Studio-agent, en tenant-bred Microsoft 365 Copilot-connector og GitHub Copilot i VS Code.

Stegene følger Microsoft Learn og VS Code-dokumentasjonen per oktober 2026. Microsoft endrer MCP-støtten fortløpende. Avklar lisens- og tenantkrav med Microsoft 365-administrator.

Velg riktig Copilot-oppsett

  • Copilot Studio-agent (anbefalt start): en egen agent med instrukser, avgrenset målgruppe og Econex MCP som verktøy. Fungerer med Econex sin automatiske OAuth-registrering, uten Client ID.
  • Microsoft 365 Copilot-connector (custom federated connector): gjør Econex-data tilgjengelig i Microsoft 365 Copilot for brukere i tenanten. Krever Client ID og Client Secret som Econex må utstede.
  • GitHub Copilot i VS Code: for utviklere og tekniske brukere. Konfigureres i mcp.json og bruker OAuth automatisk.

Forutsetninger

  • En Econex-bruker med MCP-rettigheter. Se «Dette må Econex-administrator gjøre først» på oversiktssiden for Econex MCP.
  • Copilot Studio: tilgang til å bygge og redigere agenten i Copilot Studio.
  • Microsoft 365 Copilot-connector: Global Administrator eller AI Administrator i Microsoft 365 admin center, og tilgang til Teams Developer Portal.
  • Econex bruker egen innlogging (issuer https://sd.econex.no). Microsoft Entra SSO kan derfor ikke brukes mot Econex MCP; velg OAuth 2.0.

MCP URL

https://sd.econex.no/api/mcp/portfolio

Alternativ 1: Copilot Studio-agent

Copilot Studio passer når du vil lage en egen agent for drift, energioppfølging eller rapportering. Copilot Studio støtter MCP over Streamable HTTP, som Econex bruker. Bruk MCP onboarding wizard:

  1. Åpne agenten i Copilot Studio og gå til Tools-siden.
  2. Velg Add a tool, deretter New tool.
  3. Velg Model Context Protocol. MCP onboarding wizard åpnes.
  4. Fyll inn Server name (for eksempel Econex MCP), Server description og Server URL (https://sd.econex.no/api/mcp/portfolio). Beskrivelsen brukes til å avgjøre når agenten skal kalle Econex, så skriv for eksempel: Henter bygg-, energi-, alarm- og driftsdata fra Econex for prosjektene brukeren har tilgang til.
  5. Velg OAuth 2.0 som autentiseringstype.
  6. Velg Dynamic discovery som type. Econex støtter dynamisk klientregistrering med discovery, så du fyller ikke inn Client ID, Client Secret eller endepunkter.
  7. Velg Create, deretter Next. Dialogen Add tool åpnes.
  8. Velg Create a new connection. Logg inn i Econex i vinduet som åpnes, kontroller at riktig organisasjon er valgt, og klikk «Godkjenn tilgang».
  9. Velg Add to agent.
  10. Test agenten med konkrete spørsmål før den publiseres til sluttbrukere.
Microsoft Copilot Studio MCP onboarding wizard
Eksempel fra Microsoft Learn: MCP onboarding wizard i Copilot Studio. Server URL-feltet fylles med Econex MCP URL-en.
Microsoft Copilot Studio MCP onboarding med OAuth 2.0 Dynamic discovery valgt
Eksempel fra Microsoft Learn: OAuth 2.0 med Dynamic discovery. Dette er riktig valg for Econex MCP.

MCP-tilgang i Copilot Studio går via Power Platform-connectorer. Hvis organisasjonen har datapolicyer (DLP) for connectorer, gjelder de også Econex MCP.

Alternativ 2: Microsoft 365 Copilot-connector

En custom federated connector gjør Econex-data tilgjengelig i Microsoft 365 Copilot uten en egen Copilot Studio-agent. Microsoft krever at MCP-serveren eksponerer lesebaserte verktøy, så gi brukerne bare lesetilgang i Econex. Denne flaten bruker ikke dynamisk klientregistrering. Du må derfor få en Client ID og Client Secret fra Econex først.

Steg 1: Be Econex om en OAuth-klient

Kontakt Econex og be om en OAuth-klient for Microsoft 365 Copilot. Oppgi hvilken Econex-organisasjon den gjelder. Econex registrerer klienten med denne redirect-URI-en og gir dere Client ID og Client Secret:

https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect

Steg 2: Registrer OAuth-klienten i Teams Developer Portal

  1. Logg inn i Teams Developer Portal.
  2. Velg Tools > OAuth Client Registration.
  3. Velg + New OAuth connection.
  4. Fyll inn feltene som vist under.
  5. Slå på Proof Key for Code Exchange (PKCE). Econex støtter PKCE med S256.
  6. Velg Save, og kopier OAuth client registration ID som vises.
Name:                    Econex MCP
Client ID:               (fra Econex)
Client secret:           (fra Econex)
Authorization endpoint:  https://sd.econex.no/api/mcp/oauth/authorize
Token endpoint:          https://sd.econex.no/api/mcp/oauth/token
Refresh endpoint:        https://sd.econex.no/api/mcp/oauth/token
Scopes:                  mcp:portfolio offline_access

Steg 3: Opprett connectoren i Microsoft 365 admin center

  1. Logg inn i Microsoft 365 admin center med Global Administrator- eller AI Administrator-rolle.
  2. Velg Copilot > Connectors i venstremenyen.
  3. Velg fanen Gallery.
  4. Under Created by your org finner du flisen Create a new connector og velger Add.
  5. På siden Custom connector, under Connect to MCP server, velger du Add.
  6. Fyll inn Display name (Econex MCP) og Base URL (https://sd.econex.no/api/mcp/portfolio).
  7. Lim inn OAuth registration ID fra Teams Developer Portal.
  8. Velg Save.

Connectoren vises deretter i listen Your Connections. Bruk Staged rollout til å gi den til utvalgte brukere eller grupper først, og Deploy to all users når tilgang og svar er kontrollert. Endringer kan ta opptil 15 minutter. Hver bruker logger inn med sin egen Econex-bruker første gang connectoren brukes.

Microsoft ber også om utviklernavn, nettsted, personvernerklæring og bruksvilkår for MCP-serveren. Be Econex om disse lenkene sammen med OAuth-klienten.

Alternativ 3: GitHub Copilot i VS Code

VS Code støtter OAuth for MCP-servere og starter med dynamisk klientregistrering. Econex støtter dette, så du trenger verken token, Client ID eller headers. Legg til serveren med kommandoen MCP: Add Server, eller i .vscode/mcp.json i workspacet eller mcp.json i brukerprofilen:

{
  "servers": {
    "econex": {
      "type": "http",
      "url": "https://sd.econex.no/api/mcp/portfolio"
    }
  }
}
  • Når serveren startes første gang, åpner VS Code nettleseren. Logg inn i Econex, kontroller organisasjonen og klikk «Godkjenn tilgang».
  • Bruk MCP: List Servers for å se status, starte på nytt eller vise logg.
  • Innloggingsstatus vises i Accounts-menyen. Kommandoen Authentication: Remove Dynamic Authentication Providers fjerner registreringen hvis du vil logge inn på nytt.
  • Ikke legg inn Authorization-header eller oauth.clientId. Econex utsteder ikke personlige API-tokens for MCP.
  • Om MCP-servere er tillatt i GitHub Copilot kan avhenge av organisasjonens Copilot-innstillinger og plan.

Feilsøking

  • Copilot Studio får ikke kontakt: kontroller at URL-en er nøyaktig riktig og at OAuth 2.0 med Dynamic discovery er valgt.
  • Feilmelding på «Koble til Econex» når du klikker «Godkjenn tilgang»: brukeren mangler sannsynligvis mcp.portfolio.connect i den valgte organisasjonen.
  • Tilkoblet, men ingen verktøy eller manglende prosjekter: kontroller mcp.project.connect og mcp.project.read på prosjektene, også i brukerens egen begrensning på prosjekter med medlemsbegrensning.
  • Microsoft 365 Copilot-connector avviser innloggingen: kontroller at Client ID, Client Secret og redirect-URI-en er registrert hos Econex for riktig organisasjon, og at brukeren er medlem av den organisasjonen.
  • Data fra feil organisasjon: fjern tilkoblingen, velg riktig organisasjon i Econex og koble til på nytt.
  • Agenten kaller ikke Econex: gjør Server description mer presis, slik at det er tydelig hvilke spørsmål Econex skal brukes til.

Sikkerhet og avgrensning

  • Gi bare tilgang til prosjekter og bygg brukeren faktisk skal se.
  • Bruk lesetilgang for rapportering og analyse. Rettigheter til styring og konfigurasjon av anlegg via MCP bør ikke gis for vanlig bruk.
  • Test med staged rollout eller et lite antall brukere før tenant-bred utrulling.
  • Del aldri Client Secret i chat eller e-post; lagre den bare i Teams Developer Portal.

Videre lesing

Se Microsofts dokumentasjon for Copilot Studio MCP-oppsett og custom federated connectors, og VS Code-dokumentasjonen for MCP-konfigurasjon og autentisering.