Clipia MCP
Подключите Clipia к Claude Code, claude.ai, ChatGPT, Cursor, VS Code и Windsurf — 50+ моделей изображений и видео прямо в чате агента по одному API-ключу.
Clipia MCP — это remote Model Context Protocol сервер по адресу https://api.clipia.ai/mcp. Он даёт любому MCP-клиенту (Claude Code, claude.ai, ChatGPT, Cursor, VS Code, Windsurf и другим) набор инструментов для генерации изображений и видео: агент сам выбирает модель, следит за прогрессом и показывает результат прямо в диалоге. Авторизация — обычным API-ключом публичного API; оплата — кредитами вашего аккаунта Clipia.
Endpoint
Адрес сервера (Streamable HTTP): https://api.clipia.ai/mcp. Поддерживаемые схемы авторизации: Authorization: Bearer clipia_... (рекомендуется), Authorization: Key <ключ>, X-Api-Key: <ключ>.
Где взять ключ
API-ключ создаётся в Настройках Clipia → вкладка «API-ключи». Ключи с префиксом clipia_live_ — боевые (списывают кредиты), ключи с префиксом clipia_test_ — песочница: мгновенные mock-ответы без списания кредитов, удобно для отладки агентов и CI.
Ключ — серверный секрет
Боевой ключ показывается один раз при создании — это эквивалент пароля к балансу кредитов. Храните его в переменной окружения или менеджере секретов, не публикуйте в репозиториях.
Подключение клиента
Карточки в чате
В claude.ai результат показывается интерактивной карточкой с живым прогрессом и медиа. В Claude Code приходит inline-превью в терминал. В остальных клиентах агент присылает ссылки на файл в полном качестве.
Одна команда в терминале — и инструменты Clipia доступны в любой сессии, включая headless и CI. Ключ возьмите из переменной окружения, не вшивайте его в команду:
claude mcp add --transport http clipia https://api.clipia.ai/mcp \
--header "Authorization: Bearer $CLIPIA_API_KEY"После этого попросите Claude: «Сгенерируй в Clipia изображение неонового города» — превью придёт прямо в терминал.
claude.ai (веб, десктоп, мобильное приложение) подключается через вход в аккаунт Clipia (OAuth), ключ указывать не нужно:
- Откройте Settings → Connectors.
- Нажмите «Add custom connector» и вставьте URL
https://api.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://api.clipia.ai/mcp. - Authentication — OAuth, отметьте «I trust this application» и нажмите Create.
- Войдите в аккаунт Clipia. В чате нажмите «+» → More → Clipia и просите генерации обычным текстом.
Добавьте сервер в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json в проекте, затем перезапустите Cursor. Подставьте ключ из переменной окружения вместо плейсхолдера:
{
"mcpServers": {
"clipia": {
"url": "https://api.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://api.clipia.ai/mcp",
"headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
}
}
}Добавьте сервер в ~/.codeium/windsurf/mcp_config.json (поле serverUrl — особенность Windsurf), затем обновите список серверов в панели Cascade → MCPs:
{
"mcpServers": {
"clipia": {
"serverUrl": "https://api.clipia.ai/mcp",
"headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
}
}
}Песочница
Ключи с префиксом clipia_test_ возвращают мгновенные mock-результаты без списания кредитов — удобно отлаживать разбор ответов, polling и пайплайны. Боевые ключи показывают стоимость каждой генерации в ответе, а инструмент get_balance — остаток кредитов.
Полный справочник инструментов — на странице Инструменты.