descope-mgmt-api-connector-stdio
Facilitates interaction with Descope's Administration Interfaces to oversee user accounts and fetch operational audit trails, thus supporting robust project governance and identity lifecycle administration.
Author

descope-sample-apps
Quick Info
Actions
Tags
Descope Administrative Interface Connector (Standard I/O)
Overview
This Descope Model Context Protocol (MCP) backend component furnishes an execution layer for invoking Descope's Management APIs, principally for querying and retrieving project metadata.
Available Functions
search-audits: Fetches a maximum of 10 historical activity records from your designated Descope tenant.search-users: Retrieves up to 10 extant user profiles within your Descope environment.create-user: Provisions a novel user entity inside your Descope project.invite-user: Dispatches an invitation mechanism to onboard a new participant to your Descope space.
Prerequisites
Ensure the following prerequisites are met before deployment:
- Node.js (runtime version 18 or newer)
- Claude Desktop application installed locally
- Valid Descope Project Identifier and API Credential
- Git version control system installed
Verify Node.js installation status via:
bash node --version # Expecting v18.0.0 or a higher revision
Deployment Procedures
Installation via Smithery
For automated setup of the Descope MCP component for Claude Desktop using Smithery:
bash npx -y @smithery/cli install @descope-sample-apps/descope-mcp-server --client claude
Manual Repository Setup
-
Acquire the source code repository:
bash git clone https://github.com/descope-sample-apps/descope-mcp-server.git cd descope-mcp-server
-
Install required software packages:
bash npm install
-
Compile the application artifacts:
bash npm run build
Configuration Steps
1. Registering the Descope Connector with Claude Desktop
Locate the claude_desktop_config.json configuration file by activating Developer Mode within the Claude Desktop application's top-left menu. After enabling this mode, navigate to Settings (also top-left), proceed to the Developer section, and use the Edit Config button to modify this JSON file.
Alternatively, you can open the configuration file directly from your terminal:
macOS Environment:
bash code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows Environment:
bash code %APPDATA%\Claude\claude_desktop_config.json
2. Injecting the Descope Server Configuration Block:
Integrate the following structure into your configuration file:
{ "mcpServers": { "descope": { "command": "node", "args": ["/path/to/descope-mcp-server/build/index.js"], "env": { "DESCOPE_PROJECT_ID": "your-descope-project-id-here", "DESCOPE_MANAGEMENT_KEY": "your-descope-management-key-here" } } } }
Substitute your-descope-project-id-here and your-descope-management-key-here with your actual credentials sourced from app.descope.com/settings/project and app.descope.com/settings/company/managementkeys.
3. Reinitiating Claude Desktop
To ensure parameter application:
- Completely terminate the Claude Desktop process (do not just minimize the window).
- Launch Claude Desktop again.
- Verify the connection status by observing the 🔌 indicator icon.
Operational Execution
First, ensure the project artifacts are compiled:
bash npm run build
1. Launching in Standard I/O Mode
bash npm run start:stdio
2. Launching in Server-Sent Events (SSE) Mode
bash npm run start:sse
WIKIPEDIA: Business administration utilities encompass all systems, software, oversight mechanisms, calculation frameworks, and operational doctrines employed by commercial entities to navigate shifting marketplace conditions, maintain competitive standing, and enhance organizational efficacy. These utilities span functional areas such as strategic forecasting, process orchestration, record maintenance, personnel oversight, and critical assessment mechanisms. Modern administrative software has undergone rapid evolution due to technological acceleration, making judicious selection and customization paramount for maximizing return on investment and ensuring alignment with corporate objectives, rather than adopting novel tools without critical evaluation.
