descope-sample-apps/descope-mcp-server-stdio

Introduction
The Descope Model Context Protocol (MCP) server provides an interface to interact with Descope's Management APIs, enabling the search and retrieval of project-related information.
Available Tools
- search-audits: Retrieves up to 10 audit log entries from your Descope project.
- search-users: Retrieves up to 10 user records from your Descope project.
- create-user: Creates a new user in your Descope project.
- invite-user: Invites a new user to your Descope project.
Requirements
Before proceeding, make sure you have the following:
- Node.js (version 18 or later)
- Claude Desktop installed on your system
- A valid Descope Project ID and Management Key
- Git installed
To confirm your Node.js installation, run:
Setup Instructions
Installing via Smithery
To install Descope MCP Server for Claude Desktop automatically via Smithery:
Manual Installation
1. Clone the repository:
2. Install the necessary dependencies:
3. Build the project:
Configuration
1. Configure Claude Desktop to recognize the Descope MCP server
To locate the claude_desktop_config.json file, open the Claude Desktop app and enable Developer Mode from the top-left menu bar.
Once enabled, go to Settings (also in the top-left menu), navigate to the Developer section, and click the Edit Config button to access and edit claude_desktop_config.json.
Alternatively, to open the configuration file via terminal:
On macOS:
On Windows:
2. Add the Descope server configuration:
Replace your-descope-project-id-here and your-descope-management-key-here with your actual Descope Project ID and Management Key from app.descope.com/settings/project and app.descope.com/settings/company/managementkeys.
3. Restart Claude Desktop
To apply the changes:
1. Fully quit Claude Desktop (ensure it's not just minimized).
2. Relaunch Claude Desktop.
3. Check for the 🔌 icon to confirm the Descope server is connected.