• STATUS
  • DETALHES
  • LOGS
  • HUMAN

Como resolver erros de conexão SSO com seu AI

Conecte o WorkOS ao seu cliente de IA para transformar erros de login em soluções práticas. Seu agente busca os dados para que você foque apenas na configuração.

Pergunte à IA sobre esta página

Resposta rápida

Por que meus usuários não conseguem logar via SSO?

Sua IA extrai o status da conexão e os metadados do WorkOS em tempo real para encontrar configurações incorretas de SAML ou OIDC. Ela identifica exatamente onde o handshake falhou para que você possa corrigir.

Resultados do diagnóstico

Onde cada problema é resolvido.

A IA categoriza os dados encontrados nestes resultados específicos.

STATUS

Verificação de saúde

A IA checa o estado atual de todos os links SSO ativos. Você visualiza claramente quais conexões estão funcionando ou quebradas.

DETALHES

Inspeção de metadados

O agente busca detalhes técnicos de uma conexão específica. Isso ajuda a verificar se um IDP ou uma URL de ACS está errada.

LOGS

Identificação de erros

A IA busca metadados que apontam para falhas no handshake, destacando o motivo exato de uma tentativa de login ter falhado.

HUMAN

Ações manuais necessárias

A IA aponta onde a configuração está errada. Você precisará acessar o painel do WorkOS ou seu IDP para aplicar as mudanças.

O fluxo

O que sua IA faz quando o problema surge.

Em vez de navegar por vários painéis, basta descrever o problema para o seu agente.

  1. Escanear conexões

    A IA vasculha seu ambiente WorkOS para encontrar a configuração de SSO que está causando o erro.

    list_sso_connections

  2. Análise detalhada

    Ao encontrar a conexão com problema, a IA extrai os parâmetros técnicos específicos daquele link.

    get_sso_connection_details

  3. Analisar divergências

    O agente compara os metadados obtidos com os requisitos de login para localizar o erro.

    get_sso_connection_details

  4. Relatar a correção

    A IA resume o que encontrou e indica qual configuração precisa ser alterada no seu IDP.

    list_sso_connections

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar uma sessão de diagnóstico.

Pontos de partida

Substitua o texto entre colchetes pelos nomes das suas conexões ou tipos de erro específicos.

WorkOS Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  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.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "workos-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_rwxMA9lZDQOsPAB4YWRqrtYcwkF7I80gqKgTYNRP/mcp"
    }
  }
}
Copie no chat04

  • Liste todas as minhas conexões SSO e me diga se alguma está inativa.

  • Pegue os detalhes da conexão SAML 'Acme Corp' e verifique a URL de ACS.

  • Verifique os metadados da minha conexão OIDC para ver se o client ID está correto.

  • Encontre a conexão SSO chamada 'Global Enterprise' e me diga por que ela pode estar falhando.

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

Comece aqui

Conecte o WorkOS uma vez e pronto.

Vincule sua conta WorkOS ao Vinkius com um clique. Suas credenciais ficam criptografadas e sua IA ganha acesso imediato aos dados de SSO.

Conectar WorkOS ao seu AI

FAQ

Como funciona esta tarefa.

  • 01

    A IA pode alterar minhas configurações de SSO?

    Não. A IA apenas lê as listas de conexões e os metadados. Você deve fazer todas as alterações de configuração manualmente no WorkOS.

  • 02

    Ela consegue corrigir uma asserção SAML quebrada?

    Não. A IA pode identificar que uma asserção está falhando ao analisar os detalhes da conexão, mas não pode reescrever a asserção em si.

  • 03

    Ela tem acesso às senhas dos meus usuários?

    Não. As ferramentas acessam apenas os metadados da conexão SSO, não as credenciais ou senhas individuais dos usuários.

  • 04

    Como ela sabe qual conexão está com erro?

    Ela utiliza os metadados da conexão para encontrar divergências na configuração que causam as falhas de login.

  • 05

    Posso usar isso para configurar uma nova conexão?

    Não. Esta tarefa específica serve para auditar e diagnosticar conexões já existentes usando as ferramentas de leitura disponíveis.

  • Mais dúvidas sobre o WorkOS? Veja tudo o que o conector WorkOS pode fazer

Conecte WorkOS ao Claude, Cursor, ChatGPT e outros