Skip to main content
Glama
academy-pages-mcp

academy-pages-mcp

academy-pages-mcp (prototype)

Een kleine MCP-server waarmee Claude rechtstreeks concept-pagina's op de HTJZ Academy (SharePoint) kan maken, bijwerken en publiceren, via de Microsoft Graph API. Dus zonder de PowerShell-omweg die we nu gebruiken.

Dit is een prototype om te laten zien dat het werkt en om IT te laten beoordelen voor uitrol. Het gaat om schrijftoegang tot het kennissysteem van de firma, dus de uiteindelijke keuze (welke rechten, welke app) ligt bij Edgar en IT.

Waarom

Nu bouwt Claude Academy-pagina's via PowerShell op één Mac met een gecachete verbinding. Dat werkt, maar alleen daar, en collega's zonder die opstelling kunnen niet zelf bijdragen. Met deze tool als connector in de Cowork-omgeving kan iedereen met toegang concept-pagina's laten bouwen, net zoals de bestaande file-tools (uploaden, verplaatsen) werken.

Related MCP server: mcp-onedrive-sharepoint

Wat het doet

Vier tools voor Claude:

Tool

Wat het doet

academy_create_concept_page

Maakt een nieuwe pagina als concept (draft, niet live). Argumenten: name, title, bodyHtml.

academy_update_page_text

Werkt de tekst van een pagina bij (blijft concept tot publiceren). Argumenten: id, bodyHtml.

academy_publish_page

Publiceert een pagina. Argument: id.

academy_list_pages

Lijst de pagina's op (id, naam, titel, url).

academy_list_menu

Toont het menu (QuickLaunch) met de id's, om een parent te kiezen.

academy_add_menu_item

Zet een gepubliceerde pagina in het menu (optioneel onder een sectie).

Nieuwe pagina's zijn standaard concept. Dat sluit aan bij het model "iedereen levert, de eigenaar publiceert": Claude bouwt het concept, de eigenaar publiceert (of vraagt Claude dat te doen).

De echte beslissing: rechten

De tool heeft schrijftoegang tot de Academy nodig (Graph-scope Sites.ReadWrite.All). Twee smaken:

  • Delegated (namens de ingelogde gebruiker). Veilig en simpel. De gebruiker logt één keer in (device-code), en de tool doet alleen wat die gebruiker zelf mag. Nadeel: de gebruiker moet al bewerkrechten op de Academy hebben.

  • App-only (namens de app zelf). De tool kan altijd schrijven, ongeacht wie hem gebruikt. Krachtiger en echt "iedereen kan bijdragen", maar dan moet de omgeving zelf bewaken wie de tool mag aanroepen. Vraagt om governance.

Dit is de knoop die IT doorhakt. De code werkt met allebei; standaard staat delegated.

Demo draaien (zonder dat IT iets registreert)

Voor een snelle demo gebruikt de tool standaard de publieke Microsoft Graph CLI-app, zodat je geen eigen app-registratie nodig hebt. Je logt één keer in met je eigen account.

cd ~/Developer/academy-pages-mcp
npm install
npm run demo            # maakt een concept-testpagina ZZ-MCP-demo.aspx
npm run demo -- publish # maakt hem en publiceert hem

Bij de eerste run verschijnt een device-code login (ga naar de getoonde URL, voer de code in, log in met je HTJZ-account). Daarna is het token gecached en gaat het stil.

Let op: sommige tenants vragen admin-goedkeuring voor Sites.ReadWrite.All. Als de login zegt dat goedkeuring nodig is, moet een Entra-beheerder dat één keer goedkeuren. Dat is precies de IT-stap hieronder.

Toevoegen aan Claude (Desktop/Cowork)

Zet dit in de MCP-configuratie (bij Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "academy-pages": {
      "command": "node",
      "args": ["/Users/edgarstam/Developer/academy-pages-mcp/src/index.mjs"],
      "env": {
        "SP_SITE_URL": "https://stamadvocaten.sharepoint.com/sites/Academy",
        "GRAPH_TENANT": "stamadvocaten.onmicrosoft.com",
        "GRAPH_CLIENT_ID": "646a6353-f18d-4566-84a9-73b2a8d9f23d",
        "GRAPH_SCOPES": "Sites.ReadWrite.All"
      }
    }
  }
}

Daarna heeft Claude de vier tools hierboven.

