---
title: "MCP-сервер"
description: "MCP-сервер Весело для Claude, ChatGPT, Claude Code, Cursor, VS Code и Codex без ключа: вход на veselo.ai и кнопка «Разрешить». Видео, картинки, цены, баланс."
url: https://veselo.ai/docs/mcp
updated: 2026-11-16T01:51:29.962Z
---

# MCP-сервер

MCP-сервер Весело для Claude, ChatGPT, Claude Code, Cursor, VS Code и Codex без ключа: вход на veselo.ai и кнопка «Разрешить». Видео, картинки, цены, баланс.

Обновлено: 16 ноября 2026 г.

MCP — способ дать ИИ-помощнику инструменты. Через наш MCP-сервер помощник сам снимает видео, рисует картинки, смотрит модели и цены, задаёт вопросы другим моделям, проверяет баланс и расход. Деньги, лимиты и ошибки — те же, что у API.

## Подключить без ключа

1. Добавь в свою нейросеть адрес `https://veselo.ai/mcp` — как именно, написано ниже для [Claude](https://veselo.ai/docs/mcp#claude), [Claude Code](https://veselo.ai/docs/mcp#claude-code), [Cursor](https://veselo.ai/docs/mcp#cursor), [VS Code](https://veselo.ai/docs/mcp#vscode), [ChatGPT](https://veselo.ai/docs/mcp#chatgpt) и [Codex](https://veselo.ai/docs/mcp#codex-oauth).
2. Нейросеть откроет veselo.ai. Войди как обычно: Telegram, Яндекс ID, VK ID или почта.
3. Нажми «Разрешить». Можно сразу поставить лимит расхода в месяц — или оставить без лимита.
4. Готово: ключ выпускать и копировать не нужно. Платные инструменты — видео, картинки и ответы моделей — тратят API-счёт: пополни его от 100 ₽ в [кабинете](https://veselo.ai/developer/wallet), нейросеть сама подскажет, когда пора.

> Кнопки «Добавить в Claude», «Добавить в Cursor», «Добавить в VS Code» и шаги для ChatGPT и Codex — на странице [Подключить к нейросети](https://veselo.ai/connect). Подключённые нейросети видны в [кабинете API](https://veselo.ai/developer): там можно поменять лимит или нажать «Отключить» — доступ пропадёт сразу.

| Что | Значение |
| --- | --- |
| Адрес | `https://veselo.ai/mcp` |
| Протокол | Streamable HTTP, JSON-RPC 2.0, без сессий |
| Вход | без ключа — кнопкой «Разрешить» на veselo.ai (OAuth 2.1, см. [для разработчиков клиентов](https://veselo.ai/docs/mcp#oauth)); или ключ: заголовок `Authorization: Bearer sk-vsl-…` |

## Инструменты

| Инструмент | Аргументы | Что делает |
| --- | --- | --- |
| `list_models` | `type`, `query`, `limit` — все необязательные | модели с ценами в рублях; `type` — text (по умолчанию), image, video или audio (озвучка и музыка); `query` — поиск по id и названию, `limit` — сколько показать, по умолчанию 30 |
| `get_model` | `id` | одна модель подробно: контекст, что принимает на вход, цены |
| `chat` | `model`; `prompt` или `messages`; `system`, `max_tokens`, `temperature` | спросить модель: возвращает текст ответа и цену. Платно |
| `get_balance` | — | сколько денег доступно — как `GET /v1/balance` |
| `get_usage` | `days` | расход по дням и моделям — как `GET /v1/usage` |
| `generate_image` | `model`, `prompt`; `aspect_ratio`, `quality`, `n` | нарисовать картинки: ссылки и цена в рублях, плюс structuredContent с тем же ответом. Платно, как POST /v1/images/generations |
| `generate_speech` | `model`, `input`; `voice` | озвучить текст: ссылка на MP3 и цена в рублях. Платно, как `POST /v1/audio/speech` |
| `generate_music` | `model`, `prompt` | сочинить трек: ссылка на MP3 и цена в рублях. Платно, как `POST /v1/audio/music` |
| `generate_video` | `model`, `prompt`; `duration`, `resolution`, `aspect_ratio`, `audio` | запустить видео: возвращает `id` и цену. Платно, как `POST /v1/videos` |
| `get_video` | `id` | статус видео и ссылка на готовый ролик — как `GET /v1/videos/{id}` |

Каждый вызов `chat`, `generate_image`, `generate_speech` или `generate_music` списывает деньги с API-счёта, как обычный запрос, а `generate_video` — цену ролика, как [видео по API](https://veselo.ai/docs/video). Ошибка инструмента приходит текстом с кодом из [таблицы ошибок](https://veselo.ai/docs/errors) в скобках, например `(insufficient_balance)`: помощник видит причину.

> Сколько раз звать платные инструменты, помощник решает сам — поставь лимит в месяц: на экране «Разрешить» или потом в кабинете API (а для ключа — отдельный ключ с лимитом).

## Claude — сайт и приложение

Настройки → «Коннекторы» (Settings → Connectors) → «Добавить свой коннектор» (Add custom connector). Название — Весело, адрес — `https://veselo.ai/mcp`, остальные поля не нужны. Нажми «Подключить» (Connect): откроется veselo.ai — войди и нажми «Разрешить». Коннектор работает и на сайте claude.ai, и в приложениях Claude на компьютере и телефоне.

## Claude Code

**Терминал**

```
claude mcp add --transport http veselo https://veselo.ai/mcp
```

Потом в Claude Code набери `/mcp`, выбери veselo и «Authenticate» — или выполни в терминале `claude mcp login veselo`. Откроется veselo.ai: войди и нажми «Разрешить». Claude Code сам обновляет вход, повторять не нужно.

## Cursor

Файл `~/.cursor/mcp.json` — для всех проектов, или `.cursor/mcp.json` — в проекте. После сохранения в настройках MCP у сервера появится кнопка входа: она откроет veselo.ai.

**mcp.json**

```
{
  "mcpServers": {
    "veselo": { "url": "https://veselo.ai/mcp" }
  }
}
```

## VS Code

Файл `.vscode/mcp.json` в проекте. При первом запуске сервера VS Code попросит войти — откроется veselo.ai.

**.vscode/mcp.json**

```
{
  "servers": {
    "veselo": { "type": "http", "url": "https://veselo.ai/mcp" }
  }
}
```

## ChatGPT

Открой [плагины ChatGPT](https://chatgpt.com/plugins), нажми «+» → «Add custom MCP server». Адрес — `https://veselo.ai/mcp`, вход — OAuth. Создай плагин и включи его в чате: ChatGPT откроет veselo.ai — войди и нажми «Разрешить». Свои MCP-серверы ChatGPT подключает в режиме разработчика (Developer mode) или на тарифах Business, Enterprise и Edu.

## Codex

**Терминал**

```
codex mcp add veselo --url https://veselo.ai/mcp
codex mcp login veselo
```

Вторая команда откроет veselo.ai: войди и нажми «Разрешить».

## С ключом — для программ без входа через браузер

Если программа не умеет входить через браузер — или работает без человека на сервере, — передай ей ключ `sk-vsl-…` из [кабинета](https://veselo.ai/developer) в заголовке `Authorization`.

## Claude с ключом

Свой коннектор с заголовком: Настройки → «Коннекторы» → «Добавить свой коннектор» (Settings → Connectors → Add custom connector), адрес — `https://veselo.ai/mcp`. В «Дополнительных настройках» (Advanced settings) в поле Request headers впиши `Authorization: Bearer sk-vsl-…`.

## Claude Desktop через mcp-remote

Запасной способ — через мост `mcp-remote`, нужен установленный Node.js. Открой Settings → Developer → Edit Config и добавь в `claude_desktop_config.json`:

**claude_desktop_config.json**

```
{
  "mcpServers": {
    "veselo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://veselo.ai/mcp", "--header", "Authorization:${VESELO_AUTH}"],
      "env": { "VESELO_AUTH": "Bearer sk-vsl-…" }
    }
  }
}
```

Перезапусти Claude Desktop. Ключ стоит в `env`, а не в `args`: так пробел после `Bearer` не ломает запуск на Windows.

## Claude Code с ключом

**Терминал**

```
claude mcp add --transport http veselo https://veselo.ai/mcp --header "Authorization: Bearer $VESELO_API_KEY"
```

## Cursor с ключом

Файл `~/.cursor/mcp.json` — для всех проектов, или `.cursor/mcp.json` — в проекте:

**mcp.json**

```
{
  "mcpServers": {
    "veselo": {
      "url": "https://veselo.ai/mcp",
      "headers": { "Authorization": "Bearer sk-vsl-…" }
    }
  }
}
```

## VS Code с ключом

Файл `.vscode/mcp.json` в проекте. Ключ VS Code спросит при первом запуске и сохранит у себя:

**.vscode/mcp.json**

```
{
  "inputs": [
    { "type": "promptString", "id": "veselo-key", "description": "Ключ API Весело (sk-vsl-…)", "password": true }
  ],
  "servers": {
    "veselo": {
      "type": "http",
      "url": "https://veselo.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:veselo-key}" }
    }
  }
}
```

## Codex с ключом

В `~/.codex/config.toml`. Ключ Codex возьмёт из переменной окружения `VESELO_API_KEY`:

**config.toml**

```
[mcp_servers.veselo]
url = "https://veselo.ai/mcp"
bearer_token_env_var = "VESELO_API_KEY"
```

**Через mcp-remote**

```
[mcp_servers.veselo]
command = "npx"
args = ["-y", "mcp-remote", "https://veselo.ai/mcp", "--header", "Authorization:${VESELO_AUTH}"]
env = { VESELO_AUTH = "Bearer sk-vsl-…" }
```

Вариант через `mcp-remote` — для версий Codex, которые не знают поля `url`.

## Другие клиенты

Клиент умеет Streamable HTTP с заголовками — укажи адрес и заголовок `Authorization`. Не умеет — запусти мост `mcp-remote`, он передаст заголовок за клиента:

**Терминал**

```
npx -y mcp-remote https://veselo.ai/mcp --header "Authorization: Bearer $VESELO_API_KEY"
```

## Для разработчиков клиентов: вход по OAuth

Вход без ключа сделан по спецификации MCP Authorization — OAuth 2.1 с PKCE. Клиент, который её умеет, находит всё сам по ответу 401 от `https://veselo.ai/mcp`.

| Что | Значение |
| --- | --- |
| Ответ 401 | `WWW-Authenticate: Bearer resource_metadata="https://veselo.ai/.well-known/oauth-protected-resource/mcp", scope="mcp"` |
| Описание ресурса (RFC 9728) | `https://veselo.ai/.well-known/oauth-protected-resource/mcp` |
| Сервер авторизации (RFC 8414) | `https://veselo.ai/.well-known/oauth-authorization-server`, issuer — `https://veselo.ai` |
| Регистрация клиента (RFC 7591) | `POST https://veselo.ai/oauth/register`. Адрес возврата — https, `http://localhost` или `http://127.0.0.1` с любым портом или своя схема приложения |
| Вход | `GET https://veselo.ai/oauth/authorize`: `response_type=code`, PKCE только `S256`, `resource=https://veselo.ai/mcp`. В адресе возврата — `code`, `state` и `iss` |
| Токены | `POST https://veselo.ai/oauth/token` (form-urlencoded): токен доступа живёт час, токен обновления — 90 дней и меняется при каждом обновлении |
| Отзыв (RFC 7009) | `POST https://veselo.ai/oauth/revoke`: отзыв токена обновления отключает программу |
| Область | `mcp` |

Токен годится только для `https://veselo.ai/mcp`. Шлюз `https://veselo.ai/v1` принимает только ключ `sk-vsl-…`.

## Проверить без клиента

**Список инструментов**

```
curl https://veselo.ai/mcp \
  -H "Authorization: Bearer $VESELO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'
```

**Вопрос модели**

```
curl https://veselo.ai/mcp \
  -H "Authorization: Bearer $VESELO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "chat", "arguments": {"model": "deepseek/deepseek-v4.1-flash-ultrafast", "prompt": "Привет", "max_tokens": 100}}}'
```

**Ответ**

```
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{ "type": "text", "text": "Привет. Чем помочь?\n\n— deepseek/deepseek-v4.1-flash-ultrafast, 0.01 ₽" }],
    "structuredContent": {
      "text": "Привет. Чем помочь?",
      "model": "deepseek/deepseek-v4.1-flash-ultrafast",
      "cost_rub": 0.01,
      "usage": { "prompt_tokens": 9, "completion_tokens": 6, "total_tokens": 15, "cost_rub": 0.01 }
    }
  }
}
```

[← Ключ для нейросети](https://veselo.ai/docs/agents) · [Методы API →](https://veselo.ai/docs/reference)

[Вся документация одним текстом](https://veselo.ai/docs/llms.txt) · [Все модели и цены](https://veselo.ai/models)

## Разделы документации

### Начало

- [Быстрый старт](https://veselo.ai/docs)
- [Ключи](https://veselo.ai/docs/auth)
- [Цены и списания](https://veselo.ai/docs/pricing)
- [Модели](https://veselo.ai/docs/models)

### Как сделать

- [Сообщения и параметры](https://veselo.ai/docs/chat)
- [Стриминг](https://veselo.ai/docs/streaming)
- [Вызов функций](https://veselo.ai/docs/tools)
- [Ответ в JSON](https://veselo.ai/docs/structured-output)
- [Провайдеры](https://veselo.ai/docs/providers)
- [Без цензуры](https://veselo.ai/docs/uncensored)
- [Картинки во входе](https://veselo.ai/docs/vision)
- [Картинки](https://veselo.ai/docs/images)
- [Видео](https://veselo.ai/docs/video)
- [Озвучка](https://veselo.ai/docs/speech)
- [Музыка](https://veselo.ai/docs/music)
- [SDK и программы](https://veselo.ai/docs/sdks)
- [Claude Code](https://veselo.ai/docs/anthropic)
- [Ключ для нейросети](https://veselo.ai/docs/agents)
- **MCP**

### Справочник

- [Методы API](https://veselo.ai/docs/reference)
- [Ошибки](https://veselo.ai/docs/errors)
- [Лимиты](https://veselo.ai/docs/limits)
- [Заголовки](https://veselo.ai/docs/headers)

### Ещё

- [Вопросы](https://veselo.ai/docs/faq)
- [Данные и приватность](https://veselo.ai/docs/privacy)
- [Изменения](https://veselo.ai/docs/changelog)
