Навыки ImageKit
Переиспользуемые навыки AI-агентов для ImageKit.io — установите их с помощью CLI skills, чтобы расширить возможности вашего агента для написания кода.
Навыки
| Навык | Описание |
|---|---|
| mcp-preflight | Какой MCP-сервер вызвать: DAM (медиатека), Admin (источники, URL-эндпоинты, аналитика использования) или DevTools |
| search-assets | Как использовать Lucene searchQuery для DAM search_media_library: сначала найдите пользовательские метаданные и теги, а не пытайтесь их угадать |
| upload-files | Загрузка файлов в DAM через upload_file (выбор файла) или create_upload_signature — никогда не передавайте байты файла напрямую |
| asset-access-control | Инструменты управления ACL для файлов и папок, а также для медиаколлекций; правила записи, в которых легко ошибиться |
| ai-tasks | Формат данных для AI-разметки, извлечения метаданных и проверки качества ресурсов в DAM |
| search-docs | Как отправлять запросы в DevTools search_docs (переформулирование запросов и выбор источников) |
| transformation-builder | Как использовать DevTools transformation_builder для создания корректных URL трансформаций |
| imagekit-integrations | Каталог SDK, плагинов и виджетов ImageKit: выберите подходящий для вашего стека вариант, а затем найдите нужную документацию |
Установка
Необходимо установить два компонента: навыки (этот репозиторий) и MCP-серверы:
| MCP-сервер | URL | Аутентификация |
|---|---|---|
imagekit_devtools | https://devtools-mcp.imagekit.io/mcp | Не требуется |
imagekit_dam | https://imagekit.io/mcp/dam | Войдите в свою учётную запись ImageKit |
imagekit_admin | https://imagekit.io/mcp/admin | Войдите в свою учётную запись ImageKit |
Если вы ранее подключили https://api-mcp.imagekit.io/mcp, удалите его и вместо него добавьте DAM и Admin.
Назначение каждого сервера:
| Сервер | Для чего использовать |
|---|---|
| DAM | Поиск, загрузка, организация, разметка, предоставление доступа и управление медиатекой |
| Admin | Управление источниками (внешними хранилищами), URL-эндпоинтами, использованием ресурсов учётной записи и аналитикой использования |
| DevTools | Поиск по документации и создание URL трансформаций (вход в систему не требуется) |
Выберите один из двух способов установки. После установки перезапустите редактор, чтобы MCP-серверы начали работать. При появлении запроса пройдите аутентификацию для DAM и Admin.
Установка через плагин (рекомендуется)
В Claude Desktop, Claude.ai (веб-версия) и VS Code плагин ImageKit устанавливает навыки и MCP-серверы за один шаг.
Claude Desktop и Claude.ai (веб-версия)
-
Откройте раздел Customize на левой боковой панели и перейдите на вкладку Plugins.
-
В разделе Personal plugins нажмите + → Add marketplace → Add from a repository и укажите
imagekit-developer/skills. -
Установите плагин ImageKit из этого каталога.
-
Включите встроенные коннекторы
imagekit_devtools,imagekit_damиimagekit_admin. При появлении запроса пройдите аутентификацию для DAM и Admin.
VS Code
-
Откройте палитру команд (
⇧⌘P) и выполните команду Install Plugin from Source. -
Укажите
imagekit-developer/skillsв качестве источника плагина. -
Перезапустите VS Code.
Ручная установка
1. Установите навыки (одна и та же команда для всех платформ):
npx skills add imagekit-developer/skills --all
2. Добавьте MCP-серверы в используемый инструмент:
Claude Code
claude mcp add --transport http imagekit_devtools https://devtools-mcp.imagekit.io/mcp
claude mcp add --transport http imagekit_dam https://imagekit.io/mcp/dam
claude mcp add --transport http imagekit_admin https://imagekit.io/mcp/admin
Claude Desktop
Отредактируйте файл конфигурации:
-
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"imagekit_devtools": {
"command": "npx",
"args": ["-y", "mcp-remote@latest", "https://devtools-mcp.imagekit.io/mcp"]
},
"imagekit_dam": {
"command": "npx",
"args": ["-y", "mcp-remote@latest", "https://imagekit.io/mcp/dam"]
},
"imagekit_admin": {
"command": "npx",
"args": ["-y", "mcp-remote@latest", "https://imagekit.io/mcp/admin"]
}
}
}
Codex
Через CLI:
codex mcp add imagekit_devtools --url https://devtools-mcp.imagekit.io/mcp
codex mcp add imagekit_dam --url https://imagekit.io/mcp/dam
codex mcp add imagekit_admin --url https://imagekit.io/mcp/admin
Или отредактируйте ~/.codex/config.toml:
[mcp_servers.imagekit_devtools]
url = "https://devtools-mcp.imagekit.io/mcp"
[mcp_servers.imagekit_dam]
url = "https://imagekit.io/mcp/dam"
[mcp_servers.imagekit_admin]
url = "https://imagekit.io/mcp/admin"
VS Code Copilot
code --add-mcp "{\"name\":\"imagekit_devtools\",\"type\":\"http\",\"url\":\"https://devtools-mcp.imagekit.io/mcp\"}"
code --add-mcp "{\"name\":\"imagekit_dam\",\"type\":\"http\",\"url\":\"https://imagekit.io/mcp/dam\"}"
code --add-mcp "{\"name\":\"imagekit_admin\",\"type\":\"http\",\"url\":\"https://imagekit.io/mcp/admin\"}"
Cursor
Или отредактируйте ~/.cursor/mcp.json:
{
"mcpServers": {
"imagekit_devtools": { "url": "https://devtools-mcp.imagekit.io/mcp" },
"imagekit_dam": { "url": "https://imagekit.io/mcp/dam" },
"imagekit_admin": { "url": "https://imagekit.io/mcp/admin" }
}
}
Windsurf
Отредактируйте ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"imagekit_devtools": { "serverUrl": "https://devtools-mcp.imagekit.io/mcp" },
"imagekit_dam": { "serverUrl": "https://imagekit.io/mcp/dam" },
"imagekit_admin": { "serverUrl": "https://imagekit.io/mcp/admin" }
}
}
Использование
После установки эти навыки автоматически становятся доступны вашему AI-агенту. Перед выполнением операций с ImageKit агент обращается к подходящему навыку. Это помогает правильно использовать инструменты и получать более качественные результаты.
Лицензия
MIT