Authn8 について
Authn8は、Personal Access Tokenを使ってAIエージェントからAuthn8管理下の2FAアカウントへアクセスするMCPサーバーです。利用可能なアカウントの一覧表示、TOTPコード生成、トークン情報の取得ができ、構造化された結果を返します。
主な機能
- 01トークンで利用可能なアカウントの一覧表示
- 02アカウントIDまたは名前によるTOTPコード生成
- 03名前の一致候補が複数ある場合の通知
- 04トークンとスコープ対象グループの情報表示
- 05構造化されたツール出力
活用シーン
- 01アカウントのTOTPコード取得
- 02名前による利用可能な2FAアカウントの検索
- 03トークンの識別情報とアカウント範囲の確認
MCP 対応
Authn8のアカウント一覧、TOTP生成、トークン情報をMCPツールとして公開します。AUTHN8_API_KEYにAuthn8のPersonal Access Tokenを設定して認証します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
@authn8/mcp-server
PAT 認証を通じて、AI エージェントが Authn8 の 2FA コードにアクセスできる MCP サーバーです。
前提条件
- Authn8 アカウント
- Authn8 ダッシュボードで作成したパーソナルアクセストークン(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.com | API エンドポイントの URL |
利用可能なツール
すべてのツールは出力スキーマを宣言し、テキストブロックとともにstructuredContentを返すため、クライアントはテキストから JSON を再解析することなく、型付きの結果を取得できます。
list_accounts
このトークンでアクセスできるすべての 2FA アカウントを返します。
応答例:
{
"accounts": [
{
"id": "924c52a6-4457-4970-a39f-4dc620217683",
"name": "AWS Production",
"issuerDomain": "amazon.com"
}
]
}
get_otp
指定したアカウントの TOTP コードを生成します。
パラメーター:
account_id(文字列、任意)- アカウントの UUIDaccount_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
}
リンク
- Authn8 - アカウントを作成し、2FA トークンを管理します
- GitHub リポジトリ
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。