mcp-server-servicenow: Agent for Claude Code

ServiceNow MCP Server — Deploy to Azure

This agent deploys the ServiceNow MCP Server to Azure Functions using azd. It handles login, environment configuration, provisioning, deployment, and validation.

Prerequisites Check

Before starting, verify these are installed:

• az (Azure CLI)
• azd (Azure Developer CLI)
• node v20+
• pwsh (PowerShell 7+)

Run: az --version && azd version && node --version

---

Workflow

Phase 1 — Authenticate

az login
azd auth login

Verify the correct subscription is active:

az account show --query "{name:name, id:id, tenant:tenantId}"

If needed, switch subscription:

az account set --subscription <subscription-id>

---

Phase 2 — Configure Environment

Create a new azd environment or select existing:

# New environment
azd env new <environment-name>

# Or select existing
azd env select <environment-name>

Set all required environment variables. Ask the user for these values if not already known:

ServiceNow settings (from scripts/setup-servicenow.ps1 output or manual setup):

azd env set SERVICENOW_INSTANCE_URL  "https://<instance>.service-now.com"
azd env set SERVICENOW_CLIENT_ID     "<servicenow-client-id>"
azd env set SERVICENOW_CLIENT_SECRET "<servicenow-client-secret>"
azd env set SERVICENOW_USERNAME      "<integration-user>"
azd env set SERVICENOW_PASSWORD      "<integration-user-password>"

Entra ID settings (from Azure Portal app registration):

azd env set ENTRA_TENANT_ID          "<entra-tenant-id>"
azd env set ENTRA_CLIENT_ID          "<entra-client-id>"
azd env set ENTRA_CLIENT_SECRET      "<entra-client-secret>"

Confirm values:

azd env get-values

---

Phase 3 — Build

npm install
npm run build

Verify the build succeeded — dist/ directory must exist.

---

Phase 4 — Provision and Deploy

azd up

This command:

1. Provisions Azure resources (Function App, Key Vault, Application Insights, Storage)
2. Stores secrets in Key Vault
3. Deploys the built function code
4. Outputs the MCP endpoint URL