Frontegg MCP Server

Frontegg MCP Server

96 个工具 — 移动 SDK 审计/修复（47 个）+ Frontegg Management API（49 个）

诊断。应用实际差异。从聊天中配置你的租户。

_{适用于 Claude Desktop · Cursor · Claude Code · 任何兼容 MCP 的客户端}

配套仓库：

• 🧠 frontegg/coding-agent-skills — 27 个由触发条件激活的技能，可端到端编排这些工具
• 🚀 frontegg/coding-agent-toolkit — 一键安装程序，可将两者接入你的 AI 客户端

目录

• 亮点
• 支持的 SDK
• 安装
• 开发
• 快速入门
• 你可以向它提出什么要求
• 示例
• 工具
• 检查内容
• 配置
• 常见问题与故障排查

亮点

支持的 SDK

平台	权威仓库	覆盖情况
Android（Kotlin）	frontegg/frontegg-android-kotlin	完整
iOS（Swift）	frontegg/frontegg-ios-swift	完整
Flutter	frontegg/frontegg-flutter	完整
React Native	frontegg/frontegg-react-native	完整
Ionic / Capacitor	frontegg/frontegg-ionic-capacitor	完整

安装

此服务可独立安装，无需其他 Frontegg 工具。该软件包发布在 npm 上，名称为 @frontegg/frontegg-mcp-server。直接将其接入任意兼容 MCP 的客户端；首次运行时，npx 会获取最新版本。

⚠️ 版本说明。 此分支 / PR 的版本是 2.0.0（96 个工具——移动端 + 平台）。npm 当前提供的是合并前的 1.0.1（仅包含 49 个平台工具）。在 PR #24 合并且 2.0.0 发布到 npm 之前，运行 npx --yes @frontegg/frontegg-mcp-server 会获取 1.0.1。如需立即使用完整的 96 个工具，请使用下方的开发克隆并构建流程。

需要租户配置工具（MFA、SSO、用户、品牌设置、审计日志等）？ 在客户端的 MCP 配置中设置 FRONTEGG_CLIENT_ID + FRONTEGG_API_KEY 环境变量。诊断 / 修复工具无需这些变量即可使用。在哪里查找 Frontegg 凭据，请参阅配置。

{
  "mcpServers": {
    "frontegg": {
      "command": "npx",
      "args": ["--yes", "@frontegg/frontegg-mcp-server"],
      "env": {
        "FRONTEGG_CLIENT_ID": "your-client-id",
        "FRONTEGG_API_KEY": "your-api-secret"
      }
    }
  }
}

claude mcp add frontegg \
  -e FRONTEGG_CLIENT_ID=your-client-id \
  -e FRONTEGG_API_KEY=your-api-secret \
  -- npx --yes @frontegg/frontegg-mcp-server

npx @frontegg/coding-agent-toolkit init

开发

要从源代码构建（用于贡献或运行分支版本）：

git clone https://github.com/frontegg/frontegg-mcp-server.git
cd frontegg-mcp-server
npm install
npm run build              # tsc → dist/
npm test                   # 215 jest + 89 vitest

将客户端指向 node /absolute/path/to/frontegg-mcp-server/dist/index.js，即可测试本地更改。

使用 nvm？ GUI 应用不会继承 shell 的 PATH。请使用 which node 返回的绝对路径。

快速开始

打开你的移动项目。向助手提问：

Use frontegg_auto on this project and tell me what's wrong with my Frontegg setup.

MCP 将会：

1. 检测你的 SDK（Android / iOS / Flutter / RN / Ionic）
2. 获取 GitHub 上的规范 Frontegg 仓库
3. 诊断项目——按深层链接、初始化、身份验证、构建、安全性归类检查结果
4. 生成基于官方 example/ 应用的统一差异
5. 按需应用，使用 frontegg_apply_diff

反复迭代，直到没有问题。

可以向它询问什么

无需工具名称。使用自然语言即可：

示例

npm run demo:rn

npm run demo:flutter

npm run demo:ionic

npm run demo:security

> frontegg_configure_mfa action=get

  enforceMFAType: DontForce
  allowRememberMyDevice: true
  mfaDeviceExpiration: 1209600

> frontegg_configure_mfa action=update enforceMFAType=ForceExceptSAML

  enforceMFAType: ForceExceptSAML  ✓

工具

两个界面共提供 96 个工具。

双表面模型

此服务会将两个不同的工具表面注册到同一个 MCP 中：

• 移动端 / 审计表面（47 个工具，名称采用 snake_case，并带有 frontegg_ 前缀）——诊断 / 修复 SDK 集成问题、配置租户、审计用户活动。最初名为 frontegg-mobile-mcp-server。
• 平台表面（49 个工具，名称采用 kebab-case）——对 Frontegg 角色、权限、应用、用户、租户、供应商集成和 API 令牌执行完整的 CRUD 操作。导入自 frontegg/frontegg-mcp-server。

