ASOgenic MCP

Herramientas de optimización de App Store para agentes de IA: investiga palabras clave de Apple, localiza y valida metadatos de App Store, gestiona capturas de pantalla y versiones, y publica de forma segura a través de App Store Connect.

Ver en asogenic.comPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://mcp.asogenic.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Conecta ASOgenic y ejecuta un pase ASO

ASOgenic es un servidor del Model Context Protocol. Apunta un cliente MCP hacia él con una clave por usuario, dale a tu cliente MCP acceso a las credenciales de App Store Connect, y podrá investigar palabras clave, escribir y validar metadatos, gestionar capturas de pantalla y enviar a revisión de Apple.

¿Tienes prisa? Pega https://asogenic.com/setup en tu cliente MCP. Es un runbook en texto plano que cualquier cliente o automatización compatible puede seguir.

Cómo funciona

Tres servicios, mantenidos deliberadamente separados:

  • Tu cliente MCP (cualquier asistente, herramienta de codificación o automatización compatible con MCP) guarda tu clave .p8 de App Store Connect en su propio entorno y se comunica con el endpoint MCP de ASOgenic.
  • El servidor MCP de ASOgenic expone las herramientas. Genera JWTs de corta duración a partir de tu clave ASC por cada solicitud y nunca almacena la clave en la nube.
  • Este panel solo emite y gestiona tu clave de plataforma. Nunca ve tus credenciales de Apple.

Autenticación

El endpoint alojado actualmente admite una clave API Bearer por cuenta. Esta es la opción más portátil para automatizaciones desatendidas, CI y clientes MCP locales. Guárdala en el almacén de secretos del cliente y envíala solo como Authorization: Bearer <key>. El descubrimiento OAuth de MCP aún no está habilitado, por lo que un cliente que solicite OAuth debe usar la ruta de clave API hasta que se publique esa capa de compatibilidad.

Configuración

  1. Crea una clave de plataforma. Inicia sesión, crea una clave y cópiala. Se muestra una sola vez.
  2. Añade el servidor MCP a la configuración de tu cliente. Añade esto a la configuración de tu cliente MCP (comúnmente .mcp.json), apuntando a https://mcp.asogenic.com/mcp con tu clave en el encabezado Authorization: Copiar { "mcpServers": { "asogenic": { "url": "https://mcp.asogenic.com/mcp", "headers": { "Authorization": "Bearer <your key>" } } } }
  3. Proporciona las credenciales de App Store Connect. Establece ASC_KEY_ID, ASC_ISSUER_ID y ASC_P8_PATH (o ASC_P8_PEM) en el bloque env de ese servidor MCP. La clave permanece en tu máquina. Nunca pegues el .p8 en una llamada de herramienta o en el panel.
  4. Verifica. Llama a asogenic_auth_status. Quieres asc_configured: true y asc_valid: true.

El flujo de trabajo de publicación

El orden que realmente logra que una aplicación nunca lanzada pase la revisión de Apple:

  1. asogenic_auth_status: las credenciales funcionan.
  2. asogenic_list_apps / asogenic_resolve_app: encuentra la aplicación; conserva el session_key.
  3. asogenic_intake_product_context: registra qué es la aplicación. Todo lo posterior depende de esto.
  4. Por idioma: asogenic_fetch_source → genera los campos tú mismo (asogenic_research_keywords, asogenic_assemble_locale, asogenic_get_field_spec son ayudas) → asogenic_validate_record → asogenic_approve_locale → asogenic_publish.
  5. Configuración de la tienda, cada elemento requerido antes del envío: categoría, clasificación por edad, copyright de versión, declaración de derechos de contenido, información de revisión (+ cuenta de demostración si la aplicación requiere inicio de sesión), precio base, capturas de pantalla para cada familia de dispositivos que la aplicación soporte.
  6. asogenic_get_release_readiness: blockers debe estar vacío; lee también el warnings (algunas lagunas de nombres que el servidor no puede verificar).
  7. asogenic_submit_for_review.

App Privacy no está en esta lista a propósito. Apple nunca ha expuesto la "etiqueta nutricional" de App Privacy a la autenticación con clave API. Configúrala una vez en la interfaz web de App Store Connect; se traslada a cada versión posterior, y dejarla sin configurar es la razón número uno de rechazo en la revisión de Apple.

Cuotas y límites de velocidad

Cada cuenta recibe 500 llamadas de herramienta al mes, compartidas entre todas las claves que crees. La ventana se renueva continuamente: las llamadas antiguas caducan, no se reinician en una fecha fija. Además, hay límites de ráfaga de ventana corta, aproximadamente 120 llamadas por minuto.

  • RATE_LIMITED: un límite de ráfaga. Espera los retry_after_s segundos y continúa.
  • QUOTA_EXCEEDED: la asignación mensual se ha agotado. Se recupera a medida que las llamadas más antiguas caducan.

Un pase de optimización completo (investigación de palabras clave, metadatos y publicación en varios idiomas) es aproximadamente de 50 a 100 llamadas, por lo que una clave gratuita cubre un uso real y repetido.

Solución de problemas

asc_configured: false de asogenic_auth_status

Las variables ASC_* no llegan al proceso del servidor MCP. Verifica que estén en el bloque env del servidor (no en tu shell) y reinicia el cliente MCP.

asc_valid: false

Las credenciales están presentes pero Apple las rechazó: par clave ID/ID de emisor incorrecto, clave revocada o un .p8 mal formado.

Las herramientas devuelven 401 / "invalid token"

La clave de plataforma en tu encabezado Authorization es incorrecta o fue rotada/revocada. Crea o rota una clave en el panel.

APP_PRIVACY_NO_API

Esperado; consulta la nota de App Privacy anterior. Configúralo en la interfaz web.

¿Sigue atascado? Consulta las Preguntas frecuentes o contáctanos.