nexus-mcp/archive/Identity/COPILOT-STUDIO-QUICKSTART.md
nathan 479df6bd8a chore: archive legacy Identity, Workday, and Intune folders
- Move Identity/, Workday/, Intune/ to archive/ (superseded by nexus-mcp shards)
- Move 'Local Setup.md' to archive/ (superseded by nexus-mcp/Local-Setup.md)
- Add archive/README.md explaining migration and preserved content
- Clean repository structure: only nexus-mcp, documentation, and .github remain active

All legacy functionality migrated to nexus-mcp sharded architecture.
Archived folders preserved for reference and historical context.

Refs: SESSION_SNAPSHOT_2026-04-13.md
2026-04-13 09:38:42 -04:00

58 lines
1.8 KiB
Markdown

# Identity MCP → Copilot Studio Quick Start
## Prerequisites
- [ ] Identity MCP server running with streamable HTTP transport
- [ ] HTTPS endpoint publicly accessible from Power Platform
- [ ] API key generated and configured
## Quick setup commands
```bash
# 1. Test streamable transport locally
cd "MCP Servers/Identity"
export MCP_TRANSPORT=streamable
export MCP_PORT=8000
export IDENTITY_BACKEND=memory
python identity_mcp_server.py
# 2. Generate API key
openssl rand -hex 32
# 3. Test endpoint
curl -X POST http://localhost:8000/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":"1"}'
```
## OpenAPI file configuration
Edit `identity-mcp-openapi.yaml`:
1. Line 16: Replace `your-identity-mcp-host.yourdomain.com` with your actual host
2. Lines 26-30: Ensure API key security is uncommented (default)
3. Save file
## Import to Copilot Studio
1. Copilot Studio → Tools → Add tool → New tool → Custom connector
2. Power Apps → New custom connector → Import OpenAPI file
3. Upload `identity-mcp-openapi.yaml` → Continue
4. Security tab → API Key → Header → `X-API-Key` → Create
5. Test tab → New connection → Enter API key → Test operation
6. Return to Copilot Studio → Add tool → Select connector → Add to agent
## Test prompts
- "Get user details for jsmith"
- "Who are the members of VPN-Users?"
- "Find stale users over 90 days"
## Files created
`identity-mcp-openapi.yaml` — OpenAPI schema for Power Apps import
`identity_mcp_server.py` — Updated with streamable HTTP support
`copilot-studio-deployment-guide.md` — Full step-by-step walkthrough
---
**Next step:** Follow [copilot-studio-deployment-guide.md](copilot-studio-deployment-guide.md) for full deployment procedure.