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.

Okta MCP 서버

이 MCP 서버를 통해 Claude는 Okta의 사용자 관리 시스템과 상호 작용하여 사용자 및 그룹 관리 기능을 제공할 수 있습니다.

필수 조건

Node.js(v16 이상)
클로드 데스크톱 앱
Okta 개발자 계정
Okta의 관리자 API 토큰

설치 지침

1. Okta 개발자 계정 생성

Okta 개발자 콘솔 로 이동
새 계정을 만들거나 기존 계정에 로그인하세요
Okta 도메인(예: dev-123456.okta.com )을 기록해 두세요.

2. API 토큰 생성

Okta 개발자 콘솔에서 보안 > API > 토큰으로 이동합니다.
"토큰 생성"을 클릭하세요
토큰에 의미 있는 이름을 지정하세요(예: "MCP 서버 토큰")
토큰 값을 복사하세요(다시는 볼 수 없습니다)

3. 초기 프로젝트 설정

종속성 설치:

지엑스피1

4. Claude Desktop 구성

Claude Desktop 구성 파일을 엽니다.

MacOS의 경우:

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

Windows의 경우:

code %AppData%\Claude\claude_desktop_config.json

구성을 추가하거나 업데이트합니다.

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

파일을 저장하고 Claude Desktop을 다시 시작하세요.

사용 가능한 도구

서버는 다음과 같은 도구를 제공합니다.

사용자 가져오기

다음을 포함하여 Okta에서 자세한 사용자 정보를 검색합니다.

사용자 세부 정보(ID, 상태)
계정 날짜(생성, 활성화, 마지막 로그인 등)
개인 정보(이름, 이메일)
고용 세부 사항
연락처 정보
주소
선호사항

사용자 목록

선택적 필터링 및 페이지 매김을 통해 Okta의 사용자를 나열합니다.

SCIM 필터 표현식(예: 'profile.firstName eq "John"')을 지원합니다.
여러 필드에 걸친 자유형 텍스트 검색
정렬 옵션(상태, 생성 날짜 등)
사용자 정의 가능한 제한을 통한 페이지 매김 지원

목록_그룹

선택적 필터링 및 페이지 매김을 사용하여 Okta의 사용자 그룹을 나열합니다.

그룹에 대한 필터 표현식(예: 'type eq "OKTA_GROUP"')
그룹 필드에서 자유 형식 텍스트 검색
정렬 옵션(이름, 유형 등)
사용자 정의 가능한 제한을 통한 페이지 매김 지원

Claude에서의 사용 예

설정 후 다음과 같은 명령을 사용할 수 있습니다.

"사용자 ID가 XXXX인 사용자에 대한 세부 정보를 보여주세요"
" john.doe@company.com 사용자의 상태는 어떻습니까?"
"사용자 jane.smith@organization.com 의 마지막 로그인은 언제였습니까?"
"마케팅 부서의 모든 사용자를 나열하세요"
"지난 달에 생성된 사용자 찾기"
"내 Okta 조직의 모든 그룹을 보여주세요"
"'admin'이라는 단어가 포함된 그룹 나열"

오류 처리

서버에는 다음에 대한 강력한 오류 처리 기능이 포함되어 있습니다.

사용자 또는 그룹을 찾을 수 없습니다(404 오류)
API 인증 문제
사용자 프로필이 누락되었거나 유효하지 않습니다.
일반 API 오류

문제 해결

일반적인 문제

Claude에 나타나지 않는 도구:

Claude Desktop 로그 확인: tail -f ~/Library/Logs/Claude/mcp*.log
모든 환경 변수가 올바르게 설정되었는지 확인하세요
index.js 경로가 절대적이고 올바른지 확인하세요.

인증 오류:

API 토큰이 유효한지 확인하세요
OKTA_ORG_URL에 https://가 포함된 전체 URL이 포함되어 있는지 확인하세요.
Okta 도메인이 올바른지 확인하세요

서버 연결 문제:

서버가 성공적으로 빌드되었는지 확인하세요
build/index.js에 대한 파일 권한을 확인하세요(755여야 함)
서버를 직접 실행해보세요: node /path/to/build/index.js

로그 보기

서버 로그를 보려면:

MacOS/Linux의 경우:

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

Windows의 경우:

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

환경 변수

환경 변수 오류가 발생하는 경우 다음을 확인하세요.

OKTA_ORG_URL : 전체 URL이어야 합니다(예: " https://dev-123456.okta.com ").
OKTA_API_TOKEN : 유효한 API 토큰이어야 합니다.

보안 고려 사항

API 토큰을 안전하게 유지하세요
버전 제어에 자격 증명을 커밋하지 마세요
민감한 데이터에 환경 변수를 사용하세요
API 토큰을 정기적으로 회전합니다
Okta 관리 콘솔에서 API 사용 모니터링
API 호출에 대한 속도 제한 구현
API 토큰에 필요한 최소 권한 사용

유형

서버에는 Okta 사용자 및 그룹 데이터를 위한 TypeScript 인터페이스가 포함되어 있습니다.

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;
  };
}

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

지원하다

문제가 발생하면:

위의 문제 해결 섹션을 확인하세요
Claude Desktop 로그 검토
서버의 오류 출력을 검사합니다.
Okta 개발자 문서를 확인하세요

참고사항: PR 환영!

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Claude가 Okta의 사용자 관리 시스템과 상호 작용할 수 있도록 하여 사용자 세부 정보 검색, 필터링 옵션을 사용하여 사용자 목록 작성, 사용자 그룹 관리 기능을 제공합니다.

Okta MCP Server