关于 Authn8
Authn8 是一个 MCP 服务,供 AI Agent 使用个人访问令牌访问 Authn8 管理的 2FA 账户。它可列出可访问账户、生成 TOTP 验证码并返回令牌信息,同时为客户端提供结构化结果。
主要功能
- 01列出令牌可访问的账户
- 02按账户 ID 或名称生成 TOTP 验证码
- 03报告账户名称匹配不唯一的情况
- 04显示令牌及其授权组信息
- 05返回结构化工具结果
适用场景
- 01获取某账户的 TOTP 验证码
- 02按名称查找可访问的 2FA 账户
- 03检查令牌身份和账户范围
MCP 相关
将 Authn8 账户列表、TOTP 生成和令牌信息作为 MCP 工具公开。通过 AUTHN8_API_KEY 提供 Authn8 个人访问令牌进行身份验证。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
@authn8/mcp-server
通过 PAT 身份验证,为 AI Agent 提供访问 Authn8 双重身份验证代码的 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
返回此令牌可访问的所有双重身份验证账户。
响应示例:
{
"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
}
链接
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。