> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watchdog.no/llms.txt
> Use this file to discover all available pages before exploring further.

# Koble til Microsoft Copilot

> Koble Watchdog til Microsoft 365 Copilot med OAuth og PKCE.

Sjekk [tilgjengelighet og rettigheter](https://docs.watchdog.no/no/guides/mcp) før du setter opp tilkoblingen.
Denne veiledningen gjelder jobb- og skolekontoer i Microsoft 365.

## Velg oppsett

Bruk **direkte tilkobling** for å jobbe med Watchdog i den vanlige chatten i Microsoft 365 Copilot.
Dette er det anbefalte utgangspunktet: Microsoft-administratoren setter opp koblingen én gang for
organisasjonen, og hver person logger inn med sin egen Watchdog-konto.

Velg en [Copilot Studio-agent](#copilot-studio-agent) når dere vil bygge en egen assistent med egne
instruksjoner, andre verktøy eller en agent i Teams. Studio krever ett ekstra steg med Watchdogs
kundestøtte før noen kan logge inn.

Med begge oppsettene kan Copilot slå opp og oppsummere Watchdog-dataene deres; endringer gjør dere
i Watchdog. Før dere starter, send e-post til [support@watchdog.no](mailto:support@watchdog.no)
for å få klienthemmeligheten. Vi sender den som en engangslenke. Hold den privat.

## Direkte tilkobling i Microsoft 365

Administratoren trenger tilgang til [Teams Developer Portal](https://dev.teams.microsoft.com)
og rollen **Global Administrator** eller **AI Administrator** i Microsoft 365. Se Microsofts
[krav til koblinger](https://learn.microsoft.com/en-us/microsoft-365/copilot/connectors/set-up-custom-federated-connectors).

**1. Registrer innlogging i Teams Developer Portal**

Gå til **Tools** → **OAuth client registration**, registrer en ny klient med feltene under, og
velg **Save**.

| Felt | Verdi |
| - | - |
| Name | `Watchdog` |
| Base URL | `https://mcp.watchdog.no/mcp/readonly` |
| Restrict usage by org | **My organization only** |
| Restrict usage by app | **Any Teams app** |
| Client ID | `r2AOuLXBI3houBrk` |
| Client secret | Fra support |
| Authorization endpoint | `https://clerk.watchdog.no/oauth/authorize` |
| Token endpoint | `https://clerk.watchdog.no/oauth/token` |
| Refresh endpoint | `https://clerk.watchdog.no/oauth/token` |
| Scopes | `watchdog offline_access` |
| PKCE | På |

**Restrict usage by app** må være **Any Teams app**. Ellers feiler alle forespørsler til
Watchdog.

Bruk samme Base URL i neste steg.

> [!WARNING]
>
> Copilot støtter foreløpig bare lesehandlinger, så du må bruke
> `https://mcp.watchdog.no/mcp/readonly`, ikke `https://mcp.watchdog.no/mcp`.

Kopier **OAuth client registration ID** som Microsoft viser. Dette er Microsofts ID, ikke
Watchdogs klient-ID over.

**2. Legg til koblingen i Microsoft 365-administrasjonssenteret**

I [administrasjonssenteret](https://admin.microsoft.com) går du til **Copilot** →
**Connectors** → **Gallery**. Under **Created by your org** velger du **Add** på **Create a new
connector**, og deretter **Add** under **Connect to MCP server**. Fyll ut feltene under, og velg
**Save**.

| Felt | Verdi |
| - | - |
| Display name | `Watchdog` |
| Base URL | `https://mcp.watchdog.no/mcp/readonly` |
| Authentication | **OAuth 2.0** |
| OAuth registration ID | Fra forrige steg |
| Developer name | `Watchdog` |
| Website URL | `https://docs.watchdog.no/guides/mcp` |
| Privacy policy URL | `https://watchdog.no/legal/privacy` |
| Terms of use URL | `https://watchdog.no/legal/terms` |

Bruk **Staged rollout** for å gjøre koblingen tilgjengelig for en liten gruppe først. Det kan ta
opptil 15 minutter før endringer trer i kraft.

**3. Logg inn og test**

Hver person åpner Microsoft 365 Copilot Chat, går til **…** → **Settings** → **Sources**, velger
**Connect** ved **Watchdog**, og logger inn med sin egen Watchdog-konto. Administratorens oppsett
gir ingen tilgang til administratorens data.

Hvis Microsoft viser flere kontoer, velg den du bruker i Watchdog, ikke en admin-konto. Bruk
**Connect** i Copilot Chat; **Sign in**-knappen under **Tools** i administrasjonssenteret
fungerer ikke for alle koblinger.

Prøv en [eksempeloppgave](https://docs.watchdog.no/no/guides/mcp/working-with-watchdog.md) før dere ruller ut videre.

Hvis Copilot finner Watchdog, men ikke får hentet data, sjekker dere at begge stegene bruker
`https://mcp.watchdog.no/mcp/readonly`, og kobler fra og til igjen i Copilot Chat.

## Copilot Studio-agent

Du trenger en agent i [Copilot Studio](https://copilotstudio.microsoft.com) med
[generativ orkestrering](https://learn.microsoft.com/en-us/microsoft-copilot-studio/advanced-generative-actions#turn-on-generative-orchestration-for-an-agent)
slått på, og en Microsoft-administrator som kan publisere den (se
[lisenser](https://learn.microsoft.com/en-us/microsoft-copilot-studio/faq-billing-licensing)).
Studio bruker samme klient-ID og klienthemmelighet som den direkte tilkoblingen.

**1. Legg til Watchdog som verktøy**

I agenten går du til **Tools** → **Add a tool** → **New tool** → **Model Context Protocol**,
fyller ut feltene under og velger **Create**.

| Felt | Verdi |
| - | - |
| Server name | `Watchdog` |
| Server description | `Invoices, agreements and price checks in Watchdog` |
| Server URL | `https://mcp.watchdog.no/mcp/readonly` |
| Authentication | **OAuth 2.0**, type **Manual** |
| Client ID | `r2AOuLXBI3houBrk` |
| Client secret | Fra support |
| Authorization URL | `https://clerk.watchdog.no/oauth/authorize` |
| Token URL template | `https://clerk.watchdog.no/oauth/token` |
| Refresh URL | `https://clerk.watchdog.no/oauth/token` |
| Scopes | `watchdog offline_access` |

> [!WARNING]
>
> Copilot støtter foreløpig bare lesehandlinger, så du må bruke
> `https://mcp.watchdog.no/mcp/readonly`, ikke `https://mcp.watchdog.no/mcp`.

**2. Send callback-adressen til support**

Når du har valgt **Create**, viser Copilot Studio en **callback URL**. Den ser ut som
`https://global.consent.azure-apim.net/redirect/...` og er unik for dette verktøyet. Kopier hele
adressen og send den til [support@watchdog.no](mailto:support@watchdog.no).

Hvis du har lukket dialogen, åpner du [Power Apps](https://make.powerapps.com) i samme miljø,
går til **Custom connectors**, åpner Watchdog-koblingen og kopierer **Redirect URL** på fanen
**Security**.

Vent til support bekrefter at adressen er registrert. Frem til da feiler innloggingen med
«The 'redirect\_uri' parameter does not match any of the OAuth 2.0 Client's pre-registered
redirect urls». Hvis du sletter og lager verktøyet på nytt, eller legger det til i et annet
miljø eller en annen agent, får det en ny callback-adresse som du også må sende.

**3. Koble til**

Velg **Next** → **Create a new connection**, logg inn i Watchdog, og velg **Add to agent**.
Sett verktøyet til [**User authentication**](https://learn.microsoft.com/en-us/microsoft-copilot-studio/configure-enduser-authentication),
slik at hver person logger inn med sin egen Watchdog-konto.

**4. Test og publiser**

Prøv en [eksempeloppgave](https://docs.watchdog.no/no/guides/mcp/working-with-watchdog.md), og
[publiser agenten](https://learn.microsoft.com/en-us/microsoft-copilot-studio/publication-add-bot-to-microsoft-teams)
til Teams eller Microsoft 365 Copilot. For Teams må du også [sette opp enkel pålogging](https://learn.microsoft.com/en-us/microsoft-copilot-studio/configure-sso-teams);
uten det feiler innloggingen alltid der. Test på nytt i den publiserte agenten før du deler den.

## Koble fra

Microsoft-administratoren kan deaktivere eller slette den direkte tilkoblingen i
administrasjonssenteret, og fjerne verktøyet fra en Copilot Studio-agent. Hver person kan koble
fra den direkte tilkoblingen i Copilot Chat under **Settings** → **Sources**.
Se [Koble fra](https://docs.watchdog.no/no/guides/mcp#koble-fra) for å trekke tilbake Watchdog-tilgangen din,
eller [hjelp med tilkoblingen](https://docs.watchdog.no/no/guides/mcp/troubleshooting.md) hvis du står fast.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.