Documentação para desenvolvedores

Use o catálogo público do Toolako. As seis ferramentas prontas são comprimir, redimensionar, cortar, girar e virar, converter e adicionar marca d’água.

Ferramentas prontas

Catálogo e esquemas

O catálogo apresenta descrições localizadas, esquemas JSON estritos de entrada e opções, esquemas de resultado, formatos, limites e requisitos de execução. Cada operação listada roda no navegador do usuário; o serviço de catálogo não processa imagens.

Abrir tools.jsonGuia de API em Markdown

Onde as ferramentas rodam

O site público e o catálogo MCP hospedado fornecem apenas documentação e metadados. Os pixels são processados no navegador do dispositivo do usuário. O acesso por agente de navegador funciona somente quando o agente tem autorização para usar a aba ativa da área de trabalho. O complemento MCP local inicia um navegador local e usa o mesmo mecanismo; um cliente MCP somente na nuvem não acessa arquivos no dispositivo do usuário.

Limites de lote

No fluxo comum, cada operação aceita uma imagem. As ferramentas de lote do MCP local aceitam até 50 imagens por importação, com limite de 20 MiB por arquivo e 100 MiB no total (incluindo um logotipo compartilhado opcional). Cada imagem pode ter até 16 megapixels e 8.192 pixels por lado; as saídas de lote retidas têm limite agregado de 100 MiB.

Privacidade e fluxo de dados

O catálogo MCP hospedado não aceita bytes de imagem, Base64, caminhos locais ou URLs de imagens. O processamento no navegador permanece local. Ao usar um provedor de IA, nomes ou caminhos selecionados, argumentos das ferramentas e metadados retornados podem ficar visíveis para esse provedor; os pixels não são incluídos por padrão. A importação e exportação pelo MCP local usam as pastas configuradas pelo usuário.

Configuração do MCP local

Instale o complemento local do projeto e configure os diretórios permitidos de entrada e saída no host MCP. Ele usa stdio e inicia um navegador local novo. Consulte o guia de configuração para ver o comando e a configuração do host.

  • Requer Node.js 22.23.4. Instale as dependências com npm ci, e instale o Chromium com npx playwright install chromium.
  • Compile o runner do navegador e o complemento MCP local com: npm run build:workbench, npm run build:runner, npm run build --workspace @local-image-tools/mcp-local.
  • Defina LOCAL_IMAGE_INPUT_ROOTS como uma lista de pastas de entrada permitidas, separadas pelo delimitador de caminhos, e LOCAL_IMAGE_OUTPUT_ROOT como a pasta de saída. Configure o host MCP para executar este comando por stdio: node /absolute/path/to/packages/mcp-local/dist/cli.js

Ler o guia de configuração