registro/GUIA_REGISTRO.md
Archivo real del paquete para implementar la función. Descárgalo del ZIP para editarlo; no contiene claves privadas.
# Publicar AppInitDev MCP en el registro público oficial — Windows y Hostinger
> **No se registra automáticamente desde el ZIP**: debes usar tu cuenta de dominio y ejecutar la autenticación. La publicación es opcional y no garantiza que los asistentes utilicen o citen el MCP.
## Antes de empezar
- Que `https://appinitdev-mcp.dev-appinitdev.workers.dev/health` responda correctamente.
- Que la prueba real `python AppInitDev_IA_MCP/scripts/PROBAR_PUBLICACION.py` termine bien.
- Que `https://appinitdev.com/mcp/` y `/datos/identidad.json` respondan con HTTP 200.
- Necesitas acceso para subir un archivo a `public_html/.well-known/` en Hostinger y PowerShell en Windows.
## Paso 1. Revisar `server.json`
Archivo: `AppInitDev_IA_MCP/registro/server.json`.
```json
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "com.appinitdev/knowledge",
"title": "AppInitDev Knowledge MCP",
"description": "AppInitDev: identidad del desarrollador, perfil de Google Play, redes declaradas, catálogo de aplicaciones Android y recursos técnicos mediante herramientas MCP de solo lectura.",
"version": "3.0.0",
"remotes": [
{
"type": "streamable-http",
"url": "https://appinitdev-mcp.dev-appinitdev.workers.dev/mcp"
}
]
}
```
**No lo cambies a un dominio diferente sin controlar ese dominio.** El nombre `com.appinitdev/knowledge` exige acreditar `appinitdev.com`. El endpoint `remotes[0].url` debe ser accesible públicamente.
## Paso 2. Instalar el publicador oficial en Windows
Abre https://github.com/modelcontextprotocol/registry/releases y descarga el ejecutable oficial para tu arquitectura. También puedes usar, en PowerShell 64 bits, el comando publicado en la guía oficial:
```powershell
$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::ProcessArchitecture -eq "Arm64") { "arm64" } else { "amd64" }
Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_windows_$arch.tar.gz" -OutFile "mcp-publisher.tar.gz"
tar xf mcp-publisher.tar.gz mcp-publisher.exe
Remove-Item "mcp-publisher.tar.gz"
.\mcp-publisher.exe --help
```
El archivo `.exe` quedará en la carpeta actual. Si no está en `PATH`, usa `./mcp-publisher.exe` (PowerShell: `.\mcp-publisher.exe`) en los comandos siguientes.
## Paso 3. Crear clave y prueba del dominio
```powershell
python -m pip install cryptography
python AppInitDev_IA_MCP/registro/GENERAR_VERIFICACION.py
```
Se genera una **clave privada** en `%USERPROFILE%\.appinitdev_mcp_registry\clave.hex` y el archivo **público**:
`AppInitDev_IA_MCP/registro/archivos_para_hostinger/.well-known/mcp-registry-auth`
No publiques la clave. No pegues sus 64 dígitos en tickets, capturas, chats, GitHub ni tutoriales.
## Paso 4. Subir prueba a Hostinger
En hPanel → Administrador de archivos → `public_html/.well-known/`, sube **solo** `mcp-registry-auth`, sin `.txt`, sin comprimirlo y sin modificar su contenido. Debe responder a esta URL exacta:
`https://appinitdev.com/.well-known/mcp-registry-auth`
La verificación exige `200 OK`, texto `v=MCPv1; k=ed25519; p=...`, sin redirecciones 301/302 ni desafíos de bots. El registro realiza su propia solicitud desde internet.
Comprueba desde PowerShell:
```powershell
$uri = "https://appinitdev.com/.well-known/mcp-registry-auth"
Invoke-WebRequest -Uri $uri -Headers @{Accept="text/plain";"User-Agent"="mcp-registry/1.0"} | Select-Object StatusCode,Content
```
Si Hostinger devuelve 403/404, revisa reglas de acceso a `.well-known`; NO sustituyas el `.htaccess` completo ni expongas archivos ocultos indiscriminadamente.
## Paso 5. Validar el descriptor antes de publicar
Desde la raíz del proyecto en PowerShell:
```powershell
.\mcp-publisher.exe validate "AppInitDev_IA_MCP/registro/server.json"
```
El validador debe confirmar estructura y nombre. Si el programa está en `PATH`, omite `.\`.
## Paso 6. Autenticarse por dominio HTTP
La **CLI oficial** documenta `--private-key=HEX_KEY`; **no presupongas que existe** `--private-key-file`. Carga la clave en una variable para evitar escribir el valor en el historial:
```powershell
$clave = (Get-Content "$env:USERPROFILE\.appinitdev_mcp_registry\clave.hex" -Raw).Trim()
.\mcp-publisher.exe login http --domain=appinitdev.com --private-key=$clave
Remove-Variable clave
```
La clave puede aparecer brevemente en los argumentos del proceso. Ejecútalo en tu equipo de confianza; cierra la sesión cuando termines.
## Paso 7. Publicar en el registro MCP
```powershell
.\mcp-publisher.exe publish "AppInitDev_IA_MCP/registro/server.json"
```
Confirma que el comando indique publicación exitosa. **No** basta con que `login` funcione. Si actualizas una versión publicada, revisa el resultado y la documentación de versiones del registro.
## Paso 8. Comprobar el registro público
```powershell
python AppInitDev_IA_MCP/registro/COMPROBAR_REGISTRO.py
```
Puedes consultar el resultado en:
- https://registry.modelcontextprotocol.io/v0.1/servers/com.appinitdev%2Fknowledge/versions/latest
- https://registry.modelcontextprotocol.io
Un 404 puede significar que todavía no se publicó, que el registro no ha propagado los datos o que la ficha no es visible. No lo anuncies como registrado hasta obtener confirmación.
## Problemas frecuentes
- **401 al autenticar:** fichero público incorrecto, dominio no verificado o firma no coincidente. Compara la clave local y el valor público.
- **403 del fichero de verificación:** WAF, carpeta `.well-known` bloqueada, reglas de bot o hosting.
- **301/302:** el Registry no sigue redirecciones en la ruta de prueba; debe responder 200 directo.
- **`unknown flag --private-key-file`:** usa los comandos de la sección 6 con `--private-key`.
- **`tools/list` falla:** primero repara el Worker y los JSON; el registro es un catálogo, no un host alternativo.
- **404 al consultar el registro:** el servidor aún no aparece, prueba la URL oficial y verifica la respuesta de `publish`.
## Referencias oficiales (consultadas el 16-nov-2026)
- https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/cli/commands.md
- https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/authentication.mdx
- https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/remote-servers.mdx
- https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/api/official-registry-api.md
- https://github.com/modelcontextprotocol/registry/releases