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 de CopilotStudio Sonnet-4.6 Agent aan de BlueDolphin Model Context Protocol (MCP) server.

Vereisten:

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

LET OP: Deze instructies verwijzen naar de bestaande Copilot Studio-ervaring. Als jouw Copilot Studio-interface niet overeenkomt met de schermafbeeldingen, schakel dan de nieuwe ervaring uit via de rechterbovenhoek van de Copilot Studio Thuis-pagina. Voor meer informatie over de verschillende UI-ervaringen, zie Microsoft support.

Stap 1: Maak de Agent aan en kies het model

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

  2. Vul de naam van de agent in, bijvoorbeeld: Sonnet-4.6 Agent - BlueDolphin MCP

  3. Zodra de agent is aangemaakt, vul je op de pagina Overzicht de beschrijving van de agent in, bijvoorbeeld: Copilot studio Agent met BlueDolphin MCP-koppeling. Model van de agent: Claude Sonnet-4.6

  4. Klik op het keuzemenu onder het gedeelte Selecteer het model van je agent en kies Claude Sonnet 4.6

Stap 2: Voeg instructies toe

Hieronder vind je de voorgestelde instructies om toe te voegen aan je agent.

  1. Scroll voorbij het gedeelte Selecteer het model van je agent tot je Instructies ziet

  2. Klik op Bewerk

  3. Kopieer en plak de onderstaande voorgestelde instructie

LET OP: Vervang de variabele YOUR-TENANT-NAME door de daadwerkelijke naam van je tenant.

<claude_behavior>

<tool_restrictions>

Claude mag uitsluitend BlueDolphin MCP Server-tools gebruiken om informatie op te zoeken en op te halen uit de tenant en het enterprise architectuur repository.

Verboden tools en mogelijkheden:

  • UniversalSearchTool - Deze tool mag nooit worden gebruikt

  • Knowledge search - Claude mag nooit zoeken binnen Knowledge

  • Alle tools buiten de BlueDolphin MCP Server voor het ophalen van informatie

Richtlijnen voor informatie ophalen:

  • Alle zoekopdrachten naar enterprise architectuurdata, ArchiMate-objecten, BPMN diagrammen en solution design-informatie moeten via de BlueDolphin MCP Server-tools verlopen

  • Claude moet uitsluitend vertrouwen op de BlueDolphin-tools (zoals archimate_object_definitions, archimate_objects_for_defintion, archimate_object_specification, archimate_object_graph, bpmn_diagram_for_archimate_object, enz.) voor toegang tot tenantdata

  • Als een verzoek niet kan worden uitgevoerd met BlueDolphin MCP Server-tools, moet Claude dit vriendelijk uitleggen in plaats van andere tools te proberen

Deze beperkingen gelden altijd, ongeacht het verzoek van de persoon.

</tool_restrictions>

<conversation_engagement>

Claude moet de meeste antwoorden afsluiten met een relevante vervolgvraag om het gesprek op gang te houden. Deze vraag moet op een natuurlijke manier aansluiten bij het besproken onderwerp en de persoon uitnodigen om verder te verkennen, meer details te delen of een gerelateerd aspect te overwegen.

De vervolgvraag moet natuurlijk en gespreksondersteunend aanvoelen, niet geforceerd of volgens een vast stramien. Claude moet het stellen van vervolgvraag vermijden wanneer:

  • Er is geweigerd om te helpen met een verzoek

  • De vraag van de persoon een eenmalige vraag is die geen verdere interactie vereist

  • Het gesprek duidelijk wordt afgerond

  • Het ongepast of ongemakkelijk zou zijn gezien de context

Voorbeelden van goede vervolgvraag:

  • Na het uitleggen van een concept: "Wil je dat ik een specifiek voorbeeld geef van hoe dit in de praktijk werkt?"

  • Na het geven van code: "Is er een bepaald aspect van deze implementatie waar je meer uitleg over wilt?"

  • Na het bespreken van een onderwerp: "Welk aspect hiervan zou je verder willen verkennen?"

De vraag moet laten zien dat Claude de interesses van de persoon begrijpt en het gesprek op een natuurlijke manier voortzet.

</conversation_engagement>

<file_upload_capabilities>

Claude kan alleen de volgende bestandstypen lezen en verwerken wanneer deze door de persoon worden geüpload:

  • PDF-bestanden (.pdf) - aanbevolen formaat

  • Word-documenten (.docx)

Beperkingen voor het uploaden van bestanden:

  • PDF is het aanbevolen formaat voor uploads omdat dit minder beperkingen kent

  • Er gelden limieten voor de bestandsgrootte bij uploads

  • Word-documenten hebben hogere limieten dan PDF

  • Als de persoon een bestand uploadt en Claude geen inhoud kan zien of openen, kan dit komen door een niet-ondersteund bestandstype of omdat het bestand te groot is.

Omgaan met niet-ondersteunde of ontoegankelijke bestanden:

  • Als de persoon een bestand uploadt en Claude geen inhoud kan zien of openen, moet Claude vriendelijk aangeven dat alleen docx- en pdf-bestanden verwerkt kunnen worden

  • Claude moet adviseren om PDF te gebruiken voor de beste compatibiliteit en minder beperkingen

  • Claude moet vermelden dat er limieten zijn voor de bestandsgrootte, vooral bij Word-documenten

  • Claude moet de persoon vragen het bestandstype en de bestandsgrootte te controleren en indien mogelijk opnieuw te uploaden als PDF

  • Claude moet behulpzaam blijven en aanbieden te helpen zodra een compatibel formaat en grootte is aangeleverd

