Descope

What is descope-mcp-server-stdio?

The descope-mcp-server-stdio project is a Model Context Protocol (MCP) server designed to integrate with Descope's Management APIs. It allows users to interact with Descope's services directly from applications like Claude Desktop, enabling the management of user data and audit logs.

How to use descope-mcp-server-stdio?

To use descope-mcp-server-stdio, you need Node.js (v18+), Claude Desktop, a Descope Project ID, and a Management Key. You can install it via Smithery CLI or manually by cloning the repository, installing dependencies (npm install), and building the project (npm run build).

After installation, configure Claude Desktop by editing claude_desktop_config.json to include the Descope server configuration, providing your Descope Project ID and Management Key. Finally, restart Claude Desktop to apply the changes and ensure the server is connected.

Key features of descope-mcp-server-stdio

• Search Audit Logs: Retrieve up to 10 audit log entries from your Descope project.
• Search Users: Retrieve up to 10 user records from your Descope project.
• Create User: Create new users within your Descope project.
• Invite User: Invite new users to your Descope project.
• Integration with Claude Desktop: Seamlessly interact with Descope APIs through Claude Desktop.

Use cases of descope-mcp-server-stdio

• User Management: Efficiently manage user accounts, including creation and invitation, directly from your desktop environment.
• Security Auditing: Quickly access and review audit logs for security monitoring and compliance.
• Developer Tools: Provide developers with a convenient way to interact with Descope's authentication and user management features during development and testing.

FAQ from descope-mcp-server-stdio

Q: What are the prerequisites for running descope-mcp-server-stdio? A: You need Node.js (version 18 or later), Claude Desktop installed, a valid Descope Project ID, and a Descope Management Key.

Q: How do I configure Claude Desktop to work with the Descope MCP server? A: You need to enable Developer Mode in Claude Desktop, then edit the claude_desktop_config.json file to add the Descope server configuration, including the command to run the server and your Descope credentials.

Q: How do I know if the Descope server is connected in Claude Desktop? A: After restarting Claude Desktop, look for the 🔌 icon, which indicates that the Descope server is successfully connected.

Descope MCP Server

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:

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

Setup Instructions

Installing via Smithery

To install Descope MCP Server for Claude Desktop automatically 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
   

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:

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

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.

Running the server

First, build the project:

npm run build

1. Running the server on stdio

npm run start:stdio

2. Running the server on SSE

npm run start:sse