Descope Authentication

🚀 Descope MCP Server

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)
• Claude Desktop installed on your system
• A valid Descope Project ID and Management Key
• Git installed

To confirm your Node.js installation, run:

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 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. After enabling it, 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, open the configuration file 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 from app.descope.com/settings/project and app.descope.com/settings/company/managementkeys.

3. Restart Claude Desktop after configuration to apply the changes.

Running the Server

To run the MCP server, execute the following command in the terminal:

node src/index.js

Ensure you have correctly set the project_id and management_key environment variables or filled them directly into the configuration file.