Descope MCP Server

Descope MCP Server

Introdução

O servidor Descope Model Context Protocol (MCP) fornece uma interface para interagir com as APIs de Gerenciamento da Descope, permitindo a busca e recuperação de informações relacionadas ao projeto.

Ferramentas Disponíveis

• search-audits: Recupera até 10 entradas de log de auditoria do seu projeto Descope.
• search-users: Recupera até 10 registros de usuários do seu projeto Descope.
• create-user: Cria um novo usuário no seu projeto Descope.
• invite-user: Convida um novo usuário para o seu projeto Descope.

Requisitos

Antes de prosseguir, certifique-se de ter o seguinte:

• Node.js (versão 18 ou posterior)
• Claude Desktop instalado no seu sistema
• Um Project ID e Management Key válidos da Descope
• Git instalado

Para confirmar sua instalação do Node.js, execute:

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

Instruções de Configuração

Instalação via Smithery

Para instalar o Descope MCP Server para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

1. Clone o repositório:

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

2. Instale as dependências necessárias:

   npm install
   

3. Compile o projeto:

   npm run build
   

Configuração

1. Configure o Claude Desktop para reconhecer o servidor Descope MCP

Para localizar o arquivo claude_desktop_config.json, abra o aplicativo Claude Desktop e ative o Modo Desenvolvedor no menu superior esquerdo.

Depois de ativado, vá para Configurações (também no menu superior esquerdo), navegue até a seção Desenvolvedor e clique no botão Editar Configuração para acessar e editar claude_desktop_config.json.

Alternativamente, para abrir o arquivo de configuração via terminal:

No macOS:

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

No Windows:

code %APPDATA%\Claude\claude_desktop_config.json

2. Adicione a configuração do 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"
      }
    }
  }
}

Substitua your-descope-project-id-here e your-descope-management-key-here pelo seu Project ID e Management Key reais da Descope em app.descope.com/settings/project e app.descope.com/settings/company/managementkeys.

3. Reinicie o Claude Desktop

Para aplicar as alterações:

1. Saia completamente do Claude Desktop (certifique-se de que não está apenas minimizado).
2. Reabra o Claude Desktop.
3. Verifique o ícone 🔌 para confirmar que o servidor Descope está conectado.

Executando o servidor

Primeiro, compile o projeto:

npm run build

1. Executando o servidor no stdio

npm run start:stdio

2. Executando o servidor no SSE

npm run start:sse