• STATUS
  • DETAILS
  • LOGS
  • HUMAN

AIを活用してSSO接続のトラブルシューティングを行う方法

WorkOSをAIクライアントに接続すれば、ログインエラーを迅速に解決できます。データ取得はAIエージェントに任せて、あなたは設定の修正に集中してください。

このページについてAIに聞く

すぐに答え

なぜユーザーがSSOでログインできないのか?

AIがWorkOSからリアルタイムの接続ステータスとメタデータを取得し、SAMLやOIDCの設定ミスを特定します。ハンドシェイクが失敗している箇所を正確に突き止めるため、迅速な修正が可能です。

トラブルシューティングの結果

特定される問題の分類

AIが検出したデータは、以下の項目に分類されます。

STATUS

接続状態の確認

AIがすべての有効なSSOリンクの現在の状態をチェックします。どの接続が稼働しており、どれが切断されているかを明確に把握できます。

DETAILS

メタデータの検証

エージェントが特定の接続に関する詳細な設定情報を取得します。IDPやACS URLに誤りがないかを確認するのに役立ちます。

LOGS

エラーの特定

AIがハンドシェイクの失敗を示す特定のメタデータを解析します。ログイン試行が失敗した正確な理由を明らかにします。

HUMAN

手動での修正が必要

AIが設定の不備を特定します。実際の修正作業は、WorkOSのダッシュボードまたはIDPで行う必要があります。

ワークフロー

問題が発生した際、AIが行うこと

ダッシュボードを何度もクリックする必要はありません。エージェントに問題を伝えるだけで完了します。

  1. 接続のスキャン

    AIがWorkOS環境をスキャンし、問題の原因となっている特定のSSO設定を見つけ出します。

    list_sso_connections
  2. 詳細設定の調査

    問題の接続が見つかると、AIはそのリンクに関する具体的な技術パラメータを取得します。

    get_sso_connection_details
  3. 不一致の分析

    エージェントが取得したメタデータを、トラブルシューティングの要件と比較してエラーを特定します。

    get_sso_connection_details
  4. 修正案の提示

    AIが調査結果をまとめ、IDPのどの設定を変更すべきかを指示します。

    list_sso_connections

試してみる

以下のプロンプトをコピーして開始

これらのプロンプトを使って、トラブルシューティングを開始できます。

出発点

括弧内のテキストを、実際の接続名やエラーの種類に書き換えて使用してください。

WorkOS Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp

Claude Desktop

以下の手順で数秒で接続できます。

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — WorkOS capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "workos-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp"
    }
  }
}
チャットにコピー04
  • すべてのSSO接続をリストアップし、現在無効になっているものがあるか教えてください。

  • 'Acme Corp' のSAML接続の詳細を取得し、ACS URLをチェックしてください。

  • OIDC接続のメタデータをチェックして、クライアントIDが期待通りか確認してください。

  • 'Global Enterprise' という名前のSSO接続を探し、失敗している可能性がある理由を教えてください。

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

ここから始める

WorkOSを一度連携すれば、あとは聞くだけです

WorkOSアカウントをVinkiusにワンクリックで連携。認証情報は暗号化され、AIクライアントがSSOデータに即座にアクセスできるようになります。

WorkOSをAIに連携する

FAQ

機能に関する詳細

  • 01

    AIがSSOの設定を変更することはできますか?

    いいえ。AIができるのは接続リストとメタデータの読み取りのみです。設定の変更はすべてWorkOS上で手動で行う必要があります。

  • 02

    失敗しているSAMLアサーションを修正できますか?

    いいえ。AIは接続詳細を確認してアサーションが失敗していることを特定できますが、アサーション自体を書き換えることはできません。

  • 03

    ユーザーのパスワードは見えますか?

    いいえ。ツールがアクセスするのはSSO接続のメタデータのみであり、個々のユーザーの認証情報やパスワードにはアクセスできません。

  • 04

    どの接続が壊れているかをどうやって判断するのですか?

    接続メタデータを解析し、ログイン失敗の原因となっている設定の不一致を見つけ出します。

  • 05

    新しい接続のセットアップに使用できますか?

    いいえ。この機能は、既存の接続を読み取りツールを使って監査およびトラブルシューティングするためのものです。

  • WorkOSについてさらに詳しく知りたいですか? WorkOS Connectorの全機能を見る

『WorkOS』を Claude、Cursor、ChatGPT などに接続