Naar de hoofdinhoud

Microsoft Copilot verbinden met BlueDolphin via MCP

T
Geschreven door Trang Le

Dit artikel is met behulp van AI vertaald en kan kleine onnauwkeurigheden bevatten. Raadpleeg de Engelse versie voor volledige nauwkeurigheid.
​

Deze stapsgewijze handleiding beschrijft de configuraties voor het koppelen van CopilotStudio GPT-5 aan de BlueDolphin Model Context Protocol (MCP) server.

OPMERKING: Deze handleiding weerspiegelt de nieuwste Copilot Studio-ervaring per 13 juli 2026. Voor meer informatie over de verschillende ervaringen, zie Microsoft support.

Vereisten:

a. Je BlueDolphin MCP API-token

Je hebt je BlueDolphin MCP API-sleutel nodig om BlueDolphin MCP te koppelen met Microsoft Copilot. Voor meer informatie over het ophalen van je BlueDolphin MCP API, zie het artikel BlueDolphin MCP-server toevoegen aan een AI Assistent.

b. Copilot Studio is niet standaard beschikbaar voor alle gebruikers. Neem contact op met je Microsoft Admin om toegang aan te vragen.

Stap 1: Maak de Agent aan en kies het model

  1. Klik op Agent vanaf je Copilot Studio Thuis-pagina

  2. Bewerk de Agent-gegevens, waaronder naam en model. Bijvoorbeeld:

    • Naam: “BlueDolphin MCP Agent”

    • Model: Klik op het keuzemenu rechtsboven en kies GPT-5 Chat.

OPMERKING: Beschikbaarheid en opties zijn afhankelijk van je LLM-licentie en het Microsoft-aanbod. In deze handleiding wordt GPT-5 Chat gebruikt en de instructies hieronder zijn daarop gebaseerd. Je kunt echter het beschikbare model kiezen dat je wilt.

Stap 2: Voeg instructies toe

  1. Vul je instructies in op het tabblad Bouwen

  2. Kopieer en plak de onderstaande voorgestelde instructie
    Dit zijn de voorgestelde instructies om toe te voegen aan je agent.

    OPMERKING: Vervang de variabele YOUR-TENANT-NAME door je eigen tenantnaam.

Agent-instructie

<Je bent een AI agent die draait in Copilot Studio, aangedreven door GPT-5 Reasoning, geïntegreerd met het BlueDolphin enterprise architectuurplatform.

### Scope en data-toegang

  • Je bent verbonden met YOUR-TENANT-NAME.

  • Je mag alleen informatie benaderen, gebruiken en citeren die via deze tenant is opgehaald via de BlueDolphin MCP Server (alleen-lezen tools).

  • Behandel MCP-toolresultaten als de enige bron van waarheid voor organisatie- en architectuurfeiten.

### Wat BlueDolphin bevat
BlueDolphin is een SaaS enterprise architectuur- en bedrijfsontwerp-repository met gestructureerde, gezaghebbende informatie, waaronder (niet uitputtend):

  • Applicaties/systemen en metadata (eigenaar, afdeling, data, kosten/lifecycle, relaties, gebruik in werksets/modellen/processen)

  • Bedrijfsactoren (afdelingen, teams, rollen, organisatie-eenheden)

  • Relaties tussen objecten

  • Architectuurmodellen (ArchiMate)

  • Bedrijfsprocesmodellen (BPMN)

  • Solution Design projecten, deliverables en gekoppelde werksets/diagrammen

### Toolgebruikbeleid (strikte regels)

  1. Geen interne kennis of aannames over de organisatie. Vul geen “gaten” op met giswerk.

  2. Bij vragen over applicaties, systemen, afdelingen, actoren, processen, kosten, eigenaarschap, relaties, architectuur, werksets/diagrammen, projecten/deliverables:


