Conectar una herramienta de IA

Conectar una herramienta de IA

Cuando MCP está activado en este despliegue de AppScreenshots, conecta una herramienta compatible a:

https://appscreenshots.net/api/mcp

Elige HTTP/Streamable HTTP y OAuth. Inicia sesión con tu cuenta de AppScreenshots en el navegador, selecciona los proyectos y recursos que la herramienta puede usar y decide si puede crear proyectos. No se requiere acceso a la base de datos ni clave de API.

Conecta tu cliente

Los comandos siguientes registran el endpoint en cada cliente. Tras conectar, completa el inicio de sesión en el navegador cuando el cliente lo presente.

claude mcp add --transport http --scope user appscreenshots https://appscreenshots.net/api/mcp

codex mcp add appscreenshots --url https://appscreenshots.net/api/mcp
codex mcp login appscreenshots

gemini mcp add --transport http --scope user appscreenshots https://appscreenshots.net/api/mcp

{
  "mcpServers": {
    "appscreenshots": {
      "url": "https://appscreenshots.net/api/mcp"
    }
  }
}

{
  "mcp": {
    "servers": {
      "appscreenshots": {
        "type": "http",
        "url": "https://appscreenshots.net/api/mcp",
        "oauth": {
          "type": "authorization_code",
          "scope": "projects:read projects:write assets:read offline_access"
        }
      }
    }
  }
}

Kit de conexión

El repositorio público appscreenshots-mcp incluye archivos de configuración listos para todos los clientes anteriores, un Skill de agente opcional que enseña el flujo de capturas y un comando doctor que comprueba el servidor desde tu terminal:

git clone https://github.com/horace68/appscreenshots-mcp.git
node bin/appscreenshots.mjs config claude    # imprime un fragmento de configuración
node bin/appscreenshots.mjs install-skill claude
node bin/appscreenshots.mjs doctor

El auxiliar solo imprime configuración e instala el Skill. No es un servidor stdio local: usa la conexión remota nativa de tu cliente.

Herramientas

Las nueve herramientas siguientes se exponen por Streamable HTTP. Los clientes pueden anteponer un prefijo a los nombres. El servidor alojado es la fuente de verdad para los esquemas de entrada y los permisos de la cuenta.

Operaciones de edición

update_project acepta una lista discriminada de operaciones:

• set_name — renombra el proyecto
• add_frame / remove_frame / reorder_frames — gestiona fotogramas
• upsert_element — inserta o sustituye un elemento; exige geometría completa y conserva los campos omitidos del mismo tipo
• patch_element — edición parcial por id de elemento; no se permite cambiar el tipo
• remove_element — elimina un elemento
• set_background — fija el fondo de un fotograma; los fondos compartidos se materializan por fotograma
• set_locales — define 1–20 idiomas y el idioma predeterminado
• set_canvas — tamaño del lienzo (100–5000) y modo (separate o continuous)

Los elementos llevan tipografía, campos de maquetas de dispositivo, referencias assetId de imagen, formas, iconos, rotation y stackOrder. Las imágenes se referencian por assetId autorizado — nunca por URL ni ruta local, y las referencias existentes se conservan en el servidor, así que no las reenvíes.

Cada escritura lógica debe usar una clave de idempotencia nueva; reutilízala solo en un reintento idéntico. Tras un conflicto de revisión, lee la versión más reciente y reconcilia. Nunca uses SQL, HTML ni scripts como instrucciones de edición.

Errores

Los errores devuelven un cuerpo JSON {code, message} con isError: true:

Autorización y límites

El servidor usa OAuth 2.1 con PKCE e inicio de sesión en el navegador:

• Ámbitos: projects:read, projects:write (solo si permites crear o editar), assets:read y offline_access.
• Los tokens de acceso duran una hora y los de refresco, 30 días.
• Los tokens de acceso exigen una concesión vigente: si revocas la conexión, los tokens existentes dejan de funcionar de inmediato.
• Límites de uso: 60 llamadas MCP por minuto en el plan gratuito y 120 por minuto en los de pago. Superarlo devuelve HTTP 429 con Retry-After: 60.
• Los cuerpos de petición se limitan a 2 MB; los proyectos, a 20 fotogramas y 100 elementos por fotograma.

Los derechos del plan se aplican con normalidad: las restricciones de proyectos, plantillas de pago, fuentes personalizadas y exportación por lotes no cambian, y no hay cargos de IA alojada — el diseño y los textos los aporta la IA conectada.

Empieza con tus capturas

Sube las capturas originales en el editor web. Autoriza ese proyecto o selecciona recursos individuales en la página de consentimiento. MCP no expone herramientas de subida binaria; un archivo adjunto en un chat no es accesible automáticamente para este servicio.

Prueba este prompt:

La IA conectada aporta diseño y textos; MCP guarda proyectos editables. get_project_preview devuelve el enlace del editor e instrucciones de revisión, no bytes de imagen. Un agente con herramientas de navegador puede abrir el editor, inspeccionar las capturas, corregir el diseño por MCP y recargar con seguridad para revisar la última versión. El inicio de sesión del navegador es independiente del OAuth de MCP, y los cambios no guardados deben conservarse antes de recargar. El usuario previsualiza y exporta desde el editor web.

Gestionar el acceso

Abre Settings → Connected AI tools para cambiar los proyectos/recursos seleccionados o revocar una conexión. La herramienta no puede acceder a proyectos no seleccionados. Si la web y una herramienta de IA editan el mismo proyecto a la vez, recarga la versión más reciente antes de guardar cambios conflictivos.

La revisión en navegador no requiere Browserless ni una cola de renderizado en segundo plano. Este MCP expone herramientas de proyecto y guía de revisión en navegador, no renderización en la nube. Sin herramientas de navegador/imagen, el agente debe devolver el enlace del editor e indicar que la revisión visual está pendiente, en lugar de afirmar que verificó.

Solución de problemas

Para notas específicas por cliente y la matriz de verificación actual, consulta la guía de solución de problemas del kit de conexión.