Sette opp Econex MCP i Microsoft Copilot

Denne guiden beskriver hvordan Econex MCP kan kobles til Microsoft Copilot-miljøer. Microsoft har flere Copilot-flater, så riktig oppsett avhenger av om du skal gjøre data tilgjengelig i Microsoft 365 Copilot for en tenant, eller i en egen agent bygget i Copilot Studio.

Velg riktig Copilot-oppsett

• Microsoft 365 Copilot connector: bruk dette når Econex-data skal bli tilgjengelig for brukere i Microsoft 365 Copilot, Copilot-appen eller Researcher-agenten.
• Copilot Studio-agent: bruk dette når du bygger en egen agent med bestemte instrukser, avgrenset målgruppe og kontrollert verktøybruk.
• GitHub Copilot i VS Code er en egen teknisk flate. Den bruker VS Code sin mcp.json-konfigurasjon og er mest relevant for utviklerverktøy, ikke sluttbrukerrapportering.

Forutsetninger

• Econex MCP-server-URL fra Econex.
• Avklart autentisering: Microsoft Entra SSO, OAuth 2.0 eller API-nøkkel, avhengig av valgt Copilot-flate.
• Adminrettigheter i Microsoft 365 admin center for tenant-bred connector.
• Tilgang til Copilot Studio hvis du skal bygge eller endre en agent.
• En MCP-server som eksponerer lesebaserte verktøy og beskrivelser som gjør det tydelig når Copilot skal bruke dem.

MCP URL

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

Alternativ 1: Microsoft 365 Copilot connector

For tenant-bred bruk opprettes en custom federated connector i Microsoft 365 admin center. Denne modellen passer når brukere skal kunne spørre Microsoft 365 Copilot om Econex-data uten å bygge en separat Copilot Studio-agent.

1. Logg inn i Microsoft 365 admin center med Global Administrator eller AI Administrator-rolle.
2. Gå til Copilot > Connectors.
3. Åpne Gallery-fanen og velg Create a new connector under Created by your org.
4. Under Connect to MCP server velger du Add.
5. Legg inn et tydelig display name, for eksempel Econex MCP.
6. Legg inn base-URL-en til MCP-serveren du har fått fra Econex.
7. Legg inn registrerings-ID for valgt autentisering, for eksempel Microsoft Entra SSO eller OAuth 2.0.
8. Lagre connectoren, test med et avgrenset brukerutvalg, og rull deretter ut til flere brukere når tilgang og svar er verifisert.

Alternativ 2: Copilot Studio-agent

Copilot Studio passer når du vil lage en egen agent for drift, energioppfølging eller rapportering. Agenten kan få instrukser om hvilke bygg, perioder og rapportformater den skal prioritere.

1. Åpne agenten i Copilot Studio og kontroller at generative orchestration er aktivert.
2. Gå til Tools-siden for agenten.
3. Velg Add a tool, deretter New tool og Model Context Protocol.
4. Fyll inn server name, server description og server URL. Beskrivelsen bør forklare at Econex MCP gir lesetilgang til bygg-, energi- og driftsdata.
5. Velg autentiseringstype: None, API key eller OAuth 2.0. For produksjon bør tilgang styres per bruker eller organisasjon.
6. Opprett connection og legg MCP-serveren til agenten.
7. Test agenten med konkrete spørsmål før den publiseres til sluttbrukere.

Hvis du bruker GitHub Copilot i VS Code

I VS Code kan MCP-servere legges i brukerprofilen eller i et workspace. Ikke legg hemmeligheter direkte i repoet. Bruk input variables eller miljøfiler for nøkler.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "econexToken",
      "description": "Econex MCP token",
      "password": true
    }
  ],
  "servers": {
    "econex": {
      "type": "http",
      "url": "https://sd.econex.no/api/mcp/portfolio",
      "headers": {
        "Authorization": "Bearer ${input:econexToken}"
      }
    }
  }
}

Sikkerhet og avgrensning

• Gi bare tilgang til prosjekter og bygg brukeren faktisk skal se.
• Hold Econex MCP lesebasert for rapportering og analyse.
• Test med staged rollout før tenant-bred utrulling.
• Kontroller at verktøybeskrivelsene er presise, slik at Copilot bare kaller Econex når spørsmålet faktisk handler om bygningsdata.

Videre lesing

Se Microsofts dokumentasjon for custom federated connectors, Copilot Studio MCP-oppsett og VS Code MCP-konfigurasjon for detaljer om gjeldende krav.