Protocolo de contexto de modelos (MCP)
Integra SmallPict con Claude Desktop, Cursor, Google Antigravity y asistentes de IA.
SmallPict implementa el estándar abierto Model Context Protocol (MCP) desarrollado por Anthropic, permitiendo a los asistentes de IA interactuar directamente con tu infraestructura de imágenes.
End-to-End Image Processing & Edge CDN Flow
Sub-50ms image optimization lifecycle from client upload to global edge delivery.
- 01
Client Application
WordPress / SDK / API
Uploads raw image binary with HMAC-SHA256 signature and UUID v4 idempotency key.
Origin Request
- 02
smallPict Edge CDN
Global Edge PoPs
Checks global edge cache. On cache HIT, delivers AVIF/WebP in <20ms worldwide.
Cache & Delivery
- 03
SmallPict API Gateway
Authentication & Quotas
Validates HMAC credentials, verifies quota limits, and scopes access to customer_id.
Auth & Scoping
- 04
Optimization Engine
High-Speed Native Encoder
Multi-threaded quantization transcode to AVIF & WebP with no visible quality loss and much smaller files.
Transcoding
- 05
Secure Storage & Sync
Encrypted Cloud Storage
Stores optimized output, invalidates outdated cache tags, and warms the edge cache.
Persistent Sync
Zero Data Interception: End-to-end HMAC validation & SHA256 integrity check
Engine: smallPict
Herramientas MCP disponibles
| Herramienta | Descripción | Parámetros principales |
|---|---|---|
smallpict_optimize | Optimiza una imagen local o remota a formatos AVIF/WebP. | path, url, format, quality, max_width |
smallpict_get_quota | Consulta el consumo y saldo disponible de transformaciones. | Ninguno (utiliza la clave configurada) |
smallpict_purge_cdn | Invalida recursos obsoletos en la CDN perimetral global. | urls (matriz de cadenas de texto) |
Configuración para clientes de IA
1. Claude Desktop
Añade la siguiente entrada a tu archivo claude_desktop_config.json:
{ "mcpServers": { "smallpict": { "command": "npx", "args": [ "-y", "@smallpict/mcp" ], "env": { "SMALLPICT_API_KEY": "sp_sdk_your_key_here" } } }}2. Cursor IDE
En los ajustes de Cursor (Cursor Settings > Features > MCP), agrega un nuevo servidor con los siguientes valores:
- Nombre: SmallPict
- Tipo:
command - Comando:
npx -y @smallpict/mcp - Variable de entorno:
SMALLPICT_API_KEY=sp_sdk_your_key_here
3. Google Antigravity
En el archivo de configuración de servidores MCP (~/.gemini/antigravity/mcp/smallpict.json):
{ "command": "npx", "args": [ "-y", "@smallpict/mcp" ], "env": { "SMALLPICT_API_KEY": "sp_sdk_your_key_here" }}Ejemplos de prompts en lenguaje natural
- "Comprime todas las imágenes de la carpeta
./public/assetsa formato AVIF con calidad 80 y dime cuánto peso logramos ahorrar." - "Consulta mi cuota restante en SmallPict para saber si tenemos saldo suficiente para la campaña de marketing."
- "Purga la imagen
https://cdn.smallpict.app/media/banner-verano.avifde los servidores perimetrales de la CDN porque acabamos de actualizar el diseño."