Clipia MCP
Подключите Clipia к Claude Code, claude.ai, ChatGPT, Cursor, VS Code и Windsurf — 60+ моделей изображений и видео прямо в чате агента по одному API-ключу.
Clipia MCP — это remote Model Context Protocol сервер по адресу https://mcp.clipia.ai/mcp. Он всегда даёт MCP-клиенту 10 базовых инструментов: генерацию изображений, видео, речи и музыки, ожидание и получение результата, каталог моделей, баланс и поиск промптов. Дополнительные chat, generate_scenario, compose_video и generate_presentation появляются только при включённых возможностях. Семь app-only helpers обслуживают интерактивные карточки и не занимают контекст AI-агента. Авторизация — обычным API-ключом публичного API; оплата — кредитами вашего аккаунта Clipia.
Endpoint
Адрес сервера (Streamable HTTP): https://mcp.clipia.ai/mcp. Поддерживаемые схемы авторизации: Authorization: Bearer clipia_... (рекомендуется), Authorization: Key <ключ>, X-Api-Key: <ключ>.
Где взять ключ
API-ключ создаётся в консоли разработчика. Ключи с префиксом clipia_live_ — боевые (списывают кредиты), ключи с префиксом clipia_test_ — песочница: мгновенные mock-ответы без списания кредитов, удобно для отладки агентов и CI.
Ключ — серверный секрет
Боевой ключ показывается один раз при создании — это эквивалент пароля к балансу кредитов. Храните его в переменной окружения или менеджере секретов, не публикуйте в репозиториях.
Подключение клиента
Карточки в чате
В claude.ai результат показывается интерактивной карточкой с живым прогрессом и медиа. В Claude Code приходит inline-превью в терминал. В остальных клиентах агент присылает ссылки на файл в полном качестве.
Одна команда в терминале — и инструменты Clipia доступны в любой сессии, включая headless и CI. Ключ возьмите из переменной окружения, не вшивайте его в команду:
claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
--header "Authorization: Bearer $CLIPIA_API_KEY"После этого попросите Claude: «Сгенерируй в Clipia изображение неонового города» — превью придёт прямо в терминал.
claude.ai (веб, десктоп, мобильное приложение) подключается через вход в аккаунт Clipia (OAuth), ключ указывать не нужно:
- Откройте Settings → Connectors.
- Нажмите «Add custom connector» и вставьте URL
https://mcp.clipia.ai/mcp. - Нажмите Connect и войдите в свой аккаунт Clipia.
- В новом чате попросите сгенерировать картинку или видео — в сообщении появится живая карточка Clipia с прогрессом и кнопкой «Оригинал».
- В ChatGPT (веб): Settings → Apps & Connectors → Advanced settings → включите Developer mode (Plus, Pro, Business, Enterprise).
- Apps & Connectors → Create. Name — Clipia, MCP Server URL
https://mcp.clipia.ai/mcp. - Authentication — OAuth, отметьте «I trust this application» и нажмите Create.
- Войдите в аккаунт Clipia. В чате нажмите «+» → More → Clipia и просите генерации обычным текстом.
Добавьте сервер в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json в проекте, затем перезапустите Cursor. Подставьте ключ из переменной окружения вместо плейсхолдера:
{
"mcpServers": {
"clipia": {
"url": "https://mcp.clipia.ai/mcp",
"headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
}
}
}Создайте .vscode/mcp.json в рабочей папке (или через команду «MCP: Add Server»). Откройте Copilot Chat в режиме Agent — инструменты Clipia появятся в списке:
{
"servers": {
"clipia": {
"type": "http",
"url": "https://mcp.clipia.ai/mcp",
"headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
}
}
}Добавьте сервер в ~/.codeium/windsurf/mcp_config.json (поле serverUrl — особенность Windsurf), затем обновите список серверов в панели Cascade → MCPs:
{
"mcpServers": {
"clipia": {
"serverUrl": "https://mcp.clipia.ai/mcp",
"headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
}
}
}Песочница
Ключи с префиксом clipia_test_ возвращают мгновенные mock-результаты без списания кредитов — удобно отлаживать разбор ответов, polling и пайплайны. Боевые ключи показывают стоимость каждой генерации в ответе, а инструмент get_balance — остаток кредитов.
Полный справочник инструментов — на странице Инструменты.
Аккаунт и лимиты
GET /v1/key и GET /v1/generation в Clipia AI Gateway — проверка лимитов и расхода ключа, точная стоимость запроса, заголовки rate-limit и ответ 429.
Инструменты MCP
Справочник 10 базовых инструментов Clipia MCP для AI-агента и семи app-only helpers — изображения, видео, речь, музыка, статусы, каталог, баланс и промпты.