Voor productie (de nette versie, IT-taak)

  1. Registreer een eigen Entra-app "Academy Pages" (in plaats van de Graph CLI-app).

  2. Kies de rechtenvorm:

    • Delegated: Graph-permissie Sites.ReadWrite.All (delegated) + "Allow public client flows" aan (voor device-code). Gebruikers hebben eigen bewerkrechten nodig.

    • App-only: Graph-permissie Sites.ReadWrite.All (application) + admin consent, en een client secret of certificaat. Zet dan een gate op wie de tool mag gebruiken.

  3. Overweeg de scope te beperken tot alleen de Academy-site met Sites.Selected in plaats van Sites.ReadWrite.All (schrijftoegang tot precies één site, niet alle sites). Netter en veiliger.

  4. Zet de client-id (en bij app-only de auth-gegevens) in de env van de connector.

Menu-beheer (extra permissie nodig)

De Graph-API kan geen SharePoint-menu (QuickLaunch) aanpassen, dus academy_list_menu en academy_add_menu_item praten met de SharePoint REST-API. Dat vereist een SharePoint-token, en dus een extra delegated permissie op de app: SharePoint > AllSites.Manage (naast de Graph-permissie), met admin consent. De page-acties (tekst, banner, byline, publiceren) werken op Graph; alleen het menu gebruikt SharePoint.

Beperkingen van dit prototype

  • Delegated device-code is bedoeld voor persoonlijk gebruik per persoon; voor de hele firma zonder per-persoon login is app-only met een gate of Sites.Selected de nette route.

  • De banner verwijst naar een bestaande afbeelding in SiteAssets (de tool uploadt zelf geen banners).

Bestanden

  • src/index.mjs - de MCP-server en de tools.

  • src/graph.mjs - de Graph Pages-API-aanroepen (maken/bijwerken/publiceren, banner + byline).

  • src/sharepoint.mjs - de SharePoint REST-aanroepen voor het menu.

  • src/auth.mjs - device-code login met tokencache (Graph- en SharePoint-scope).

  • src/canvas.mjs - zet een HTML-fragment om in een tekst-webpart.

  • bin/demo.mjs - losse demo buiten Claude om.

Available Tools

6 tools
academy_add_menu_itemA

Zet een gepubliceerde pagina in het menu. Geef title en pageUrl (server-relative, bv /sites/Academy/SitePages/Mijn.aspx). Optioneel parentId (uit academy_list_menu) om het onder een sectie te hangen. Doe dit pas NA publiceren.

Inputs: title (required), pageUrl (required), parentId.

academy_create_concept_pageA

Maak een nieuwe concept-pagina (draft, niet gepubliceerd) op de HTJZ Academy. Geef name (bestandsnaam zonder pad, bv 'Mijn-onderwerp'), title en bodyHtml (een HTML-fragment met h2/p/ul). Optioneel: bannerUrl (volledige URL van een banner in SiteAssets voor de header) en ownerEmail (zet de eigenaar-byline, bv inciatar@htjz.nl).

Inputs: name (required), title (required), bodyHtml (required), bannerUrl, +1 more.

academy_list_menuA

Toon het menu (QuickLaunch) van de Academy met de id's per item, zodat je een parent kunt kiezen om een pagina onder te hangen.

Inputs: no named parameters.

academy_list_pagesA

Lijst de pagina's op de Academy op (id, name, title, webUrl). Handig om te zien of iets al bestaat en om een id op te halen.

Inputs: no named parameters.

academy_publish_pageA

Publiceer een pagina (maakt de laatste versie live). Geef id. Doe dit als eigenaar, of na akkoord van de eigenaar.

Inputs: id (required).

academy_update_page_textB

Werk de tekst van een bestaande pagina bij. De wijziging blijft concept tot je publiceert. Geef id (uit create of list) en bodyHtml.

Inputs: id (required), bodyHtml (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool targets a distinct action (list menu, add menu item, create concept, update text, publish, list pages) on the Academy domain. The only minor overlap is between list_menu and list_pages, but their purposes (menu structure vs. page inventory) are reasonably distinct.

    Naming Consistency3/5

    All tools use a consistent academy_ prefix with verb_noun structure (academy_create_concept_page, academy_list_pages). However, 'add_menu_item' and 'create_concept_page' mix different verb phrasings, and 'update_page_text' uses a slightly different pattern than the others, though the overall convention is readable.

    Tool Count5/5

    Six tools is a well-scoped set for a page-management server, covering the full create-to-publish workflow plus menu management. Each tool clearly earns its place without redundancy.

    Completeness4/5

    The lifecycle is well-covered: create concept, update text, publish, list, plus menu operations (list menu, add menu item). The main gap is the lack of a delete/archive operation for pages or menu items, which agents may need for cleanup, but the core publishing workflow is complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers