Descope Sample Apps Descope MCP Server

🚀 Descope MCP Server Description

The Descope Model Context Protocol (MCP) server enables interaction with Descope's management API, allowing for the search and retrieval of project - related information.

🚀 Quick Start

The Descope Model Context Protocol (MCP) server provides the ability to interact with Descope's management API interface, enabling the search and retrieval of project - related information.

✨ Features

• search-audits: Retrieve up to 10 audit log records from your Descope project.
• search-users: Retrieve up to 10 user records from your Descope project.
• create-user: Create a new user in your Descope project.
• invite-user: Invite a new user to join your Descope project.

📦 Installation

Prerequisites

Before you start, make sure the following conditions are met:

• Node.js (version 18 or higher)
• Claude Desktop installed on your system
• A valid Descope Project ID and Management Key
• Git installed

To confirm the Node.js installation:

node --version  # Expected output: v18.0.0 or higher

Automatic Installation with Smithery

Automatically install the Descope MCP server for Claude Desktop via Smithery:

npx -y @smithery/cli install @descope-sample-apps/descope-mcp-server --client claude

Manual Installation

1. Clone the repository:

git clone https://github.com/descope-sample-apps/descope-mcp-server.git
cd descope-mcp-server

2. Install the necessary dependencies:

npm install

3. Build the project:

npm run build

📚 Documentation

Configuration

1. Configure Claude Desktop to Recognize the Descope Server

To locate the claude_desktop_config.json file, open the Claude Desktop application and enable developer mode (from the top - left menu bar). After enabling it, go to Settings (also in the top - left menu), navigate to the Developer section, and click the Edit Configuration button to access and edit claude_desktop_config.json. Alternatively, open the configuration file directly via the terminal:

• On macOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

• On Windows:

code %APPDATA%\Claude\claude_desktop_config.json

2. Add the Descope Server Configuration:

{
  "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"
      }
    }
  }
}

Replace your-descope-project-id-here and your-descope-management-key-here with your actual Descope project ID and management key.

3. Restart Claude Desktop

Apply the changes:

1. Completely exit Claude Desktop (make sure it is not minimized but fully closed).
2. Restart Claude Desktop.
3. Check the 🔌 icon to confirm that the Descope server is connected.

Running the Server

After completing the configuration, you can run the following command to start the server:

node index.js

This will start the Descope MCP server, allowing interaction with Claude Desktop.