https://github.com/descope-sample-apps/descope-mcp-server
https://github.com/descope-sample-apps/descope-mcp-server
Last synced: 10 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/descope-sample-apps/descope-mcp-server
- Owner: descope-sample-apps
- License: mit
- Created: 2025-01-24T22:19:15.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-17T20:34:08.000Z (about 1 month ago)
- Last Synced: 2025-04-13T00:03:41.603Z (12 days ago)
- Language: TypeScript
- Size: 92.8 KB
- Stars: 3
- Watchers: 4
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Descope - Provides a server interface for interacting with Descope's Management APIs to search and retrieve project information (Table of Contents / Security)
- Awesome-MCP-Servers-directory - Descope - An MCP server to integrate with Descope to search audit logs, manage users, and more (Security)
README
# Descope MCP Server
[](https://smithery.ai/server/@descope-sample-apps/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](https://nodejs.org/) (version 18 or later)
- [Claude Desktop](https://claude.ai/download) installed on your system
- A valid Descope [Project ID](https://app.descope.com/settings/project) and [Management Key](https://app.descope.com/settings/company/managementkeys)
- Git installed
To confirm your Node.js installation, run:
```bash
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](https://smithery.ai/server/@descope-sample-apps/descope-mcp-server):
```bash
npx -y @smithery/cli install @descope-sample-apps/descope-mcp-server --client claude
```
### Manual Installation
1. Clone the repository:
```bash
git clone https://github.com/descope-sample-apps/descope-mcp-server.git
cd descope-mcp-server
```
2. Install the necessary dependencies:
```bash
npm install
```
3. Build the project:
```bash
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:
```bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
#### On Windows:
```bash
code %APPDATA%\Claude\claude_desktop_config.json
```
### 2. Add the Descope server configuration:
```json
{
"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](https://app.descope.com/settings/project) and [app.descope.com/settings/company/managementkeys](https://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:
```bash
npm run build
```
### 1. Running the server on stdio
```bash
npm run start:stdio
```
### 2. Running the server on SSE
```bash
npm run start:sse
```