Skip to main content

始める前に

Auth0 Model Context Protocol (MCP) Server をインストールし、よく使われている複数の MCP クライアント と連携することで、チームやユーザーの活用の幅を広げましょう。

​
インストールと設定

ターミナルで次のいずれかのコマンドを実行して、Auth0 MCP Serverをインストールします。

​
Claude Desktop の場合 (デフォルト)

​
Cursor の場合

​
Windsurf向け

​
VS Code の場合

設定スコープの選択を求められます。
  • Global: すべての VS Code インスタンスで利用できます。
  • Workspace: 特定のプロジェクトまたはリポジトリでのみ利用できます。
選択内容に応じて、コマンドが適切な mcp.json ファイルを自動的に設定します。

​
Claude Code の場合

設定スコープを選択するよう求められます。
  • User: ~/.claude.json に書き込まれ、すべてのプロジェクトで利用できます。
  • Project: 現在のプロジェクト内でのみ利用できます。

​
Gemini CLI の場合

​
その他のMCPクライアント

Auth0 MCP Serverを他のMCPクライアントで使用するには、この設定をクライアントに手動で追加し、変更を反映させるために再起動してください。

​
Auth0 で認証する

のデバイスを開始するため、ブラウザーが自動的に開きます。Auth0 アカウントにログインし、求められたアクセス許可を付与してください。
資格情報はシステムのキーチェーンに安全に保存されます。必要に応じて、キーチェーン管理ツールで保存を確認できます。

​
連携を確認する

​
Claude Desktop

  1. 新しくインストールした Auth0 MCP Server が確実に認識されるよう、Claude Desktop を再起動します。
  2. Claude Desktop で Tools アイコンをクリックし、Auth0 のツール (たとえば auth0_create_action や auth0_delete_application) が Available MCP Tools の一覧に表示されていることを確認します。
  3. Claude Desktop との会話を開始し、Auth0 テナントの管理についてサポートを求めます。

​
Cursor

  1. 新しくインストールした Auth0 MCP Server を Cursor が認識するよう、Cursor を再起動します。
  2. Cursor で 設定 > MCP を開き、MCP Servers の一覧に Auth0 が表示されていることを確認します。
  3. Cursor との会話を開始し、Auth0 テナントの管理についてサポートを依頼します。

​
Windsurf

  1. 新しくインストールした Auth0 MCP Server を Windsurf で認識させるため、Windsurf を再起動します。
  2. Windsurf で Windsurf 設定 > Cascade を開き、Model Context Protocol (MCP) Servers の一覧に Auth0 が表示されていることを確認します。
  3. Windsurf との会話を開始し、Auth0 テナントの管理についてサポートを依頼します。

​
VS Code

  1. VS Code を再起動し、新しくインストールした Auth0 MCP Server が認識されるようにします。
  2. VS Code で Copilot Chat をエージェントモードで開き、Auth0 のツールが利用できることを確認します。
  3. 会話を開始し、Auth0 テナントの管理について支援を求めてみましょう。

​
Claude Code

  1. Claude Code を再起動して、新しくインストールした Auth0 MCP Server が認識されるようにします。
  2. セッション内で Auth0 のツール (例: auth0_create_action や auth0_list_applications) が利用できることを確認します。
  3. Claude Code との会話を開始し、Auth0 テナントの管理について支援を依頼します。

​
Gemini CLI

  1. Gemini CLI を再起動し、新しくインストールした Auth0 MCP Server が認識されるようにします。
  2. Gemini CLI との対話を開始し、Auth0 テナントの管理について依頼してみましょう。

​
一般的なトラブルシューティング手順

接続に関する問題の多くは、Auth0 MCP Server を設定し、MCP クライアントを再起動することで解決できます。

​
コマンドラインヘルプを表示:

次のコマンドで、利用可能なコマンドの一覧と使用例を確認できます。

​
認証に関する問題

Auth0 テナントで適切な権限が設定されていることを確認し、次の方法で再初期化をお試しください：

​
接続エラー:

  1. 次のコマンドで、MCP サーバーが実行中であることを確認します。
  2. サーバーが実行中であることを確認したら、AI クライアントを再起動します。

​
Claude がサーバーに接続できないエラー:

  1. インストール後に Claude Desktop を再起動します。
  2. 次のコマンドで、サーバーが実行中であることを確認します。

​
API エラー：

Auth0のトークンの権限と有効期限を確認してください。詳細なログを確認するには、デバッグモードを有効にしてください (以下を参照) 。

​
設定の問題をデバッグする

​
デバッグモードを有効にする

詳細なログを表示するには、デバッグモードを有効にします：

​
MCPクライアントログのデバッグ

Claude Desktopで詳細なMCPクライアントログを取得できます：
Auth0 MCP Server をデバッグモードで実行すると、MCP サーバーの詳細なログを取得できます:

​
MCP Inspector を使用した高度なデバッグ

高度なトラブルシューティングには、MCP Inspector を使用してください。

​
次のステップ

Auth0 Model Context Protocol (MCP) Server Tools ReferenceにアクセスしてAuth0 MCP Serverの全機能を確認するか、実践的な例やユースケースについてはAuth0 Model Context Protocol Server Guidesをご覧ください。