AI导哈

应用管理服务

AgeKey MCP Server是一款用于直接从AI IDE管理AgeKey应用的服务，支持多组织访问、应用管理、凭证获取与轮换、重定向URI管理等功能。

  • by CadamTech
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 CadamTech/agekey-mcp

使用说明

@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服务器将：

  1. 打开浏览器进入AgeKey登录页面
  2. 您通过职员（现有AgeKey帐户）进行身份验证
  3. 令牌存储在本地 ~/.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

许可证

麻省理工学院

相关 MCP