两个表面共用 FRONTEGG_CLIENT_ID 和 FRONTEGG_API_KEY（别名为 FRONTEGG_SECRET_KEY）凭据。为避免破坏任一上游项目现有的集成，v1 使用了不同的命名约定；未来的 v2 可能会统一命名。

移动端 / 审计表面（47 个工具）

诊断与修复（10 个）

CIAM 功能指南（1 个）

身份验证（1 个，可选）

租户配置（10 个）

调用 Frontegg Management API。需要 FRONTEGG_CLIENT_ID 和 FRONTEGG_SECRET（参见配置）。

用户、租户、RBAC、审计（11 个）

应用、Webhook、权限和 API 令牌（10）

每个 API 工具：action="get"（或 "list"）用于读取，action="update"（或 "create"）用于写入。

已知限制

部分工具仅提供部分功能，因为 Frontegg 供应商令牌 API 未开放所需接口：

• frontegg_configure_sessions 的写入操作可能会静默无效果
• frontegg_configure_security_rules 的写入操作需要真实的 reCAPTCHA 密钥
• frontegg_email_templates_* 在供应商令牌下会返回 404（需要租户级管理员权限）
• frontegg_user_mfa_enforce — 未开放单用户接口
• frontegg_plan_feature_attach 的写入操作可能无效果
• frontegg_configure_sso 可以列出和创建，但无法删除或停用

每个受影响工具的 description 字段都会标明限制，以便 LLM 在有替代方案时选择其他工具。

平台功能（49 个工具）

从 frontegg/frontegg-mcp-server 导入——全面支持对 Frontegg 管理平面的 CRUD 操作。工具名称采用 kebab-case，以确保与已集成上游的用户兼容。

角色（5 个）

权限（10 个）

用户（4 个）

租户（3 个）

可通过移动端功能中的 frontegg_tenants_list 列出租户。

应用（6 个）

API 令牌（7）

个人令牌（6）

供应商集成（6）

Frontegg 集成（2）

除读取状态外，激活或配置 Frontegg 集成需要使用 Frontegg 门户 — v1 中的 API 仅支持读取。

检查内容

135 条以上规则，涵盖四个层面：

• 检测 — 缺少 intent-filter、CFBundleURLTypes、Associated Domains、初始化调用、INTERNET 权限、ATS 例外、.env 未列入 .gitignore
• 配置标志 — embeddedMode、lateInit、useAssetsLinks、useChromeCustomTabs、enableOfflineMode、enableSessionPerTenant、useLegacySocialLoginFlow，以及各 SDK 的数十项其他配置
• 建议（真实支持案例） — 冷启动深层链接崩溃、刷新令牌致命错误、Doze Mode、R8/ProGuard 剥离、租户权限泄漏、WebView 问题
• CIAM 功能 — Apple/Google 社交登录、通行密钥（webcredentials: / asset links）、升级验证、SSO、会话、令牌、SMS、密码策略

在项目中运行 list_rules — 只会显示相关规则。传入 all: true 可查看完整目录。

配置

可选（所有工具）

GITHUB_TOKEN=ghp_xxx           # Lifts GitHub rate limits — recommended for heavy use
LOG_LEVEL=info                 # error | warn | info | debug

Frontegg 凭据（仅租户配置工具）

frontegg_configure_*、users、tenants、roles、audit_logs、branding、webhooks、applications、features、plans、api_tokens 和 user_sessions / user_mfa 管理工具需要供应商凭据：

FRONTEGG_CLIENT_ID=your-client-id   # UUID — your Frontegg environment's client ID
FRONTEGG_SECRET=your-api-secret     # UUID — your Frontegg environment's API key

在 Frontegg 门户中查找凭据：

1. 登录 https://portal.frontegg.com
2. 选择要管理的工作区和环境
3. 前往 ⚙️ Settings → Workspace Settings → Environment（不同门户版本中的路径可能略有不同；如果找不到，请搜索“API Key”或“Client ID”）
4. 复制 Client ID 和 API Key 值

两者都是 UUID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

**没有这些凭据时：**诊断 / 修复工具（analyze_repo、apply_diff、feature_guide 等）仍可正常工作。只有租户 API 工具会报错。

填写位置：

• MCP 服务目录中的 .env 文件（适用于本地开发）
• MCP 客户端的配置（Cursor ~/.cursor/mcp.json、Claude Desktop claude_desktop_config.json 等）——推荐：

{
  "mcpServers": {
    "frontegg-mobile": {
      "command": "node",
      "args": ["/absolute/path/to/frontegg-mcp-server/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxx",
        "FRONTEGG_CLIENT_ID": "your-client-id",
        "FRONTEGG_SECRET": "your-api-secret"
      }
    }
  }
}

验证凭据是否有效——在 MCP 客户端的聊天中询问：

Use frontegg_configure_mfa with action=get to read my tenant's MFA policy.

成功时会返回当前 MFA 配置。如果出现类似 “FRONTEGG_CLIENT_ID and FRONTEGG_SECRET environment variables are required” 的错误，说明环境变量没有传递到 MCP；请仔细检查拼写，并确认修改配置后已重启客户端。

常见问题与故障排除