Descope MCP Server

Servidor Descope MCP

Introducción

El servidor Descope Model Context Protocol (MCP) proporciona una interfaz para interactuar con las API de gestión de Descope, permitiendo la búsqueda y recuperación de información relacionada con el proyecto.

Herramientas disponibles

• search-audits: Recupera hasta 10 entradas de registro de auditoría de tu proyecto Descope.
• search-users: Recupera hasta 10 registros de usuarios de tu proyecto Descope.
• create-user: Crea un nuevo usuario en tu proyecto Descope.
• invite-user: Invita a un nuevo usuario a tu proyecto Descope.

Requisitos

Antes de continuar, asegúrate de tener lo siguiente:

• Node.js (versión 18 o posterior)
• Claude Desktop instalado en tu sistema
• Un ID de Proyecto y una Clave de Gestión válidos de Descope
• Git instalado

Para confirmar tu instalación de Node.js, ejecuta:

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

Instrucciones de configuración

Instalación mediante Smithery

Para instalar Descope MCP Server para Claude Desktop automáticamente a través de Smithery:

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

Instalación manual

1. Clona el repositorio:

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

2. Instala las dependencias necesarias:

   npm install
   

3. Compila el proyecto:

   npm run build
   

Configuración

1. Configura Claude Desktop para que reconozca el servidor Descope MCP

Para localizar el archivo claude_desktop_config.json, abre la aplicación Claude Desktop y habilita el Modo Desarrollador desde la barra de menú superior izquierda.

Una vez habilitado, ve a Configuración (también en el menú superior izquierdo), navega a la sección Desarrollador y haz clic en el botón Editar Configuración para acceder y editar claude_desktop_config.json.

Alternativamente, para abrir el archivo de configuración mediante la terminal:

En macOS:

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

En Windows:

code %APPDATA%\Claude\claude_desktop_config.json

2. Agrega la configuración del servidor Descope:

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

Reemplaza your-descope-project-id-here y your-descope-management-key-here con tu ID de Proyecto y Clave de Gestión reales de Descope desde app.descope.com/settings/project y app.descope.com/settings/company/managementkeys.

3. Reinicia Claude Desktop

Para aplicar los cambios:

1. Cierra completamente Claude Desktop (asegúrate de que no esté solo minimizado).
2. Vuelve a abrir Claude Desktop.
3. Verifica el ícono 🔌 para confirmar que el servidor Descope está conectado.

Ejecución del servidor

Primero, compila el proyecto:

npm run build

1. Ejecutar el servidor en stdio

npm run start:stdio

2. Ejecutar el servidor en SSE

npm run start:sse