---
title: Clipia MCP
description: Подключите 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` и `edit_presentation` появляются только при включённых возможностях. Семь app-only helpers обслуживают интерактивные карточки и не занимают контекст AI-агента. Авторизация — обычным API-ключом публичного API; оплата — кредитами вашего аккаунта Clipia.

<Callout type="info" title="Endpoint">
Адрес сервера (Streamable HTTP): `https://mcp.clipia.ai/mcp`. Поддерживаемые схемы авторизации: `Authorization: Bearer clipia_...` (рекомендуется), `Authorization: Key <ключ>`, `X-Api-Key: <ключ>`.
</Callout>

## Где взять ключ

API-ключ создаётся в [консоли разработчика](/ru/developer). Ключи с префиксом `clipia_live_` — боевые (списывают кредиты), ключи с префиксом `clipia_test_` — песочница: мгновенные mock-ответы без списания кредитов, удобно для отладки агентов и CI.

<Callout type="warn" title="Ключ — серверный секрет">
  Боевой ключ показывается один раз при создании — это эквивалент пароля к
  балансу кредитов. Храните его в переменной окружения или менеджере секретов,
  не публикуйте в репозиториях.
</Callout>

## Подключение клиента

<Callout type="info" title="Карточки в чате">
  В claude.ai результат показывается интерактивной карточкой с живым прогрессом
  и медиа. В Claude Code приходит inline-превью в терминал. В остальных клиентах
  агент присылает ссылки на файл в полном качестве.
</Callout>

<Tabs items={['Claude Code', 'claude.ai', 'ChatGPT', 'Cursor', 'VS Code', 'Windsurf']}>

<Tab value="Claude Code">

Одна команда в терминале — и инструменты Clipia доступны в любой сессии, включая headless и CI. Ключ возьмите из переменной окружения, не вшивайте его в команду:

```bash
claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer $CLIPIA_API_KEY"
```

После этого попросите Claude: «Сгенерируй в Clipia изображение неонового города» — превью придёт прямо в терминал.

</Tab>

<Tab value="claude.ai">

claude.ai (веб, десктоп, мобильное приложение) подключается через вход в аккаунт Clipia (OAuth), ключ указывать не нужно:

1. Откройте Settings → Connectors.
2. Нажмите «Add custom connector» и вставьте URL `https://mcp.clipia.ai/mcp`.
3. Нажмите Connect и войдите в свой аккаунт Clipia.
4. В новом чате попросите сгенерировать картинку или видео — в сообщении появится живая карточка Clipia с прогрессом и кнопкой «Оригинал».

</Tab>

<Tab value="ChatGPT">

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 и просите генерации обычным текстом.

</Tab>

<Tab value="Cursor">

Добавьте сервер в `~/.cursor/mcp.json` (глобально) или `.cursor/mcp.json` в проекте, затем перезапустите Cursor. Подставьте ключ из переменной окружения вместо плейсхолдера:

```json
{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
    }
  }
}
```

</Tab>

<Tab value="VS Code">

Создайте `.vscode/mcp.json` в рабочей папке (или через команду «MCP: Add Server»). Откройте Copilot Chat в режиме Agent — инструменты Clipia появятся в списке:

```json
{
  "servers": {
    "clipia": {
      "type": "http",
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
    }
  }
}
```

</Tab>

<Tab value="Windsurf">

Добавьте сервер в `~/.codeium/windsurf/mcp_config.json` (поле `serverUrl` — особенность Windsurf), затем обновите список серверов в панели Cascade → MCPs:

```json
{
  "mcpServers": {
    "clipia": {
      "serverUrl": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
    }
  }
}
```

</Tab>

</Tabs>

## Песочница

Ключи с префиксом `clipia_test_` возвращают мгновенные mock-результаты без списания кредитов — удобно отлаживать разбор ответов, polling и пайплайны. Боевые ключи показывают стоимость каждой генерации в ответе, а инструмент `get_balance` — остаток кредитов.

Полный справочник инструментов — на странице [Инструменты](/docs/mcp/tools).