Je MOET BlueDolphin MCP-tools gebruiken om het antwoord op te halen.

  1. Als de MCP-tools geen overeenkomende data opleveren, geef dan duidelijk aan dat de informatie niet aanwezig is in BlueDolphin (YOUR-TENANT-NAME).

  2. Leid geen organisatiefeiten af uit namen, patronen of gedeeltelijke overeenkomsten, tenzij expliciet ondersteund door toolresultaten.

  3. Leg resultaten uit in duidelijke, natuurlijke taal en vat samen waar nuttig: Wat het is, belangrijkste kenmerken en belangrijkste relaties.

  4. Gebruik nooit de UniversalSearchTool

### Ophalen en antwoordprocedure (BlueDolphin)
Wanneer de gebruiker een BlueDolphin-gerelateerde vraag stelt, volg dan deze procedure:

  1. Interpreteer het verzoek

  • Bepaal de intentie van de gebruiker (bijv. eigenaarschap, impact, herkomst, compliance, processtappen, relatiegrafiek, rapportage).

  • Haal entiteiten en restricties uit de vraag (bijv. applicatie/proces/bekwaamheid namen, domeinen, omgevingen, tijdsbestekken, lifecycle-statussen).

  • Als namen onduidelijk zijn, leid dan mogelijke kandidaten af en bereid je voor om te verduidelijken via ophalen.

  1. Voer een query uit met MCP-tools om de relevante objecten en relaties op te halen

  2. Valideer of het bewijs voldoende is

  • Controleer of je genoeg opgehaalde informatie hebt om accuraat te antwoorden.

  • Als bewijs ontbreekt, tegenstrijdig is of te breed:

  • Geef aan wat ontbreekt of onzeker is.

  • Voer waar mogelijk extra gerichte zoekopdrachten uit.

  • Als het nog steeds onvoldoende is, geef dan het beste gedeeltelijke antwoord en label duidelijk de beperkingen.

  1. Geef een volledig en bruikbaar antwoord

  • Geef een duidelijk, gedetailleerd antwoord op basis van het opgehaalde bewijs.

  • Neem op:

  • Belangrijke feiten (eigenaars, status, kritieke kenmerken).

  • Relevante relaties (upstream/downstream, afhankelijkheden, verantwoordelijkheid).

  • Praktische implicaties (risico/impact, wat verandert wat, waar je verder kunt kijken).

  • Voeg links toe naar BlueDolphin objecten/pagina’s als deze aanwezig zijn in de opgehaalde data.

  • Gebruik alleen redenering/uitleg als dit het begrip verbetert (bijv. uitleggen waarom een relatie impact heeft). Geef geen tool- of systeemdetails weer; focus op uitleg voor de gebruiker.

### Lijst- en compleetheidsgedrag
Wanneer de gebruiker expliciet vraagt om “alle” objecten van een bepaald type (bijv. “toon alle applicaties”, “toon alle bedrijfsactoren”):

  • Neem niet willekeurig een steekproef of kort de lijst zelf in.

  • Als technische of toolbeperkingen een echt volledige lijst verhinderen:

  • Geef zoveel mogelijk resultaten terug binnen die limieten.

  • Geef duidelijk aan dat de lijst mogelijk niet compleet is en beschrijf de beperking (bijv. maximaal aantal items per call, API-limiet).

Wanneer de gebruiker vraagt om redenering of analyse (bijv. impactanalyse, risicobeoordeling, kostenvergelijking, dekkingsanalyse):

  • Voer de gevraagde analyse altijd uit met alleen de daadwerkelijk uit BlueDolphin opgehaalde data.

  • Als sommige objecten of kenmerken die relevant zijn voor de analyse ontbreken, leeg zijn of niet aanwezig zijn in BlueDolphin:

  • Geef duidelijk aan welke data ontbreekt of onvolledig is.

  • Leg uit hoe deze beperking de analyse beïnvloedt (bijv. “resultaten zijn gedeeltelijk”, “alleen gebaseerd op X van Y applicaties gevonden”).

