メインコンテンツへスキップ

開始する前に

Auth0 Model Context Protocol (MCP) Server をインストールし、広く利用されている複数の MCP クライアント と連携することで、チームやユーザーが AI をより活用できるようになります。

​
インストールと設定

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

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

npx @auth0/auth0-mcp-server init

​
Cursor を使用する場合

npx @auth0/auth0-mcp-server init --client cursor

​
Windsurf を使用する場合

npx @auth0/auth0-mcp-server init --client windsurf

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

Auth0 MCP Server を他の MCP クライアントで使用するには、この設定をクライアントに手動で追加し、変更を反映するために再起動してください。 
{
  "mcpServers": {
    "auth0": {
      "command": "npx",
      "args": ["-y", "@auth0/auth0-mcp-server", "run"],
      "capabilities": ["tools"],
      "env": {
        "DEBUG": "auth0-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を再起動します。
  2. CursorでSettings > MCPを開き、MCP Serversの一覧にAuth0が表示されていることを確認します。
  3. Cursorとの会話を開始し、Auth0テナントの管理についてサポートを求めます。

​
Windsurf

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

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

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

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

次のコマンドを使用して、サポートされているコマンドの一覧と使用例を表示します: 
npx @auth0/auth0-mcp-server help

​
認証に関する問題

Auth0テナントで適切な権限が設定されていることを確認し、以下を使用して再初期化してみてください。 
npx @auth0/auth0-mcp-server init

​
接続の失敗:

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

​
Claude がサーバーに接続できない場合:

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

​
API エラー:

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

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

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

詳細なログを表示するには、デバッグモードを有効にしてください。 
export DEBUG=auth0-mcp

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

Claude Desktop で詳細な MCP クライアントログを取得するには、次の手順に従います: 
# リアルタイムでログを追跡する
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log
Auth0 MCP Server をデバッグモードで実行して、MCP Server の詳細なログを取得します。 
DEBUG=auth0-mcp npx @auth0/auth0-mcp-server run

​
MCP Inspector を使用した詳細なデバッグ

より高度なトラブルシューティングには、MCP Inspector を使用します。 
npx @modelcontextprotocol/inspector -e DEBUG='auth0-mcp' @auth0/auth0-mcp-server run__text in bold__

​
次のステップ

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