Перейти к содержимому
MCP

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), ключ указывать не нужно:

  1. Откройте Settings → Connectors.
  2. Нажмите «Add custom connector» и вставьте URL https://mcp.clipia.ai/mcp.
  3. Нажмите Connect и войдите в свой аккаунт Clipia.
  4. В новом чате попросите сгенерировать картинку или видео — в сообщении появится живая карточка Clipia с прогрессом и кнопкой «Оригинал».
  1. В ChatGPT (веб): Settings → Apps & Connectors → Advanced settings → включите Developer mode (Plus, Pro, Business, Enterprise).
  2. Apps & Connectors → Create. Name — Clipia, MCP Server URL https://mcp.clipia.ai/mcp.
  3. Authentication — OAuth, отметьте «I trust this application» и нажмите Create.
  4. Войдите в аккаунт 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 — остаток кредитов.

Полный справочник инструментов — на странице Инструменты.