AWS Cognito MCP 서버

인증 및 사용자 관리를 위해 AWS Cognito에 연결하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버는 가입, 로그인, 비밀번호 관리 등 사용자 인증 흐름을 위한 도구 세트를 제공합니다.

필수 조건

Cognito 사용자 풀이 구성된 AWS 계정
Node.js 18 이상

설치

지엑스피1

AWS Cognito 구성

AWS 콘솔에 로그인하고 Amazon Cognito로 이동합니다.
사용자 풀을 생성하거나 기존 사용자 풀을 사용하세요
사용자 풀 ID와 앱 클라이언트 ID를 기록하세요.
다음 값을 환경 변수 또는 .env 파일로 설정합니다(Claude 코드를 사용할 때만 .env 파일이 필요하고, Claude 데스크톱에서는 필요하지 않습니다).

AWS_COGNITO_USER_POOL_ID=your-user-pool-id
AWS_COGNITO_USER_POOL_CLIENT_ID=your-app-client-id

사용 가능한 도구

도구 이름	설명	매개변수
`sign_up`	새로운 사용자 등록	`email` : 문자열, `password` : 문자열
`sign_up_confirm_code_from_email`	확인 코드로 계정을 확인하세요	`username` : 문자열, `confirmationCode` : 문자열
`sign_in`	사용자 인증	`username` : 문자열, `password` : 문자열
`sign_out`	현재 사용자 로그아웃	없음
`getCurrentUser`	현재 로그인한 사용자 가져오기	없음
`reset_password_send_code`	비밀번호 재설정 코드 요청	`username` : 문자열
`reset_password_veryify_code`	인증코드로 비밀번호 재설정	`username` : 문자열, `code` : 문자열, `newPassword` : 문자열
`change_password`	로그인한 사용자의 비밀번호 변경	`oldPassword` : 문자열, `newPassword` : 문자열
`refresh_session`	인증 토큰을 새로 고칩니다.	없음
`update_user_attributes`	사용자 프로필 속성 업데이트	`attributes` : `{name: string, value: string}` 배열
`delete_user`	현재 로그인한 사용자 삭제	없음
`resend_confirmation_code`	계정 확인 코드 재전송	`username` : 문자열
`verify_software_token`	MFA에 대한 TOTP 확인	`username` : 문자열, `totpCode` : 문자열

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

Claude Desktop과 함께 사용

npx 작동하려면 시작하기 전에 데스크톱에 Node.js가 설치되어 있는지 확인하세요.

이동: 설정 > 개발자 > 구성 편집
claude_desktop_config.json 에 다음을 추가하세요.

{
  "mcpServers": {
    "aws-cognito-mcp-server": {
      "command": "/path/to/mcp-server-aws-cognito/build/index.js",
      "env": {
        "AWS_COGNITO_USER_POOL_ID": "your-user-pool-id",
        "AWS_COGNITO_USER_POOL_CLIENT_ID": "your-app-client-id"
      }
    }
  }
}

Claude Code와 함께 사용

Claude Code는 Claude용 명령줄 인터페이스입니다. Claude Code와 함께 이 MCP 서버를 사용하려면 다음 단계를 따르세요.

Claude Code 문서의 지침에 따라 Claude Code를 설치하세요.
Claude Code에 MCP 서버를 추가합니다.

claude mcp add "aws-cognito-mcp" npx tsx index.ts

추가되었는지 확인하세요:

claude mcp list

MCP 서버로 Claude를 실행하세요.

claude

개발

자동 재빌드를 사용한 개발의 경우:

npm run watch

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector를 사용하면 더 나은 가시성을 확보할 수 있습니다.

npm run inspector

이제 Claude와 함께 AWS Cognito 인증 도구를 사용할 수 있습니다!

AWS Cognito MCP Server

Integrations