Ir al contenido
Prysm:ID Docs

Conectar Claude Code en 60 segundos

Configurar Prysm:ID desde Claude Code es literalmente “copy + paste”. El dashboard genera un prompt instructivo personalizado para tu workspace, y el agente sigue los pasos hasta dejar el MCP server registrado, autenticado y tu workspace listo para integrar.

  1. Creá un workspace.

    Si todavía no tenés uno, andá a app.prysmid.com y creá un workspace (slug + display name + plan). El provisioning toma ~30 segundos. Cuando esté en estado active, seguí.

  2. Copiá el prompt desde el dashboard.

    En la pestaña Overview o Workspaces vas a ver una sección “Connect your agent”. Elegí el workspace, idioma (ES o EN) y dale click a “Copy setup prompt” en la tarjeta de Claude Code.

    El prompt ya viene con tu display_name, slug y auth_domain interpolados — no hay placeholders por completar.

  3. Pegalo en una sesión nueva de Claude Code.

    Abrí Claude Code en una carpeta cualquiera y pegá el prompt completo. El agente va a:

    • Verificar Node ≥ 20 y el CLI claude
    • Hacer backup de tu ~/.claude.json
    • Registrar el MCP server con claude mcp add --scope user prysmid -- npx -y @prysmid/mcp
    • Completar el device flow (URL + código de 8 caracteres XXXX-XXXX que confirmás en el browser). Si tu agente puede correr procesos shell en background, lo hace solo y te muestra URL + código directo en el chat. Si no, te pide abrir una terminal y correr npx -y @prysmid/mcp una vez.
    • Pedirte que reinicies Claude Code para que cargue el MCP
    • Validar que las tools aparezcan y autenticación esté OK

  4. El agente continúa con el setup conversacional.

    Una vez que el MCP está conectado, el mismo prompt sigue guiando al agente para:

    • Llamar prysmid_setup_check y mostrarte qué falta
    • Pedirte credenciales OAuth de Google (si querés Google login) y configurarlo con enable_google_login
    • Crear la OIDC app de tu producto con create_oidc_app
    • Generar el wiring para tu framework (Next.js + Auth.js, FastAPI + Authlib, etc) en tu repo, incluyendo .env.local con PRYSMID_ISSUER, PRYSMID_CLIENT_ID, PRYSMID_CLIENT_SECRET, PRYSMID_REDIRECT_URI
    • Volver a llamar prysmid_setup_check y reportar verdict: ready cuando todo está conectado

    Tu rol durante este proceso: pegarle credenciales cuando las pida y confirmar acciones destructivas. El agente no inventa redirect URIs ni nombres de app — pregunta.

Otros agentes (Antigravity, Cursor, etc.)

Sección titulada «Otros agentes (Antigravity, Cursor, etc.)»

El dashboard también tiene un prompt para Google Antigravity (mismo flujo, diferente comando de registro). Para clientes MCP genéricos (Cursor, Claude Desktop, otros), el panel tiene un snippet JSON manual:

{
  "mcpServers": {
    "prysmid": {
      "command": "npx",
      "args": ["-y", "@prysmid/mcp"]
    }
  }
}

Pegalo en el config de tu cliente MCP, reiniciá, y la primera tool call dispara el device flow.

Si algo falla

Sección titulada «Si algo falla»

El agente reporta 401 Unauthorized en la primera tool call. El device flow no completó. Volvé al paso del prompt que dice “abrir terminal y correr npx -y @prysmid/mcp” — confirmá la URL en el browser, esperá a ver device flow login complete en la terminal.

claude mcp list muestra prysmid: ✗ Failed. Verificá Node ≥ 20 (node --version) y conectividad a npm (npm ping). El MCP no puede arrancar sin esos dos.

La sesión de Claude Code se queda colgada sin pedir device flow. Claude Code arranca el MCP como subprocess stdio y stderr no es un TTY, así que el prompt de device flow no aparece a menos que lo pre-caches en una terminal real. El prompt del dashboard incluye este paso explícitamente — seguilo en orden.

El agente quiere borrar algo (delete_workspace, delete_oidc_app, delete_idp). Esos tools requieren confirmación explícita tuya. Si no querés que borre, decí “no” — el agente no auto-confirma.

Próximos pasos

Sección titulada «Próximos pasos»