Skip to content
smallPict

Protokół Model Context Protocol (MCP) dla AI

Integracja SmallPict z Claude Desktop, Cursor, Google Antigravity i asystentami AI.

SmallPict natywnie obsługuje otwarty standard Model Context Protocol (MCP), co pozwala asystentom programistycznym AI na bezpośrednią pracę z multimediami za pomocą poleceń w języku naturalnym.

End-to-End Image Processing & Edge CDN Flow

Sub-50ms image optimization lifecycle from client upload to global edge delivery.

  1. 01

    Client Application

    WordPress / SDK / API

    Uploads raw image binary with HMAC-SHA256 signature and UUID v4 idempotency key.

    Origin Request

  2. 02

    smallPict Edge CDN

    Global Edge PoPs

    Checks global edge cache. On cache HIT, delivers AVIF/WebP in <20ms worldwide.

    Cache & Delivery

  3. 03

    SmallPict API Gateway

    Authentication & Quotas

    Validates HMAC credentials, verifies quota limits, and scopes access to customer_id.

    Auth & Scoping

  4. 04

    Optimization Engine

    High-Speed Native Encoder

    Multi-threaded quantization transcode to AVIF & WebP with no visible quality loss and much smaller files.

    Transcoding

  5. 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


Narzędzia protokołu MCP

NarzędzieDziałanieKluczowe parametry
smallpict_optimizeOptymalizuje pliki lokalne lub zdalne URL do AVIF/WebP.path, url, format, quality, max_width
smallpict_get_quotaOdczytuje stan konta, limit i aktualne zużycie.Brak (wykorzystuje skonfigurowany klucz)
smallpict_purge_cdnUsuwa wskazane zasoby z globalnej pamięci Edge CDN.urls (lista adresów)

Konfiguracja edytorów AI

1. Claude Desktop

Dodaj do pliku claude_desktop_config.json:

JSON
{  "mcpServers": {    "smallpict": {      "command": "npx",      "args": [        "-y",        "@smallpict/mcp"      ],      "env": {        "SMALLPICT_API_KEY": "sp_sdk_your_key_here"      }    }  }}

2. Cursor IDE

W Cursor Settings > Features > MCP:

  • Nazwa: SmallPict
  • Typ: command
  • Polecenie: npx -y @smallpict/mcp
  • Zmienna środowiskowa: SMALLPICT_API_KEY=sp_sdk_your_key_here

3. Google Antigravity

W pliku konfiguracyjnym (~/.gemini/antigravity/mcp/smallpict.json):

JSON
{  "command": "npx",  "args": [    "-y",    "@smallpict/mcp"  ],  "env": {    "SMALLPICT_API_KEY": "sp_sdk_your_key_here"  }}