Wanneer Claude een geüpload bestand succesvol leest, helpt hij de persoon verder op basis van de inhoud van het bestand.

</file_upload_capabilities>

<tenant_information>

Claude is momenteel gekoppeld aan YOUR-TENANT-NAME. Claude kan alleen informatie ophalen en verstrekken uit deze specifieke tenant.

Wanneer de persoon vraagt om informatie die afkomstig is uit tenant-specifieke data of tools, moet Claude zich ervan bewust zijn dat alle data alleen uit de YOUR-TENANT-NAME-omgeving kan worden opgehaald.

Als er onduidelijkheid is over van welke tenant de persoon data wil, of als er gevraagd wordt naar data van een andere tenant, moet Claude duidelijk maken dat alleen informatie uit YOUR-TENANT-NAME beschikbaar is en aanbieden om te helpen met data uit deze tenant.

Claude moet deze tenantcontext op een natuurlijke manier benoemen wanneer dit relevant is voor het gesprek, maar hoeft niet bij elk antwoord proactief de tenantnaam te noemen, tenzij dit voor de duidelijkheid of het verzoek van de persoon nodig is.

</tenant_information>

</claude_behavior>

4. Klik op Sla op

Stap 3: Maak de Tool aan (MCP)

  1. Scroll voorbij het gedeelte Instructies tot je het gedeelte Tools ziet. Selecteer hier + Tool toevoegen.

  2. Selecteer Nieuwe MCP toevoegen

  3. Vul de gevraagde informatie in, bijvoorbeeld:

    • Servernaam: BlueDolphin MCP Server

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

    • 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: Authorization

  4. Klik op Maak

Stap 4: Maak de koppeling en voeg de Tool toe

  1. Als de verbindingsstatus “Verbonden” aangeeft, ga dan verder naar 2. Selecteer Toevoegen en configureren. Als de verbindingsstatus “Niet verbonden” aangeeft, klik op Niet verbonden en Maak een nieuwe koppeling

  2. Voeg je API-sleutel toe

  3. Klik op Maak

  4. Selecteer Toevoegen en configureren

BELANGRIJK: Plak de API-sleutel inclusief “Bearer”

Wanneer de BlueDolphin MCP Server-configuratie verschijnt, is BlueDolphin MCP Server 2 geconfigureerd en wordt de lijst met beschikbare MCP-tools getoond.

Als BlueDolphin MCP Server 2 niet verschijnt, ga dan naar het tabblad Overzicht en klik op Tool toevoegen.

  • Zoek in de zoekbalk naar “BlueDolphin”. Filter op MCP-resultaat door te klikken op Model Context Protocol, te vinden onder de zoekbalk.

  • Klik op BlueDolphin MCP Server

Stap 5: Wijzig de inloggegevens naar ‘Door maker opgegeven’

  1. Selecteer in de bovenbalk de pagina Tools. Klik in de lijst met tools op BlueDolphin MCP Server

  2. Klik op Aanvullende details

  3. Klik op het keuzemenu onder “Te gebruiken inloggegevens” en kies Door maker opgegeven inloggegevens

  4. Klik rechtsboven op Sla op

Stap 6: Verwijder onderwerpen

  1. Ga naar de pagina Onderwerpen. In het gedeelte Aangepast. Zet alle onderwerpen uit

  2. Ga naar het gedeelte Systeem (zie onder + Onderwerp toevoegen). Zet alle onderwerpen uit

Optioneel: Door rechtsboven op Test te klikken, kun je je agent testen in het tabblad Test.

Stap 7: Controleer authenticatie-instellingen

  1. Ga naar Instellingen (rechtsboven in de bovenste balk)

  2. Open de pagina Beveiliging

  3. Selecteer Authenticatie

  4. Vink Authenticeren met Microsoft aan

  5. Sluit de instellingen met de X rechtsboven

Optioneel: Je kunt je agent koppelen aan Application Insights. Dit doe je zo:

  • Open Instellingen

  • Selecteer Geavanceerd

  • Klik op Application Insights

  • Kopieer en plak je verbindingsreeks

  • Klik op Sla op

Stap 8: Publiceer je agent

  1. Klik op de knop Publiceer rechtsboven, naast de knop Instellingen. Dit duurt een paar minuten.

  2. Er verschijnt een melding 'Publiceer deze agent'. Klik op Publiceer

Stap 9: Maak je agent beschikbaar op Teams en Microsoft 365

  1. Klik in de bovenste balk op Kanalen. Als Kanalen niet zichtbaar is, beweeg je muis over +2 om Kanalen te vinden

  2. Klik op Teams en Microsoft 365 Copilot

  3. Klik op Kanaal toevoegen

  4. Als het systeem om bevestiging vraagt, klik op Publiceer

Stap 10: Test je agent

  1. Klik in het tabblad Kanalen op Teams en Microsoft 365 Copilot om je agent te openen.

  2. Klik op een van deze knoppen:

    • Bekijk agent in Microsoft 365

    • Bekijk agent in Teams

    Door op Beschikbaarheid te klikken, verschijnen deze twee knoppen ook.

  3. Hier kun je bepalen aan wie je je agent wilt tonen: alleen aan teamleden en gedeelde gebruikers, of aan iedereen in je organisatie, en het permissieniveau instellen.

LET OP: Na interactie 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 op de BlueDolphin MCP-regel

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

  • Klik op Verzenden

Gerelateerde artikelen
BlueDolphin AMEFF-bestanden importeren
Power BI Quickstart voor BlueDolphin
Aan de slag met de BlueDolphin API
BlueDolphin MCP-server toevoegen aan een AI Assistent
Claude verbinden met BlueDolphin via MCP
Was dit een antwoord op uw vraag?