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/logincon email, contraseña ytwo_factor_codesi corresponde.include_mcp_setup: trueincluye 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_prettyclient_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
| Componente | Dónde vive | Có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 estudio | En 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 installRequisitos: 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.jsSi 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).| Cliente | Ubicación habitual (solo ejemplo) |
|---|---|
| Cursor | p. ej. ~/.cursor/mcp.json o .cursor/mcp.json en un repo |
| Claude Desktop | p. ej. %APPDATA%\Claude\claude_desktop_config.json (Windows) — ver client_config_file_hints |
| Otros | Documentació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_...:GET /capabilities — mapa de recursos GET /games — confirmar juego y id PATCH /games/{id} — progress_keys, monedas, settings PATCH /games/{id}/platforms/steam (o epic, idc) — login POST /xp-configurations + header X-Game-Id si eres superadmin Como admin del estudio, tu usuario ya tiene
game_id: muchas rutas no exigen X-Game-Id.---
9. Documentación relacionada
| Documento | Contenido |
|---|---|
| ADMIN_API_AI_GUIDE.md | Referencia Admin API |
| MCP_GAMEPANEL_ADMIN.md | Herramientas MCP |
| openapi-admin.yaml | Esquema OpenAPI |
| Hub web | /documentation/developer/studio-onboarding |
| Generar JSON MCP (panel, login) | https://gamepanel.idcgames.com/mcp-setup |
---
10. Seguridad
admin_api_token y gamepanel_secret_token como secretos de producción. POST /auth/tokens y revocar el anterior con POST /auth/logout. ADMIN_API_STUDIO_REGISTRATION_ENABLED=false si no queréis altas públicas./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-setup para generar y copiar mcp_config_json sin scripts.