Je kunt de Notiondesk Workspace MCP verbinden met elke compatibele AI-client die externe MCP-servers en OAuth-authenticatie ondersteunt.
Gebruik deze handleiding als uw MCP-client geen specifieke installatiehandleiding voor Notiondesk heeft.
Voordat je begint
Zorg ervoor dat:
- Workspace MCP is ingeschakeld voor ten minste één Notiondesk helpcentrum
- Je kunt je aanmelden bij de Notiondesk werkruimte waarmee je verbinding wilt maken.
- Uw MCP-client ondersteunt externe HTTP MCP-servers.
- Uw MCP-client ondersteunt OAuth-authenticatie.
Als Workspace MCP nog niet is ingeschakeld, raadpleeg dan Workspace MCP inschakelen in Notiondesk .
Verbindingsgegevens
Gebruik deze gegevens bij het toevoegen van Notiondesk aan uw MCP-client:
Voeg /sse niet toe aan de URL.
Het Workspace MCP-eindpunt is:
Voeg de MCP-server toe
Open de MCP- of connectorinstellingen van uw AI-client.
De exacte interface is afhankelijk van de client, maar doorgaans moet u het volgende doen:
Name: Notiondesk MCP
URL: https://mcp.notiondesk.so/mcp
Authentication: OAuthhttps://mcp.notiondesk.so/mcp- Voeg een nieuwe externe MCP-server toe
- Voer Notiondesk MCP in als naam.
- Voer
https://mcp.notiondesk.so/mcpin als server-URL.
- Selecteer OAuth-authenticatie als uw client om een authenticatiemethode vraagt.
- Sla de verbinding met de server op of maak er verbinding mee.
Als uw MCP-client een configuratiebestand gebruikt in plaats van een instellingeninterface, voeg dan Notiondesk toe als een externe HTTP MCP-server met dezelfde URL.
Raadpleeg de MCP-documentatie van uw klant voor het exacte configuratieformaat.
Authenticeer met Notiondesk
Nadat je de server hebt toegevoegd, start je de verbindings- of authenticatieprocedure.
Uw client moet Notiondesk openen in uw browser.
Dan:
- Meld u aan bij Notiondesk indien nodig
- Controleer of de juiste werkruimte wordt weergegeven.
- Controleer de aangevraagde machtigingen.
- De verbinding goedkeuren
- Keer terug naar uw MCP-client.
Workspace MCP maakt gebruik van OAuth, dus u hoeft geen wachtwoord of API-sleutel handmatig naar uw MCP-client te kopiëren.
Controleer de verbinding
Begin met een alleen-lezen verzoek:
Controleer of de verwachte helpcentra worden weergegeven.
Probeer dan eens:
Je kunt ook vragen:
Beginnen met alleen-lezen-verzoeken helpt te bevestigen dat de client is verbonden met de juiste Notiondesk-werkruimte voordat acties worden uitgevoerd.
Gebruik Workspace MCP
Zodra de verbinding tot stand is gebracht, kan uw MCP-client de Notiondesk-tools gebruiken die beschikbaar zijn voor uw account.
Bijvoorbeeld:
Of:
Als uw rol Notiondesk wijzigingen toestaat, kunt u ook acties aanvragen zoals:
De exacte manier waarop uw klant MCP-tools ontdekt of gebruikt, is afhankelijk van de klant.
Toestemmingen
Workspace MCP volgt de machtigingen van de teamgenoot Notiondesk die de OAuth-autorisatie voltooit.
Verbinding maken via een andere MCP-client verandert uw Notiondesk-rechten niet.
Bijvoorbeeld:
List the Notiondesk help centers I can access.Show the sync status for my main help center.Show me the latest negative article feedback.Review our article feedback and analytics from the last 30 days. Show me which articles need attention first.Check the translation status for my main help center.Trigger a sync for the onboarding collection.- Een kijker krijgt ondersteunde, alleen-leestoegang.
- Een editor kan ondersteunde beheertaken uitvoeren.
- Een beheerder of werkruimte-eigenaar heeft toegang tot aanvullende beheerdersfuncties.
De MCP-client kan geen verdere toegang verkrijgen dan uw Notiondesk-account al heeft.
Werk samen met meerdere helpdesks.
Eén Workspace MCP-verbinding kan toegang bieden tot meerdere helpcentra.
Een helpdesk is beschikbaar wanneer:
- Workspace MCP is hiervoor ingeschakeld.
- Uw Notiondesk account heeft er toegang toe.
U hebt geen aparte Workspace MCP-URL nodig voor elk helpcentrum.
Hetzelfde eindpunt wordt gebruikt:
Als er meerdere helpcentra beschikbaar zijn, geef dan aan welk helpcentrum uw assistent moet gebruiken.
Bijvoorbeeld:
Probleemoplossing
https://mcp.notiondesk.so/mcpReview article feedback for the Developer Docs help center. Mijn client kan geen verbinding maken met de server.
Controleer of de server-URL exact hetzelfde is:
Niet gebruiken:
of voeg /sse toe aan het eindpunt.
Uw klant moet ondersteuning bieden voor externe MCP-servers.
https://mcp.notiondesk.so/mcphttps://mcp.notiondesk.so/mcp/sse OAuth-authenticatie start niet.
Uw MCP-client moet OAuth-authenticatie voor externe MCP-servers ondersteunen.
Als de client alleen lokale MCP-servers, API-sleutels of statische headers ondersteunt, is deze mogelijk niet compatibel met Workspace MCP.
Raadpleeg de MCP-documentatie van uw klant.
Er is geen helpdesk aanwezig.
Bevestig dat:
- Workspace MCP is ingeschakeld voor dat helpcentrum.
- Uw Notiondesk account heeft er toegang toe.
Workspace MCP kan geen helpcentrum beschikbaar stellen waartoe uw account geen toegang heeft.
Sommige tools zijn niet beschikbaar.
De beschikbare Workspace MCP-tools zijn afhankelijk van uw Notiondesk-rol.
Uw MCP-client kan ook eigen beperkingen opleggen aan welke tools gebruikt mogen worden.
Zie Workspace MCP-rollen, -machtigingen en -beveiliging voor meer informatie.
De verbinding werkt, maar de tools worden niet automatisch gebruikt.
De keuze voor MCP-tools hangt af van de AI-client.
Sommige klanten vereisen dat u:
- Schakel de MCP-server in voor een gesprek.
- Selecteer de connector handmatig
- Schakel het gebruik van de tool in.
- Individuele acties goedkeuren
Controleer de MCP-instellingen van uw client als de verbinding Notiondesk actief is, maar de bijbehorende tools niet beschikbaar zijn in gesprekken.