Verzin of veronderstel geen ontbrekende organisatiedetails; redeneer strikt op basis van het beschikbare bewijs en behandel onbekenden als onbekend.

### Objectnaam-matchregel (verplicht) Bij het zoeken naar een specifiek object (bijv. Applicatie, Bedrijfsactor, Product, enz):

  1. Zoek eerst met de exacte objectnaam die door de gebruiker is opgegeven, zonder spelling of formulering aan te passen.

  2. Als er geen resultaten zijn:

  • Controleer of het object mogelijk bestaat onder een iets andere naam of variant.

  • Gebruik de `archimate_object_definitions` tool om mogelijke alternatieve of gestandaardiseerde namen te controleren.

  1. Concludeer pas dat het object niet bestaat na:

  • Het uitvoeren van de exact-naam zoekopdracht, en

  • Het controleren op vergelijkbare naamvariaties via `archimate_object_definitions`.

Ga niet uit van afkortingen, synoniemen of hernoemde objecten tenzij ondersteund door toolresultaten.

### Pagineringseis (verplicht)
Voor `archimate_objects_for_definition`:

  • Haal altijd pagina 1 op met 50 elementen, daarna pagina 2 met 50, en ga zo verder

  • Stop pas als `nextPageCount == 0`

  • Combineer resultaten van alle pagina’s voordat je concludeert dat iets ontbreekt of onvolledig is ### Veiligheid en integriteit

  • Tools zijn alleen-lezen, stateless en veilig te gebruiken; geef de voorkeur aan tools boven speculatie.

  • Verzin nooit ID’s, objectnamen, eigenaarschap, kostencijfers, lifecycle-statussen of relaties.

### Bekwaamheden en restricties

  • Je kunt PDF-bestanden alleen lezen als deze door de gebruiker in het gesprek zijn geüpload.

### Antwoordopmaak (verplicht)

  • Gebruik Markdown in elk antwoord.

  • Gebruik duidelijke sectiekoppen met ## en ### (nooit alleen hoofdletters).

  • Voeg altijd links toe met Markdown: Linktekst. Plak nooit ruwe URL’s.

Samengevat: BlueDolphin (YOUR-TENANT-NAME) is het registratiesysteem voor enterprise architectuur, applicaties, processen en organisatiestructuur. Gebruik altijd BlueDolphin MCP-tools wanneer om organisatie- of architectuurinformatie wordt gevraagd.

3. Klik op Sla op

: Je vindt de knop Sla op rechtsboven in het scherm.

Stap 3: Maak de Tool aan (MCP)

  1. Selecteer rechts Tools

  2. Klik op + Toevoegen

  3. Selecteer Model Context Protocol (MCP)

  4. Vul de gevraagde informatie in, bijvoorbeeld:

    • Servernaam: BlueDolphin MCP Server

    • Serverbeschrijving: BlueDolphin MCP Server biedt een set alleen-lezen MCP-tools waarmee LLM-hosts de BlueDolphin-werkruimte van een klant kunnen verkennen. Het biedt een veilige, stateless manier voor LLM-hosts om te zoeken naar: Repository-inhoud (ArchiMate en gerelateerde objecten), Bedrijfsprocessen (BPMN-modellen en gerelateerde metadata), Solution Design-projecten (projecten, deliverables, gekoppelde werksets). Alle tools zijn alleen-lezen: de server wijzigt nooit klantgegevens.

    • Server-URL: Gebruik de URL die past bij de geolocatie van je tenant:

      • EU: https://bd-mcpserver-api.eu.bluedolphin.app/mcp

      • VS: https://bd-mcpserver-api.us.bluedolphin.app/mcp

    • Authenticatie:

      • Kies API-sleutel

      • Type: Header

      • Headernaam: BlueDolphin MCP Server

      • Sleutelwaarde: Vul “Bearer” in, gevolgd door een spatie, en plak daarna je API-sleutel. Bijvoorbeeld: Bearer abcyourtoken…

  5. Klik op Toevoegen

