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의 경우:
Windows의 경우:
구성을 추가하거나 업데이트합니다.
파일을 저장하고 Claude Desktop을 다시 시작하세요.
사용 가능한 도구
서버는 다음과 같은 도구를 제공합니다.
사용자 관리
사용자 가져오기
다음을 포함하여 Okta에서 자세한 사용자 정보를 검색합니다.
- 사용자 세부 정보(ID, 상태)
- 계정 날짜(생성, 활성화, 마지막 로그인 등)
- 개인 정보(이름, 이메일)
- 고용 세부 사항
- 연락처 정보
- 주소
- 선호사항
사용자 목록
선택적 필터링 및 페이지 매김을 통해 Okta의 사용자를 나열합니다.
- SCIM 필터 표현식(예: 'profile.firstName eq "John"')을 지원합니다.
- 여러 필드에 걸친 자유형 텍스트 검색
- 정렬 옵션(상태, 생성 날짜 등)
- 사용자 정의 가능한 제한을 통한 페이지 매김 지원
활성화_사용자
Okta에서 사용자를 활성화합니다.
- 활성화 이메일을 보내는 옵션
- 사용자 상태를 활성으로 업데이트합니다.
사용자 일시 중지
Okta에서 사용자를 일시 중단합니다.
사용자 일시 중지 해제
Okta에서 이전에 일시 중단된 사용자의 일시 중단을 해제합니다.
사용자 삭제
Okta에서 사용자를 삭제합니다(참고: 먼저 사용자를 비활성화해야 함)
사용자 마지막 위치 가져오기
Okta 시스템 로그에서 사용자의 마지막으로 알려진 위치 및 로그인 정보를 검색합니다.
그룹 관리
목록_그룹
선택적 필터링 및 페이지 매김을 통해 Okta의 사용자 그룹을 나열합니다.
- 그룹에 대한 필터 표현식(예: 'type eq "OKTA_GROUP"')
- 그룹 필드에서 자유형 텍스트 검색
- 정렬 옵션(이름, 유형 등)
- 사용자 정의 가능한 제한을 통한 페이지 매김 지원
생성_그룹
Okta에 이름과 선택적 설명을 사용하여 새 그룹을 만듭니다.
get_group
특정 그룹에 대한 자세한 정보를 검색합니다.
삭제_그룹
Okta에서 그룹을 삭제합니다
그룹에 사용자 할당
Okta에서 사용자를 그룹에 할당합니다.
그룹에서 사용자를 제거하세요
Okta에서 그룹에서 사용자를 제거합니다.
그룹 사용자 목록
페이지 매김 지원을 통해 특정 그룹의 모든 사용자를 나열합니다.
온보딩 자동화(실험적)
참고: 온보딩 자동화 도구는 실험 단계이며 Okta의 API 제약 조건에 따라 변경 또는 제한될 수 있습니다. 프로덕션 환경에서는 주의해서 사용하세요.
대량 사용자 가져오기
CSV 문자열에서 여러 사용자를 가져옵니다.
- CSV 데이터를 기반으로 사용자 계정을 생성합니다.
- 사용자의 선택적 활성화
- 선택적인 이메일 알림
- 기본 그룹에 할당
사용자를 그룹에 할당
속성 매핑을 기반으로 여러 사용자를 그룹에 할당합니다.
- 사용자 속성(부서, 직함 등)을 특정 그룹에 매핑합니다.
- 속성 기반 사용자 대량 할당
제공_신청
여러 사용자를 위한 애플리케이션 액세스 제공:
- 사용자를 애플리케이션에 할당합니다
- 대량 프로비저닝 지원
런온보딩 워크플로
CSV 데이터에서 여러 사용자를 위한 완전한 온보딩 워크플로를 실행합니다.
- CSV에서 사용자 가져오기
- 자동 활성화
- 속성 기반 그룹 할당
- 애플리케이션 프로비저닝
- 환영 이메일 구성
Claude에서의 사용 예
설정 후 다음과 같은 명령을 사용할 수 있습니다.
사용자 관리
- "사용자 ID가 XXXX인 사용자에 대한 세부 정보를 보여주세요"
- " john.doe@company.com 사용자의 상태는 어떻습니까?"
- "사용자 jane.smith@organization.com 의 마지막 로그인은 언제였습니까?"
- "마케팅 부서의 모든 사용자를 나열하세요"
- "지난 달에 생성된 사용자 찾기"
- "ID XXXX의 사용자 활성화"
- "ID XXXX의 사용자를 일시 중지합니다"
- "ID XXXX의 비활성화된 사용자 삭제"
- "사용자 XXXX는 마지막으로 어디에서 로그인했습니까?"
그룹 관리
- "내 Okta 조직의 모든 그룹을 보여주세요"
- "'admin'이라는 단어가 포함된 그룹 나열"
- "마케팅팀"이라는 이름의 새 그룹을 만드세요.
- "ID XXXX인 그룹에 대한 세부 정보 가져오기"
- "ID가 XXXX인 그룹 삭제"
- "그룹 YYYY에 사용자 XXXX 추가"
- "그룹 YYYY에서 사용자 XXXX 제거"
- "'Finance' 그룹의 모든 사용자 나열"
온보딩 자동화
- "CSV 데이터에서 다음 사용자를 가져옵니다: [CSV 콘텐츠]"
- "부서 속성을 기준으로 사용자를 그룹에 할당"
- "이 5명의 사용자에게 애플리케이션 액세스를 제공합니다"
- "[CSV 콘텐츠]"라는 신입사원에 대한 완전한 온보딩 워크플로를 실행합니다.
오류 처리
서버에는 다음에 대한 강력한 오류 처리 기능이 포함되어 있습니다.
- 사용자 또는 그룹을 찾을 수 없습니다(404 오류)
- API 인증 문제
- 사용자 프로필이 누락되었거나 유효하지 않습니다.
- 일반 API 오류
- CSV 구문 분석 문제
- 사용자 속성 매핑 실패
- 애플리케이션 프로비저닝 오류
문제 해결
일반적인 문제
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의 경우:
Windows의 경우:
환경 변수
환경 변수 오류가 발생하는 경우 다음을 확인하세요.
OKTA_ORG_URL
: 전체 URL이어야 합니다(예: " https://dev-123456.okta.com ").OKTA_API_TOKEN
: 유효한 API 토큰이어야 합니다.
보안 고려 사항
- API 토큰을 안전하게 유지하세요
- 버전 제어에 자격 증명을 커밋하지 마세요
- 민감한 데이터에 환경 변수를 사용하세요
- API 토큰을 정기적으로 회전합니다
- Okta 관리 콘솔에서 API 사용 모니터링
- API 호출에 대한 속도 제한 구현
- API 토큰에 필요한 최소 권한 사용
유형
서버에는 Okta 사용자 및 그룹 데이터를 위한 TypeScript 인터페이스가 포함되어 있습니다.
온보딩을 위한 CSV 형식
대량 가져오기 또는 온보딩 워크플로 도구를 사용할 때 CSV에 다음 헤더가 포함되어야 합니다.
firstName
(필수)lastName
(필수)email
(필수)department
(선택 사항)title
(선택 사항)mobilePhone
(선택사항)
예:
특허
MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.
지원하다
문제가 발생할 경우:
- 위의 문제 해결 섹션을 확인하세요
- Claude Desktop 로그 검토
- 서버의 오류 출력을 검사합니다.
- Okta 개발자 문서를 확인하세요
참고사항: PR 환영!
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Claude가 Okta의 사용자 관리 시스템과 상호 작용할 수 있도록 하여 사용자 세부 정보 검색, 필터링 옵션을 사용하여 사용자 목록 작성, 사용자 그룹 관리 기능을 제공합니다.
Related MCP Servers
- AsecurityAlicenseAqualityEnables Claude to interact with Ethereum nodes, allowing users to check ENS token balances, view smart contract code, and decode transactions through natural language.Last updated -51JavaScriptMIT License
- -securityAlicense-qualityEnhances Claude's capabilities by providing access to website analytics data from Umami, enabling analysis of user behavior, website performance tracking, and data-driven insights generation.Last updated -4PythonMIT License
- AsecurityFlicenseAqualityA server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.Last updated -15Python
- -securityFlicense-qualityLets you use Claude Desktop to interact with your task management data in Things app, enabling you to create tasks, analyze projects, manage priorities, and implement productivity workflows through natural language.Last updated -12Python