Подключение по MCP

Как подключить

Ни установки, ни аккаунта: npx скачает пакет при первом запуске. Бесплатной суточной нормы хватает на разовую работу.

Claude Code

Одна команда в терминале — и всё.

claude mcp add formatika -- npx -y @formatika/mcp

Claude Desktop, Cursor и другие

Добавьте в раздел mcpServers в настройках клиента. Секретов здесь нет — только команда и имя пакета, такой блок не страшно отправить в чат или положить в репозиторий.

{
  "mcpServers": {
    "formatika": {
      "command": "npx",
      "args": ["-y", "@formatika/mcp"]
    }
  }
}

На Windows

Claude Desktop запускает сервер без оболочки и не находит npx напрямую. Обёртка cmd /c это лечит.

{
  "mcpServers": {
    "formatika": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@formatika/mcp"]
    }
  }
}

После правки конфигурации клиент нужно перезапустить полностью, а не просто закрыть окно.

Дальше просто просите

• Сожми все фотографии в ./screenshots и положи результат в ./web
• Переведи все HEIC в этой папке в JPEG
• Сделай из portrait.png квадратную аватарку 512×512

Ключ для больших объёмов

Без ключа работает бесплатная суточная норма. Если её не хватает, заведите ключ в аккаунте и передайте его переменной окружения.

{
  "mcpServers": {
    "formatika": {
      "command": "npx",
      "args": ["-y", "@formatika/mcp"],
      "env": { "FORMATIKA_API_KEY": "fk_..." }
    }
  }
}

FORMATIKA_URL укажет на другой адрес — пригодится, если вы поднимаете formatika у себя.

Что происходит с файлами

На сервер уходит только то, что нельзя обработать на месте, и только на время работы. Дальше файлы удаляются: через два часа без аккаунта, через сутки с ним. Их не читают, не передают и не используют для обучения.

Подключение по адресу, без установки

Клиентам, которые не запускают локальные процессы — веб-версиям ассистентов и чужим площадкам, — тот же набор инструментов доступен по HTTP. Ключ доступа необязателен: без него работает бесплатная суточная норма.

{
  "mcpServers": {
    "formatika": {
      "type": "http",
      "url": "https://formatika.app/api/mcp"
    }
  }
}

С ключом доступа добавьте заголовок Authorization: Bearer <ключ> — норма станет больше, а задачи будут видны в истории аккаунта.

Файл при этом передаётся содержимым в base64, а результат возвращается ссылкой на 15 минут. Это дороже на треть по объёму и упирается в окно контекста модели: пятимегабайтная фотография превращается в семь мегабайт текста. Поэтому для работы с файлами на диске пакет для npx остаётся основным способом — он просто читает путь.