AAuth for MCP
TypeScript packages for adding AAuth to MCP servers and agents.
AAuth is an agent-aware authentication protocol that lets AI agents prove their identity and obtain authorization using HTTP Message Signatures and JWTs.
接入你的智能体
发布者自己的命令。不是 PlugMCP 端点。
用我们的密钥与日志托管一份副本。
npx -y @aauth/[email protected]Claude Code 没有针对本地命令的安装链接。复制下方命令并在终端中运行。
claude mcp add aauth-mcp-agent -- npx -y @aauth/mcp-agent@2.0.0在终端中运行。
{ "mcpServers": { "aauth-mcp-agent": { "command": "npx", "args": [ "-y", "@aauth/[email protected]" ] } }}claude_desktop_config.json
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者
TypeScript packages for adding AAuth to MCP servers and agents.
AAuth is an agent-aware authentication protocol that lets AI agents prove their identity and obtain authorization using HTTP Message Signatures and JWTs.
Authenticated MCP transport with HTTP Signatures for AAuth agents
| Package | Description |
|---|---|
@aauth/bootstrap | CLI for setting up AAuth agent keys, person server registration, and hosting |
@aauth/fetch | CLI for making AAuth-authenticated HTTP requests |
@aauth/protocol | Wire format: AAuth-Requirement, AAuth-Capabilities, access_mode planning, typ/dwk constants |
@aauth/agent | Agent-side AAuth: signed fetch, person tokens, challenge-response, token exchange |
@aauth/resource | Resource-side AAuth: token verification, challenge building, resource tokens, R3 |
@aauth/local-keys | Library for managing AAuth agent signing keys across hardware and software backends |
@aauth/hardware-keys | Native bindings for YubiKey PIV and macOS Secure Enclave |
@aauth/mcp-stdio | stdio-to-HTTP proxy with AAuth signatures |
@aauth/mcp-openclaw | OpenClaw plugin for AAuth-authenticated MCP connections |
Agent Resource Server Auth Server
| | |
|--- signed request ------------>| |
| | |
|<-- 401 + resource_token -------| |
| + auth-server URL | |
| | |
|--- signed POST (resource_token) ------------------------->|
| |
|<-- auth_token --------------------------------------------|
| | |
|--- signed request ------------>| |
| + auth_token | |
| |-- verify signature |
| |-- verify auth_token |
| |-- check key binding |
|<-- 200 OK ---------------------| |
resource_token and auth server URLresource_token at the auth server (signed request)auth_token (or 202 for interactive flows)auth_token — resource verifies signature, token, and key bindingAll requests are signed with HTTP Message Signatures (RFC 9421) using Ed25519. Tokens are JWTs with aa-agent+jwt, aa-auth+jwt, and aa-resource+jwt types.
import { createAAuthFetch } from '@aauth/mcp-agent'
const fetch = createAAuthFetch({
getKeyMaterial: async () => ({
signingKey: privateKeyJwk,
signatureKey: { type: 'jwt', jwt: agentToken }
})
})
const response = await fetch('https://resource.example/api')
// Handles 401 challenges, token exchange, and retry automatically
import { verifyToken, buildAAuthHeader, createResourceToken } from '@aauth/mcp-server'
// Verify an incoming signed request's token
const result = await verifyToken({ jwt, httpSignatureThumbprint })
// Build a 401 challenge
const header = buildAAuthHeader('auth-token', { resourceToken, authServer })
// Create a resource token for the challenge
const token = await createResourceToken({ resource, authServer, agent, agentJkt }, sign)
# Register an agent provider: generate a key, bind it, and bind the default
# person server (person.hello.coop)
npx @aauth/bootstrap create <your-agent-provider-url>
See @aauth/bootstrap for the full setup flow.
This implementation covers the core AAuth protocol flows. The following spec features are not yet supported:
upstream_tokenrequirement=claims for identity claim exchangeThe AAuth protocol specification: github.com/dickhardt/AAuth
MIT
Authenticated MCP transport with HTTP Signatures for AAuth agents
{ "mcpServers": { "aauth-mcp-agent": { "command": "npx", "args": [ "-y", "@aauth/[email protected]" ] } }}工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
@aauth/mcp Agent 通过 stdio 在本地运行。
上次检查时间:2026-11-10。 Authenticated MCP transport with HTTP Signatures for AAuth agents