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Инструменты управления доступом к файлам и папкам, а также к медиаколлекциям; правила записи, в которых легко ошибиться
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