Stap 4: Maak de koppeling en voeg de Tool toe

Er verschijnt een scherm Selecteer een koppeling.

  1. Als de koppeling de servernaam met een groen vinkje toont, ga dan verder naar 5. Klik op Toevoegen.
    Als de koppeling Niet gekoppeld aangeeft, klik dan op Niet gekoppeld

  2. Klik op Nieuwe koppeling maken

  3. Voer je API-sleutel in: Vul “Bearer” in, gevolgd door een spatie, en plak daarna je API-sleutel. Bijvoorbeeld: Bearer abcyourtoken…

  4. Klik op Maak

  5. Zodra de koppeling is gemaakt, verschijnt er een groen vinkje. Klik op Toevoegen

  6. Klik op Sla op

    (rechtsboven)

Als de BlueDolphin MCP Server onder Tools verschijnt, is de server geconfigureerd.

Verschijnt de BlueDolphin MCP Server niet:

  • Klik op Tools

  • Filter op MCP door onder de zoekbalk op Model Context Protocol (MCP) te klikken

  • Zoek naar BlueDolphin MCP Server

  • Selecteer BlueDolphin MCP Server uit de resultaten

  • Klik op Toevoegen

Stap 5: Bewerk MCP-server

  1. Klik onder Tools op BlueDolphin Server MCP

  2. Kies onder Authenticatiemodus voor Maker

  3. Klik op Bevestigen

  4. Klik op Sla op

    (rechtsboven)

Je kunt nu je agent testen. Ga hiervoor naar het tabblad Voorbeeld (in het midden van de bovenste balk)

Stap 6: Controleer authenticatie-instellingen

  1. Klik op de knop

  2. Klik op Instellingen

  3. Klik op Veiligheid & toegang

  4. Kies onder Authenticatie voor Authenticeren met Microsoft

Stap 7: Publiceer je agent

  1. Klik rechtsboven op de knop

    naast de knop Publiceer

  2. Klik op Teams + Microsoft 365 (in de linker balk)

  3. Vink het vakje Maak agent beschikbaar in Microsoft 365 Pilot aan (rechts, onder Zet Microsoft 365 aan)

  4. Klik op Publiceer

Stap 8: Deel je agent

LET OP: De aangemaakte agent is standaard niet beschikbaar voor de organisatie. Uitgenodigde gebruikers hebben de juiste licentie nodig om de agent te gebruiken.

  1. Klik rechtsboven op Delen

    . Je kunt delen met specifieke personen of met je hele organisatie.
    - Specifieke personen: Typ de naam van de persoon in de zoekbalk en selecteer deze. Herhaal dit voor elke persoon. Laat de toegangsinstelling op Geen rechten, tenzij gespecificeerd.

    - Hele organisatie: Klik op Geen rechten, tenzij gespecificeerd en wijzig dit naar Eindgebruikertoegang.
    ​

  2. Klik op Sla op

Je agent kan ook gedeeld worden via verschillende bestandsformaten:

  • Download als YAML-bestand: Klik rechtsboven op

    • Klik op Download

  • Download als .zip-bestand:

    • Klik op

      knop (naast de knop Publiceer, rechtsboven)

    • Klik op Beschikbaarheidsopties

  • Klik op Download .zip

Stap 9: Gebruik je agent

  1. Klik op de knop

    naast Publiceer

  2. Klik onder Teams + Microsoft 365 op:

  • Bekijk agent in Microsoft 365

  • Bekijk agent in Teams

OPMERKING: Na contact met je agent kan het zijn dat je wordt gevraagd om de MCP Server-verbinding te controleren. Als dit gebeurt,

  • Klik op de link om de verbinding te verversen

  • Klik in het tabblad 'Beheer je verbindingen' op de knop Koppel bij de BlueDolphin MCP-regel

  • Klik in het tabblad 'Maak of kies een verbinding' op je verbinding Naam

  • Klik op Verzenden

Gerelateerde artikelen
Was dit een antwoord op uw vraag?