local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables interaction with Okta's user management system, providing tools for retrieving detailed user information, listing users with filtering and pagination options, and managing user groups.

Servidor Okta MCP

Este servidor MCP permite a Claude interactuar con el sistema de gestión de usuarios de Okta, proporcionando capacidades de gestión de usuarios y grupos.

Prerrequisitos

Node.js (v16 o superior)
Aplicación de escritorio Claude
Cuenta de desarrollador de Okta
Token de API de administración de Okta

Instrucciones de configuración

1. Crea una cuenta de desarrollador de Okta

Vaya a la consola para desarrolladores de Okta
Crea una nueva cuenta o inicia sesión en una existente
Anote su dominio Okta (por ejemplo, dev-123456.okta.com )

2. Crear un token de API

En la consola para desarrolladores de Okta, vaya a Seguridad > API > Tokens
Haga clic en "Crear token"
Dale a tu token un nombre significativo (por ejemplo, "Token de servidor MCP")
Copia el valor del token (no podrás volver a verlo)

3. Configuración inicial del proyecto

Instalar dependencias:

npm install

4. Configurar Claude Desktop

Abra el archivo de configuración de Claude Desktop:

Para MacOS:

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

Para Windows:

code %AppData%\Claude\claude_desktop_config.json

Agregar o actualizar la configuración:

{
    "mcpServers": {
        "okta": {
            "command": "node",
            "args": [
                "PATH_TO_PROJECT_DIRECTORY/dist/index.js"
            ],
            "env": {
                "OKTA_ORG_URL": "https://your-domain.okta.com",
                "OKTA_API_TOKEN": "your-api-token"
            }
        }
    }
}

Guarde el archivo y reinicie Claude Desktop.

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

obtener_usuario

Recupera información detallada del usuario de Okta, que incluye:

Detalles del usuario (ID, estado)
Fechas de la cuenta (creación, activación, último inicio de sesión, etc.)
Información personal (nombre, correo electrónico)
Detalles del empleo
Información del contacto
DIRECCIÓN
Preferencias

lista_usuarios

Enumera los usuarios de Okta con filtrado y paginación opcionales:

Admite expresiones de filtro SCIM (por ejemplo, 'profile.firstName eq "John"')
Búsqueda de texto libre en varios campos
Opciones de clasificación (por estado, fecha de creación, etc.)
Soporte de paginación con límites personalizables

grupos de listas

Enumera los grupos de usuarios de Okta con filtrado y paginación opcionales:

Expresiones de filtro para grupos (por ejemplo, 'type eq "OKTA_GROUP"')
Búsqueda de texto de formato libre en los campos del grupo
Opciones de clasificación (por nombre, tipo, etc.)
Soporte de paginación con límites personalizables

Ejemplo de uso en Claude

Después de la configuración, puede utilizar comandos como:

"Muéstrame los detalles del usuario con ID de usuario XXXX"
"¿Cuál es el estado del usuario john.doe@company.com ?"
"¿Cuándo fue el último inicio de sesión del usuario jane.smith@organization.com ?"
"Enumerar todos los usuarios del departamento de marketing"
"Buscar usuarios creados en el último mes"
"Muéstrame todos los grupos de mi organización Okta"
"Lista de grupos que contienen la palabra 'admin'"

Manejo de errores

El servidor incluye un manejo robusto de errores para:

Usuario o grupo no encontrado (errores 404)
Problemas de autenticación de API
Perfiles de usuario faltantes o no válidos
Errores generales de API

Solución de problemas

Problemas comunes

Herramientas que no aparecen en Claude:

Consulte los registros de Claude Desktop: tail -f ~/Library/Logs/Claude/mcp*.log
Verifique que todas las variables de entorno estén configuradas correctamente
Asegúrese de que la ruta a index.js sea absoluta y correcta

Errores de autenticación:

Verifique que su token API sea válido
Compruebe si OKTA_ORG_URL incluye la URL completa con https://
Asegúrese de que su dominio de Okta sea correcto

Problemas de conexión al servidor:

Comprueba si el servidor se ha creado correctamente
Verificar los permisos de archivo en build/index.js (deberían ser 755)
Intente ejecutar el servidor directamente: node /path/to/build/index.js

Visualización de registros

Para ver los registros del servidor:

Para MacOS/Linux:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Para Windows:

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

Variables de entorno

Si recibe errores de variables de entorno, verifique:

OKTA_ORG_URL : Debe ser la URL completa (por ejemplo, " https://dev-123456.okta.com ")
OKTA_API_TOKEN : Debe ser un token de API válido

Consideraciones de seguridad

Mantenga su token API seguro
No confirme las credenciales en el control de versiones
Utilice variables de entorno para datos confidenciales
Rotar regularmente los tokens API
Supervisar el uso de la API en la consola de administración de Okta
Implementar limitación de velocidad para llamadas API
Utilice los permisos mínimos requeridos para el token API

Tipos

El servidor incluye interfaces TypeScript para datos de usuarios y grupos de Okta:

interface OktaUserProfile {
  login: string;
  email: string;
  secondEmail?: string;
  firstName: string;
  lastName: string;
  displayName: string;
  nickName?: string;
  organization: string;
  title: string;
  division: string;
  department: string;
  employeeNumber: string;
  userType: string;
  costCenter: string;
  mobilePhone?: string;
  primaryPhone?: string;
  streetAddress: string;
  city: string;
  state: string;
  zipCode: string;
  countryCode: string;
  preferredLanguage: string;
  profileUrl?: string;
}

interface OktaUser {
  id: string;
  status: string;
  created: string;
  activated: string;
  lastLogin: string;
  lastUpdated: string;
  statusChanged: string;
  passwordChanged: string;
  profile: OktaUserProfile;
}

interface OktaGroup {
  id: string;
  created: string;
  lastUpdated: string;
  lastMembershipUpdated: string;
  type: string;
  objectClass: string[];
  profile: {
    name: string;
    description: string;
  };
}

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Apoyo

Si encuentra algún problema:

Consulte la sección de solución de problemas más arriba
Revisar los registros de Claude Desktop
Examinar la salida de error del servidor
Consulte la documentación para desarrolladores de Okta

Nota: ¡RR. PP. bienvenidos!

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Permite a Claude interactuar con el sistema de administración de usuarios de Okta, proporcionando capacidades para recuperar detalles de los usuarios, enumerarlos con opciones de filtrado y administrar grupos de usuarios.

Okta MCP Server