@agekey/mcp服务器
AgeKey MCP服务器-直接从您的AI IDE管理AgeKey应用程序。
特性
- 🔐 职员OAuth身份验证 --通过浏览器无缝登录
- 🏢 多组织支持 --访问您的所有组织
- 📱 应用程序管理 --创建、列出和管理应用程序
- 🔑 凭证 --获取并轮换测试/实时凭据
- 🔗 重定向URI --添加和删除回调URL
- 🛡️ 基于角色的访问控制 --基于角色的访问控制（成员→ 测试，管理员→ live)
- 🔧 公用事业 --JWT解码器、错误解释器、代码示例
安装
光标IDE
添加到MCP配置(.cursor/mcp.json):
{
"mcpServers": {
"agekey": {
"command": "npx",
"args": ["-y", "@agekey/mcp-server"]
}
}
}克劳德桌面版
添加到您的配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"agekey": {
"command": "npx",
"args": ["-y", "@agekey/mcp-server"]
}
}
}认证
首次使用时，MCP服务器将：
- 打开浏览器进入AgeKey登录页面
- 您通过职员（现有AgeKey帐户）进行身份验证
- 令牌存储在本地
~/.agekey/session.json
无需手动管理令牌！
默认情况下，服务器连接到生产AgeKey开发人员门户。环境配置（staging、dev、local）仅供内部使用，此处没有记录。
可用工具
组织
| 工具 | 说明 |
|---|---|
list_organizations | 列出您有权访问的所有组织 |
应用程序
| 工具 | 说明 |
|---|---|
list_applications | 列出组织中的应用程序 |
get_application | 获取应用程序详细信息 |
create_application | 创建新应用程序（会员+） |
凭证
| 工具 | 说明 |
|---|---|
get_credentials | 获取测试或实时证书 |
rotate_credentials | 轮换凭据（测试：会员+，实时：管理员+并确认） |
重定向URI
| 工具 | 说明 |
|---|---|
add_redirect_uri | 添加回调URI |
remove_redirect_uri | 删除回调URI |
公用事业
| 工具 | 说明 |
|---|---|
decode_jwt | 解码并解释AgeKey JWT |
explain_error | 获取OIDC错误代码的帮助 |
get_code_sample | 获取TypeScript/Python/Go/Java中的集成代码 |
RBAC权限
| 角色 | 测试模式 | 直播模式 |
|---|---|---|
| 查看器 | 只读 | 只读 |
| 成员 | 完全访问权限 | 只读 |
| 管理员 | 完全访问权限 | 完全访问⚠️ |
| 所有者 | 完全访问权限 | 完全访问⚠️ |
⚠️ 直播模式操作需要明确的确认短语。
示例用法
You: "List my AgeKey organizations"
Claude: You have access to 2 organizations:
1. Acme Corp (Owner) - 3 applications
2. Side Project (Admin) - 1 application
You: "Create a new app called 'My Game' in Acme Corp"
Claude: ✅ Created application "My Game"
Test Credentials:
- App ID: ak_test_abc123...
- Secret: sk_test_xyz789... ⚠️ Save this!
Next steps:
1. Add a redirect URI: http://localhost:3000/callback
2. Try it in the sandbox
You: "Rotate live credentials for My Game"
Claude: ⚠️ WARNING: This will rotate LIVE credentials!
To proceed, confirm: "ROTATE LIVE CREDENTIALS"
You: "ROTATE LIVE CREDENTIALS"
Claude: ✅ Live credentials rotated
🚨 Update your production environment NOW!发展
# Install dependencies
pnpm install
# Build
pnpm build
# Run (connects to production portal)
node dist/index.js许可证
麻省理工学院