Подключение по 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 у себя.

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

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

Почему нет подключения по OAuth

Удалённый сервер MCP не имеет доступа к вашему диску — он получает только то, что уместилось в переписку с моделью. Для сервиса, который работает с файлами, это означало бы передачу их содержимого текстом: пятимегабайтная фотография превращается в семь мегабайт base64 и не влезает ни в какое окно контекста. Поэтому у нас локальный процесс, который просто читает путь. Как только появится клиент, умеющий отдавать удалённому серверу сами файлы, мы сделаем и такое подключение.