Authn8

공식

AI 에이전트에서 비밀을 공유하지 않고 팀의 2FA 코드에 접근하세요. 계정 목록 확인, TOTP 코드 생성, 전체 감사 추적 유지

GitHub이 MCP 사용해 보기스폰서

Authn8 MCP(으)로 무엇을 할 수 있나요?

  • 2FA 계정 목록 보기 — 어시스턴트에게 list_accounts를 호출하여 토큰으로 접근 가능한 모든 2FA 계정을 확인하도록 요청하세요.
  • TOTP 코드 생성 — get_otp를 계정 이름이나 ID와 함께 사용하여 현재 일회용 코드를 받으세요.
  • 모호한 일치 항목 해결 — get_otp가 여러 일치 항목을 반환하면 계정 ID로 다시 시도하세요.
  • 토큰 세부 정보 확인 — whoami를 호출하여 토큰 이름, 비즈니스, 범위가 지정된 그룹, 만료일 및 계정 수를 확인하세요.

문서

@authn8/mcp-server

PAT 인증을 통해 AI 에이전트가 Authn8 2FA 코드에 접근할 수 있게 해주는 MCP 서버입니다.

사전 요구 사항

  • Authn8 계정
  • Authn8 대시보드에서 생성한 Personal Access Token(PAT)

빠른 시작

npx @authn8/mcp-server

AUTHN8_API_KEY 환경 변수를 PAT 토큰으로 설정하세요.

Docker

docker run -e AUTHN8_API_KEY=pat_xxx ghcr.io/authn8/mcp-server

구성

Claude Desktop

Claude Desktop 구성 파일에 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "authn8": {
      "command": "npx",
      "args": ["-y", "@authn8/mcp-server"],
      "env": {
        "AUTHN8_API_KEY": "pat_your_token_here"
      }
    }
  }
}

Claude Code (CLI)

Claude Code 구성 파일에 추가하세요:

macOS: ~/.claude.json Windows: %USERPROFILE%\.claude.json

{
  "mcpServers": {
    "authn8": {
      "command": "npx",
      "args": ["-y", "@authn8/mcp-server"],
      "env": {
        "AUTHN8_API_KEY": "pat_your_token_here"
      }
    }
  }
}

Cursor

Cursor MCP 설정에 추가하세요:

{
  "mcpServers": {
    "authn8": {
      "command": "npx",
      "args": ["-y", "@authn8/mcp-server"],
      "env": {
        "AUTHN8_API_KEY": "pat_your_token_here"
      }
    }
  }
}

환경 변수

변수필수기본값설명
AUTHN8_API_KEY예-Authn8의 PAT 토큰
AUTHN8_API_URL아니요https://api.authn8.comAPI 엔드포인트 URL

사용 가능한 도구

모든 도구는 출력 스키마를 선언하고 텍스트 블록과 함께 structuredContent을 반환하므로, 클라이언트는 텍스트에서 JSON을 다시 파싱하지 않고도 타입이 지정된 결과를 얻을 수 있습니다.

list_accounts

이 토큰으로 접근 가능한 모든 2FA 계정을 반환합니다.

응답 예시:

{
  "accounts": [
    {
      "id": "924c52a6-4457-4970-a39f-4dc620217683",
      "name": "AWS Production",
      "issuerDomain": "amazon.com"
    }
  ]
}

get_otp

특정 계정에 대한 TOTP 코드를 생성합니다.

매개변수:

  • account_id (문자열, 선택 사항) - 계정의 UUID
  • account_name (문자열, 선택 사항) - 검색할 이름 또는 발급자 도메인 (대소문자 구분 없는 부분 일치)

account_id 또는 account_name 중 하나를 제공하세요. 이름과 일치하는 계정이 여러 개인 경우, 도구는 multipleMatches에 계정들을 반환하므로 account_id으로 다시 시도할 수 있습니다.

응답 예시:

{
  "name": "AWS Production",
  "code": "483920",
  "length": 6
}

모호한 일치:

{
  "error": "Multiple accounts match 'aws'. Please be more specific or use account_id.",
  "length": 0,
  "multipleMatches": [
    {
      "id": "924c52a6-4457-4970-a39f-4dc620217683",
      "name": "AWS Production",
      "issuerDomain": "amazon.com"
    }
  ]
}

whoami

현재 토큰에 대한 정보를 반환합니다.

응답 예시:

{
  "tokenName": "MCP Server 2",
  "businessName": "Bytecode Solutions",
  "scopedGroups": [
    { "id": "cfeba14a-e990-49e8-b6e5-61d63f7d68c8", "name": "HR" }
  ],
  "expiresAt": "2025-12-25T23:59:59Z",
  "accountCount": 1
}

링크