Alta de estudio sin panel web

Registro automático, token Admin API y configuración MCP para cualquier cliente compatible

Registro: POST https://gamepanel.idcgames.com/api/v1/admin/auth/register-studio — Estado: GET https://gamepanel.idcgames.com/api/v1/admin/auth/registration-status

Onboarding de estudios



El registro por HTTP crea una cuenta pendiente y un juego inactivo. El estudio debe entrar en el panel, verificar su correo e inscribir el segundo factor si el operador lo exige. Después obtiene el token mediante POST /api/v1/admin/auth/login y genera la configuración MCP.

Configuración del operador



ADMIN_API_STUDIO_REGISTRATION_ENABLED está desactivado por defecto. Para habilitarlo en producción también se exige ADMIN_API_STUDIO_REGISTRATION_SECRET, entregado al estudio por un canal privado. ADMIN_API_STUDIO_REGISTRATION_PUBLISH_SECRET no publica secretos en producción. GET /api/v1/admin/auth/registration-status informa de la disponibilidad y los endpoints.

Registro y verificación



Enviar POST /api/v1/admin/auth/register-studio con name, email, password, password_confirmation, game_name, accept_terms: true y registration_secret. La respuesta 201 incluye data.admin_user, data.game (id, nombre y estado inactivo) y data.verification_required: true. El registro envía el correo de verificación. No incluye tokens, configuración MCP ni secretos del juego.

  • 1. Entrar en el panel con la cuenta creada y abrir el enlace de verificación recibido.

  • 2. Inscribir el autenticador en el perfil cuando ADMIN_REQUIRE_2FA=true.

  • 3. Llamar a POST /api/v1/admin/auth/login con email, contraseña y two_factor_code si corresponde. include_mcp_setup: true incluye la configuración MCP en esta respuesta autenticada.

  • 4. Guardar el token emitido en un almacén de secretos; configurar los scopes e IP permitidos antes de usar MCP.


  • Los registros pendientes durante siete días se purgan mediante registrations:purge-pending, siempre que el juego continúe inactivo, no tenga jugadores, otras cuentas ni contenido. --dry-run permite revisar los candidatos. El scheduler ejecuta la limpieza diariamente.

    register-game-tenant mantiene el aprovisionamiento administrativo de confianza y exige un superadministrador autenticado y el scope correspondiente.

    4. Generar config MCP (endpoint dedicado)



    Tras verificar el correo y obtener un token mediante login, con la ruta absoluta al index.js del servidor Node en el PC del estudio:

    POST https://panel.tudominio.com/api/v1/admin/auth/mcp-client-config
    Authorization: Bearer gpa_...
    Content-Type: application/json

    {
    "mcp_server_script_path": "C:/dev/idcgames_gamepanel/mcp/gamepanel-admin-server/src/index.js",
    "token_name": "mcp-workstation-1"
    }


    Descarga directa del JSON:

    POST .../auth/mcp-client-config?download=1


    (Alias legacy: POST .../auth/cursor-mcp-json)

    Respuesta clave:

  • mcp_config_json / mcp_config_json_pretty

  • client_config_file_hints — dónde pegarlo según el producto (Cursor, Claude, …)

  • admin_api_token — token nuevo embebido en env.GAMEPANEL_ADMIN_TOKEN


  • ---

    5. MCP en producción: qué va dónde



    ComponenteDónde viveCómo se “arranca”
    Panel Laravel (Admin API)Servidor de producción (APP_URL)PHP-FPM / web server habitual del panel
    Adaptador Node (mcp/gamepanel-admin-server)PC de cada desarrollador (o CI que use MCP)No hace falta dejarlo como daemon
    Token gpa_...Vault del estudioEn el bloque env del config MCP del cliente

    El adaptador usa stdio MCP: Cursor, Claude Desktop, etc. lanzan node …/index.js cuando conectan al servidor MCP y lo cierran al desconectar. No instalas Node en el servidor del panel salvo que quieras un flujo distinto (HTTP/SSE); el diseño actual es cliente local → HTTPS → panel en prod.

    En producción, GAMEPANEL_BASE_URL del config MCP debe ser la URL pública del panel, por ejemplo https://panel.tudominio.com (sin barra final). El npm install es en la carpeta del adaptador en la máquina del estudio, no en el deploy del Laravel.

    Instalar el adaptador (una vez por máquina)



    Clona el repo del panel (o copia solo mcp/gamepanel-admin-server), luego:

    cd mcp/gamepanel-admin-server
    npm install


    Requisitos: Node 18+ en el PATH (el config generado usa command: "node").

    Comprobar manualmente (opcional; en uso normal lo hace el cliente MCP):

    set GAMEPANEL_BASE_URL=https://panel.tudominio.com
    set GAMEPANEL_ADMIN_TOKEN=gpa_...
    node src/index.js


    Si arranca sin error y queda esperando, es correcto (stdio); Ctrl+C para salir. No uses pm2 ni un servicio Windows salvo que montes tú un host MCP que no use stdio.

    Tras guardar el config: reinicia o recarga MCP en tu cliente (ver reload_hint en la respuesta de la API).

    Merge mcp_config_json en el archivo de configuración MCP de tu cliente (no confundir con el .env de Laravel del panel).

    Ejemplo del contenido (formato estándar MCP):

    {
    "mcpServers": {
    "gamepanel-admin": {
    "command": "node",
    "args": ["C:/ruta/.../mcp/gamepanel-admin-server/src/index.js"],
    "env": {
    "GAMEPANEL_BASE_URL": "https://panel.tudominio.com",
    "GAMEPANEL_ADMIN_TOKEN": "gpa_..."
    }
    }
    }
    }


    Dónde guardarlo (depende del cliente)



    Las rutas de la tabla y las de client_config_file_hints en la API son ejemplos habituales, no requisitos del panel. Lo obligatorio es el objeto mcp_config_json (mcpServers + command/args/env).

    ClienteUbicación habitual (solo ejemplo)
    Cursorp. ej. ~/.cursor/mcp.json o .cursor/mcp.json en un repo
    Claude Desktopp. ej. %APPDATA%\Claude\claude_desktop_config.json (Windows) — ver client_config_file_hints
    OtrosDocumentación del host MCP; suele ser el mismo objeto mcpServers

    No hace falta crear .cursor si usas otro cliente: el protocolo MCP es el mismo; cambia solo el archivo donde pegas el JSON.

    ---

    6. Si ya tienes cuenta (login + nuevo token MCP)



    POST /api/v1/admin/auth/login
    Content-Type: application/json

    {
    "email": "dev@miestudio.com",
    "password": "...",
    "token_name": "cursor-mcp",
    "include_mcp_setup": true
    }


    O con token existente:

    POST /api/v1/admin/auth/tokens
    Authorization: Bearer gpa_...
    Content-Type: application/json

    {
    "token_name": "cursor-2026",
    "include_mcp_setup": true
    }


    Plantilla sin emitir token:

    GET /api/v1/admin/auth/mcp-setup
    Authorization: Bearer gpa_...


    ---

    7. Primeros pasos vía API (sin panel)



    Con Authorization: Bearer gpa_...:

  • 1. GET /capabilities — mapa de recursos

  • 2. GET /games — confirmar juego y id

  • 3. PATCH /games/{id} — progress_keys, monedas, settings

  • 4. PATCH /games/{id}/platforms/steam (o epic, idc) — login

  • 5. POST /xp-configurations + header X-Game-Id si eres superadmin

  • 6. Battle Pass, daily rewards, etc. (ver ADMIN_API_AI_GUIDE.md)


  • Como admin del estudio, tu usuario ya tiene game_id: muchas rutas no exigen X-Game-Id.

    ---

    9. Documentación relacionada



    DocumentoContenido
    ADMIN_API_AI_GUIDE.mdReferencia Admin API
    MCP_GAMEPANEL_ADMIN.mdHerramientas MCP
    openapi-admin.yamlEsquema OpenAPI
    Hub web/documentation/developer/studio-onboarding
    Generar JSON MCP (panel, login)https://gamepanel.idcgames.com/mcp-setup

    ---

    10. Seguridad



  • Tratar admin_api_token y gamepanel_secret_token como secretos de producción.

  • Usar HTTPS siempre.

  • Rotar tokens: POST /auth/tokens y revocar el anterior con POST /auth/logout.

  • En producción, dejar ADMIN_API_STUDIO_REGISTRATION_ENABLED=false si no queréis altas públicas.

  • Restricción por IP (opcional): en /mcp-setup o en POST /auth/mcp-client-config con allowed_ips[]. El token solo responde desde esas IPs (la IP pública de salida de tu PC al llamar a la Admin API).

  • MCP en el panel: tras login, abre /mcp-setup para generar y copiar mcp_config_json sin scripts.