Descope MCP Server

🚀 Descope MCP Server Description

The Descope Model Context Protocol (MCP) server provides an interface to interact with Descope's management API, 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 proceeding, ensure you have the following:

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

To confirm the installation of Node.js, run the following command:

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

Automatic Installation via Smithery

Use Smithery to automatically install the Descope MCP server for Claude Desktop:

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 MCP Server

To locate the claude_desktop_config.json file, open the Claude Desktop application and enable developer mode from the top-left corner of the menu bar.

Once enabled, go to Settings (also in the top-left corner of the menu bar), 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": ["--loader", "ts-node/esm"],
      "options": ["--loader", "ts-node/esm"],
      "cwd": "${file.path}",
      "config": {
        "type": "stdio",
        "encoding": "utf8",
        "interactive": false,
        "tty": false
      },
      "stdio": "inherit"
    }
  }
}

Add the above content to the claude_desktop_config.json file and replace the placeholders with your actual project ID and management key.

3. Run the Server

After configuration, you can run the server with the following command:

npm run start

⚠️ Important Note

• Ensure that the Node.js version meets the requirements.
• Handle paths and placeholders with care when editing the configuration file.
• If you encounter issues during installation or configuration, check the error messages in the terminal output and ensure that all dependencies are installed correctly.

By following the above steps, you should be able to successfully set up and run the Descope MCP server.