Skip to content

ferrarirosso/mcp365-explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MCP365 Explorer

Compatibility

SPFx 1.22 Node.js v22 Compatible with SharePoint Online Does not work with SharePoint 2019 Does not work with SharePoint 2016 (Feature Pack 2) Teams Compatible Hosted Workbench Compatible

Open in GitHub Codespaces

Summary

Open-source SPFx webparts for exploring Microsoft 365's MCP and Foundry surface. Two patterns:

  • Work IQ MCP servers, called directly from an SPFx webpart — no backend, no proxy, just fetch + AadTokenProvider + JSON-RPC. One webpart per server.
  • Microsoft Foundry behind a protected Function App — keyless backend, Easy Auth + managed identity, deployed in one command via spfx-foundry-deploy. Starts with mcp365-foundry-chat (chat-only showcase).

Each webpart pairs with a blog post.

Preview notice: The Agents 365 Tools and MCP servers are part of the Microsoft Agent 365 tooling servers preview. These features are in preview, may change, and should not be used in production workloads.

Webparts

Direct from the browser

No backend. AAD bearer + JSON-RPC straight to the Work IQ MCP server.

Server ID Tools Status
Work IQ User mcp_MeServer 5 Available
Work IQ SharePoint mcp_SharePointRemoteServer 35 Available
Work IQ Calendar mcp_CalendarTools 13 Available
Work IQ Mail mcp_MailTools 22 Available
Work IQ Teams mcp_TeamsServer 28 Available
Work IQ OneDrive mcp_OneDriveRemoteServer 13 Available
Work IQ Word mcp_WordServer 4 Available

Through a protected Function App proxy

Foundry-backed Azure Function App, keyless to Foundry, Easy Auth-protected from the browser. Provisioned with spfx-foundry-deploy.

Webpart Backend Purpose Status
mcp365-foundry-chat Foundry (chat-completions) Chat-only showcase — proves the deployment + auth chain end-to-end Available

What Each Webpart Does

  • Showcase mode — click a button, see the result. No JSON, no parameters.
  • Explorer mode — browse tools, inspect live schemas from tools/list, auto-generated parameter forms, formatted responses, searchable log viewer
  • Custom presets — save your own parameter sets to browser localStorage

MCP365 Explorer: User Profile

Prerequisites

For the Work IQ webparts:

  1. Microsoft Frontier AI ProgramEnrollment
  2. Work IQ Tools Service Principal — Run New-Agent365ServicePrincipal.ps1 (one-time admin operation). See Microsoft's guide.
  3. Power Platform Environment ID — From Power Platform admin center. See how to find it.
  4. Node.js 22+ and SPFx 1.22

For the Foundry-backed webparts — additionally:

  1. Azure subscription with quota for gpt-5-mini (or your chosen model) in the target region
  2. Azure CLI ≥ 2.69 and Azure Functions Core Tools v4 (func) — both pre-installed in the included Codespaces devcontainer

Note on service principal naming: These webparts use "resource": "Work IQ Tools" in package-solution.json. If you ran the service principal script before March 12, 2026, your enterprise app is named "Agent 365 Tools" instead. In that case, change "resource": "Work IQ Tools" to "resource": "Agent 365 Tools" in each webpart's config/package-solution.json — otherwise the SharePoint admin center will reject the API permission request.

Quick Start

User Profile (5 tools)

cd webparts/mcp365-user-profile
npm install
npx heft build --clean
npx heft test --clean --production && npx heft package-solution --production

Upload .sppkg, approve McpServers.Me.All, add to a page.

SharePoint (35 tools)

cd webparts/mcp365-sharepoint-lists
npm install
npx heft build --clean
npx heft test --clean --production && npx heft package-solution --production

Upload .sppkg, approve McpServers.SharePoint.All, add to a page.

Foundry chat showcase

cd webparts/mcp365-foundry-chat
npm install
npm run deploy        # provisions the proxy + auto-wires serve.json (~5 min)
npm start             # workbench opens with the property pane pre-filled

npm run deploy walks you through a one-screen review form (region, model, prefix), then provisions everything: AI Foundry resource + model deployment, Storage Account, Function App with managed identity, Backend API Entra app, Easy Auth, platform hardening, App Insights. No function key in the browser. Full breakdown at spfx-foundry-deploy.

npm run teardown removes everything — resource group, soft-delete purge, Entra app — so you can experiment without lingering infra.

Blog Series

Resources

About

MCP365 Explorer — Open-source SPFx webparts for exploring Microsoft 365 MCP servers (Agents 365 Tools)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors