Frontegg MCP Server

Frontegg MCP サーバー

96 個のツール — モバイル SDK の監査・修正（47）＋ Frontegg Management API（49）

診断。実際の差分を適用。チャットからテナントを設定。

_{Claude Desktop · Cursor · Claude Code · MCP 対応のあらゆるクライアントで利用できます}

関連リポジトリ：

• 🧠 frontegg/coding-agent-skills — これらのツールをエンドツーエンドで連携させる、トリガーで起動する 27 個のスキル
• 🚀 frontegg/coding-agent-toolkit — 両方を AI クライアントに接続する、ワンコマンドインストーラー

目次

• 主な特徴
• 対応 SDK
• インストール
• 開発
• クイックスタート
• できること
• 使用例
• ツール
• チェック項目
• 設定
• FAQ とトラブルシューティング

主な特徴

対応 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 アプリはシェルの 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. 正式な Frontegg リポジトリを GitHub から取得します
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  ✓

ツール

2 つのインターフェースで計 96 個のツールを利用できます。

2つのサーフェスモデル

このサーバーは、単一の MCP に登録された、明確に異なる2つのツールサーフェスを公開します。

• モバイル／監査サーフェス（47個のツール。frontegg_ プレフィックス付きの snake_case 名） — 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 機能を提供します。上流とすでに連携しているユーザーとの互換性を保つため、ツール名にはケバブケースを使用しています。

ロール（5）

権限（10）

ユーザー（4）

テナント（3）

テナントの一覧表示は、モバイル機能の frontegg_tenants_list で利用できます。

アプリケーション（6）

API トークン（7）

個人用トークン（6）

ベンダー連携（6）

Frontegg 連携（2）

Frontegg 連携の有効化や設定には、その状態の確認を除き、Frontegg ポータルが必要です。v1 の API は読み取り専用です。

チェック内容

135 以上のルールを 4 つのレイヤーでチェックします。

• 検出 — intent-filter、CFBundleURLTypes、Associated Domains、初期化呼び出し、INTERNET 権限、ATS 例外、.gitignore の対象外にある .env の不足
• 設定フラグ — 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 の値をコピーします

どちらも xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 形式の UUID です。

設定しない場合： diagnose / fix ツール（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 に渡されていません。綴りを確認し、設定ファイルの編集後にクライアントを再起動したことを確認してください。

FAQ とトラブルシューティング