API ВЕГА

Навыки 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_devtoolshttps://devtools-mcp.imagekit.io/mcpНе требуется
imagekit_damhttps://imagekit.io/mcp/damВойдите в свою учётную запись ImageKit
imagekit_adminhttps://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