MCP и агенты
Пусть ИИ-ассистент создаёт изображения и видео
Официальный MCP-сервер даёт Claude, Cursor, Codex, VS Code и другим ассистентам актуальный каталог моделей, точные расчёты стоимости и создание задач. Вы просите обычными словами, а перед любым списанием ассистент ждёт вашего подтверждения.
Что такое MCP-сервер?
MCP (Model Context Protocol) — стандартный способ дать ИИ-ассистенту новые инструменты. Добавьте сервер SpicyAPI, и ассистент сможет смотреть модели, проверять цены и создавать изображения и видео.
- Вы и ваш ассистентClaude, Cursor, Codex, VS Code…
- MCP-сервер SpicyAPIРаботает на вашем компьютере через npx
- Модели изображений и видеоАктуальный каталог, точные цены
Подходит для
- Материалы прямо в работе над кодомПопросите главное изображение или ролик о продукте, не выходя из редактора.
- Знакомство с моделямиСпросите, какая модель подходит для задачи и сколько это будет стоить.
- Пакетная генерация с помощью агентаПусть агент сам создаст несколько задач, дождётся и соберёт результаты.
Что происходит после вашего запроса
- Шаг 1Находит подходящую модель в актуальном каталоге и читает, что она принимает
- Шаг 2Загружает ваш локальный файл, если он есть
- Шаг 3Получает точную цену в долларах США и спрашивает вас до любого списания
- Шаг 4Запускает задачу, ждёт её завершения и отдаёт ссылку на результат
Вы: Преврати beach.jpg в шестисекундный ролик с волнами на закате.
- spicyapi_models_listspicyapi_model_getАссистент: Нашёл видеомодель, принимающую начальное изображение
- spicyapi_upload_fileЗагрузил beach.jpg
- spicyapi_task_quote
Вот точная цена в долларах США. Создать задачу?
- spicyapi_task_createspicyapi_task_waitГотово. Вот ваша ссылка для скачивания.
Подключите к своему ассистенту
Все клиенты запускают один и тот же локальный сервер через npx. Выберите свой, чтобы получить точную команду или блок конфигурации.
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
}
}
}Один stdio‑сервер для всех MCP‑клиентов. Вставьте блок в файл настроек нужного клиента.
claude mcp add spicyapi \
-e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillДобавьте MCP‑сервер и установите Skill. Claude Code по‑прежнему рассуждает с помощью Claude; SpicyAPI — инструмент, который он вызывает.
codex mcp add spicyapi \
--env SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillДостаточно одного codex mcp add: десктопное приложение, CLI и расширение для IDE читают один и тот же ~/.codex/config.toml.
// ~/.cursor/mcp.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
}
}
}Добавьте сервер в ~/.cursor/mcp.json. Этот файл находится вне вашего репозитория.
// ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
}
}
}Тот же блок — в файле настроек MCP у Windsurf.
// ~/.gemini/settings.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
}
}
}Тот же блок — в ~/.gemini/settings.json.
// .vscode/mcp.json (committed to the repo, so prompt for the key instead of hard-coding it)
{
"inputs": [
{ "id": "spicyapi-key", "type": "promptString", "description": "SpicyAPI key", "password": true }
],
"servers": {
"spicyapi": {
"type": "stdio",
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "${input:spicyapi-key}" }
}
}
}.vscode/mcp.json попадает в репозиторий, поэтому он запрашивает ключ вместо хранения.
// ~/.cline/mcp.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" },
"disabled": false,
"autoApprove": []
}
}
}Добавьте блок MCP-сервера в ~/.cline/mcp.json — и он сразу генерирует изображения и видео.
# librechat.yaml — restart LibreChat after editing
mcpServers:
spicyapi:
type: stdio
command: npx
args: ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"]
env:
SPICY_API_KEY: "${SPICY_API_KEY}"Добавьте запись в mcpServers в librechat.yaml и перезапустите LibreChat — иначе соединение не поднимется.
grok mcp add spicyapi -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
# or write ~/.grok/config.toml directly
[mcp_servers.spicyapi]
command = "npx"
args = ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"]
env = { SPICY_API_KEY = "${SPICY_API_KEY}" }Достаточно одного grok mcp add; MCP-серверы, настроенные для Claude Code, работают и здесь.
Сторонние клиенты меняют формат конфигурации от версии к версии. Если сниппет здесь перестал подходить, ориентируйтесь на документацию самого клиента.
Пользуетесь Claude? Генерируйте картинки и видео из Claude →
Доступные инструменты
Инструменты только для чтения бесплатны. Два инструмента, которые тратят деньги, и один, который удаляет контент, всегда сначала спрашивают вас.
БесплатноБесплатные, только чтение12
spicyapi_service_statusПубличная проверка доступности, ключ не нуженspicyapi_docs_searchПоиск по встроенной документацииspicyapi_models_listДоступные модели и ваши ценыspicyapi_model_getОдна модель и её схема входных данныхspicyapi_balance_getДоступный, зарезервированный и общий балансspicyapi_usage_getСколько потратил текущий ключspicyapi_tasks_listПоследние задачи текущего ключаspicyapi_task_getОдна задача с готовыми ссылками на результатspicyapi_task_waitОжидание завершения задачи до 5 минутspicyapi_task_quoteРасчёт цены точного запроса без создания задачиspicyapi_upload_fileЗагрузка локального файла как входных данныхspicyapi_download_url_createНовая ссылка для скачивания результата
Спрашивает перед списаниемСпрашивают перед запуском3
spicyapi_task_createЗапуск задачи на генерациюspicyapi_task_retryПовторный запуск неудачной или истёкшей задачиspicyapi_task_purgeБезвозвратное удаление контента завершённой задачи
Добавьте Agent Skill — он подскажет порядок вызовов
MCP-сервер даёт агенту возможности, а Agent Skill объясняет, как ими пользоваться: прочитать схему, подтвердить расчёт цены, использовать один идемпотентный ключ на каждую попытку. Claude Code и Codex поддерживают оба варианта.
npx skills add spicyapi-ai/spicy-skill \
--agent claude-codenpx skills add spicyapi-ai/spicy-skill \
--agent codex -gnpx skills add spicyapi-ai/spicy-skillФайлы, которые может прочитать ваш агент
Эти файлы помогают ассистентам и инструментам найти описание продукта, каталог и официальную документацию.
agent.md
Краткий контракт интеграции агента и границы безопасности.
/agent.md →
llms.txt
Отобранный индекс сайта и моделей для поиска ИИ.
/llms.txt →
llms-full.txt
Расширенный контекст продукта, процессов, эндпоинтов и обнаружения.
/llms-full.txt →
Манифест агента
Структурированное JSON-описание для инструментов и автономных клиентов.
/api/agent →
Частые ошибки и как их исправить
Почти все проблемы на старте — одна из этих трёх. На каждой карточке: что вы видите и что нужно изменить.
- tools
Инструменты не появляются
Перезапустите ассистента после правки конфигурации и проверьте, что JSON корректен.
- ключ
Нет API-ключа
Укажите SPICY_API_KEY в блоке env конфигурации сервера. Десктопные приложения не видят ключ, экспортированный в вашей оболочке.
- запрос
Нельзя создавать задачи
Ваш клиент не умеет показывать запросы подтверждения. Бесплатные инструменты работают; для создания задач нужен клиент с поддержкой MCP elicitation.