Auth0 Model Context Protocol (MCP) Server の利用を始める

Auth0 Model Context Protocol (MCP) Server を AIクライアントと連携します。

始める前に

• システムに Node.js v18 以降 をインストールしておきます。
• 管理者権限を持つ有効な Auth0 アカウントを作成しておきます。
• 少なくとも 1 つのサポート対象の MCP クライアント (たとえば Claude Desktop、Cursor、または Windsurf) をインストールしておきます。

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

​

インストールと設定

ターミナルで次のいずれかのコマンドを実行して、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 で認証する

OAuth 2.0 のデバイス認可フローを開始するため、ブラウザーが自動的に開きます。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 テナントの管理についてサポートを依頼します。

​

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

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

​

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

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

npx @auth0/auth0-mcp-server help

​

認証に関する問題

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

npx @auth0/auth0-mcp-server init

​

接続エラー:

1. 次のコマンドで、MCP サーバーが実行中であることを確認します。

   ps aux | grep auth0-mcp
   

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

​

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

1. インストール後に Claude Desktop を再起動します。

2. 次のコマンドで、サーバーが実行中であることを確認します。

   ps aux | grep auth0-mcp
   

​

API エラー：

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

​

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

​

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

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

export DEBUG=auth0-mcp

​

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

Claude Desktopで詳細なMCPクライアントログを取得できます：

# リアルタイムでログを追跡する
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

Auth0 MCP Server をデバッグモードで実行すると、MCP サーバーの詳細なログを取得できます:

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をご覧ください。