# Подключение MCP-сервера

> Как подключить MCP-сервер Slicer к Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT, Windsurf и другим клиентам — через OAuth или API-токен.

Источник: https://docs.slicer.media/mcp/connect/

Сервер один для всех клиентов:

| Параметр | Значение |
| --- | --- |
| Адрес | `https://api.slicer.media/mcp` |
| Транспорт | Streamable HTTP (в настройках клиентов — «HTTP», `http` или `streamable-http`) |
| Имя | `slicer` (можно любое — так сервер будет называться в клиенте) |
| Вход | OAuth — браузер откроет вход в Slicer и окно согласия; или заголовок `Authorization: Bearer slc_…` |

**OAuth** удобнее: не нужно создавать токен вручную, а доступ и лимит расходов вы выбираете в окне согласия. **API-токен** подходит, когда клиент работает без браузера (сервер, CI) или вы хотите управлять доступом сами — создайте его в **Профиль** → «Для разработчиков» ([Токены и области доступа](https://docs.slicer.media/api/authentication/)).

Выберите свой клиент:

**Claude**

Свои коннекторы работают в Claude на сайте, в приложении для компьютера и в мобильных приложениях на всех тарифах; на бесплатном тарифе — один свой коннектор.

### 1. Добавьте коннектор

Откройте **Customize → Connectors** (в приложении для компьютера — **Customize** на боковой панели, затем **Connectors**), нажмите **\+ Add** → **Add custom connector**. Введите имя `Slicer` и адрес `https://api.slicer.media/mcp`, нажмите **Continue**.

### 2. Выберите вход

В **Authentication** выберите **Sign in now**, в **OAuth client** — **Use Claude's published identity (Recommended)**. Нажмите **Add**.

### 3. Разрешите доступ в Slicer

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

**Team и Enterprise.** Коннектор для всей организации добавляет владелец: **Organization settings → Connectors → Add** → **Custom** → **Web**, дальше — те же шаги. Участники находят его в **Customize → Connectors** с меткой «Custom» и нажимают **Connect** — каждый входит в свой аккаунт Slicer.

**Мобильные приложения.** Коннектор, добавленный на сайте или в приложении для компьютера, появляется и в мобильном приложении Claude.

Вход по заголовку с API-токеном в Claude доступен не всем организациям — используйте OAuth.

**Claude Code**

Добавьте сервер и войдите через браузер:

Терминал:

```bash
claude mcp add --transport http slicer https://api.slicer.media/mcp
```

Затем в Claude Code выполните `/mcp`, выберите `slicer` и пройдите вход в браузере — или сразу из терминала: `claude mcp login slicer`. Сервер добавляется в текущий проект; чтобы он был во всех проектах, добавьте `--scope user`.

**С API-токеном** — когда вход через браузер невозможен:

Терминал:

```bash
claude mcp add --transport http slicer https://api.slicer.media/mcp \
  --header "Authorization: Bearer $SLICER_TOKEN"
```

Чтобы токен не сохранялся в настройках открытым текстом и сервер был общим для команды, опишите его в `.mcp.json` в корне проекта — Claude Code подставит значение переменной окружения при запуске:

.mcp.json:

```json
{
  "mcpServers": {
    "slicer": {
      "type": "http",
      "url": "https://api.slicer.media/mcp",
      "headers": { "Authorization": "Bearer ${SLICER_TOKEN}" }
    }
  }
}
```

> **Заметка.** Если задан заголовок `Authorization`, а токен отозван или истёк, Claude Code не переключится на OAuth сам — он сообщит об ошибке подключения. Обновите токен или удалите заголовок.

Claude Code умеет выполнять команды в терминале, поэтому он сам загружает ваши локальные файлы по ссылке `create_upload_link` (`curl -T`).

**Cursor**

Добавьте сервер в `~/.cursor/mcp.json` (для всех проектов) или в `.cursor/mcp.json` (для одного проекта):

~/.cursor/mcp.json:

```json
{
  "mcpServers": {
    "slicer": {
      "url": "https://api.slicer.media/mcp"
    }
  }
}
```

Сохраните файл и перезапустите Cursor. При первом обращении к серверу Cursor предложит войти — откроется браузер с входом в Slicer и окном согласия. Включить и выключить сервер можно в **Customize → MCPs**.

**С API-токеном** — Cursor подставит переменную окружения:

~/.cursor/mcp.json:

```json
{
  "mcpServers": {
    "slicer": {
      "url": "https://api.slicer.media/mcp",
      "headers": { "Authorization": "Bearer ${env:SLICER_TOKEN}" }
    }
  }
}
```

**VS Code**

MCP-серверы в VS Code работают в режиме агента GitHub Copilot.

### 1. Добавьте сервер

Откройте палитру команд и выберите **MCP: Add Server** → **HTTP**, введите `https://api.slicer.media/mcp` и имя `slicer`, затем выберите, где сохранить: для всех проектов или для текущей папки.

### 2. Войдите

При первом подключении VS Code откроет браузер: войдите в Slicer и разрешите доступ. Статус входа — в меню **Accounts**.

**С API-токеном.** Откройте **MCP: Open User Configuration** и добавьте сервер с запросом токена — VS Code спросит его один раз и сохранит в защищённом хранилище:

mcp.json:

```json
{
  "inputs": [
    { "type": "promptString", "id": "slicer-token", "description": "Slicer API token", "password": true }
  ],
  "servers": {
    "slicer": {
      "type": "http",
      "url": "https://api.slicer.media/mcp",
      "headers": { "Authorization": "Bearer ${input:slicer-token}" }
    }
  }
}
```

В организациях на тарифах Copilot Business и Enterprise MCP-серверы включает администратор (политика «MCP servers in Copilot»).

**Codex**

Добавьте сервер и войдите через браузер:

Терминал:

```bash
codex mcp add slicer --url https://api.slicer.media/mcp
codex mcp login slicer
```

**С API-токеном** — Codex будет брать его из переменной окружения:

Терминал:

```bash
codex mcp add slicer --url https://api.slicer.media/mcp --bearer-token-env-var SLICER_TOKEN
```

То же в файле настроек `~/.codex/config.toml`:

~/.codex/config.toml:

```toml
[mcp_servers.slicer]
url = "https://api.slicer.media/mcp"
bearer_token_env_var = "SLICER_TOKEN"
```

Эти настройки общие для Codex в терминале, расширения для IDE и приложения ChatGPT для компьютера. В расширении для IDE сервер можно добавить и через меню: шестерёнка → **MCP servers** → **Add server**. Список серверов — `codex mcp list` или `/mcp` в Codex.

**ChatGPT**

ChatGPT подключает свои MCP-серверы на сайте chatgpt.com, вход — только через OAuth (заголовок с токеном ChatGPT не поддерживает).

### 1. Создайте плагин

Откройте [chatgpt.com/plugins](https://chatgpt.com/plugins), нажмите **+** → **Add custom MCP server**. Введите имя `Slicer` и описание, в **Connection** укажите **Server URL** `https://api.slicer.media/mcp`, вход — **OAuth**.

### 2. Подтвердите и установите

Нажмите **I understand and want to continue** → **Create as a plugin**, затем установите плагин и войдите в Slicer в открывшемся окне.

### 3. Вызовите в чате

Упомяните плагин через `@` и опишите задачу.

Добавлять свои MCP-серверы можно не на всех тарифах ChatGPT, а в рабочих пространствах организаций это обычно делают администраторы. Актуальные условия — в справке OpenAI.

**Другие**

**Windsurf (Devin Desktop).** Откройте файл настроек MCP: на панели Cascade меню **…** → **Open MCP config file**, и добавьте сервер:

mcp_config.json:

```json
{
  "mcpServers": {
    "slicer": {
      "serverUrl": "https://api.slicer.media/mcp"
    }
  }
}
```

Вход — через OAuth в браузере; с токеном добавьте `"headers": { "Authorization": "Bearer ${env:SLICER_TOKEN}" }`.

**Любой другой клиент** с поддержкой удалённых MCP-серверов подключается по общим параметрам из таблицы выше. Если клиент умеет OAuth, ему достаточно адреса: на запрос без токена сервер отвечает `401` со ссылкой на описание входа, и клиент сам найдёт сервер авторизации ([Вход: OAuth и токен](https://docs.slicer.media/mcp/authentication/)). Если не умеет — передайте заголовок `Authorization: Bearer slc_…`.

**Проверка без ИИ.** MCP Inspector показывает инструменты сервера и вызывает их вручную (нужен Node.js 22.19+):

Терминал:

```bash
npx @modelcontextprotocol/inspector --server-url https://api.slicer.media/mcp --transport http
```

Список инструментов из командной строки, с токеном:

Терминал:

```bash
npx @modelcontextprotocol/inspector --cli https://api.slicer.media/mcp --transport http \
  --header "Authorization: Bearer $SLICER_TOKEN" --method tools/list
```

## Проверьте подключение

Спросите ассистента:

> Сколько у меня токенов в Slicer? И покажи мои последние проекты.

Ассистент вызовет `get_account` и `list_projects` и ответит балансом и списком проектов. Дальше можно просить собрать ролик — монтаж ассистентом бесплатен ([Примеры сценариев](https://docs.slicer.media/mcp/examples/)). Если клиент сообщает об ошибке входа — пройдите вход заново (в Claude Code — `/mcp`, в Codex — `codex mcp login slicer`) или проверьте токен: он не отозван, срок не истёк.

## Как отключить

-   **Подключение по OAuth** — **Профиль** → «Для разработчиков» → «Подключённые приложения» → «Отключить». Клиент сразу теряет доступ.
-   **API-токен** — там же, в списке токенов, «Отозвать».
-   В самом клиенте — удалите сервер в настройках MCP (в Claude Code — `claude mcp remove slicer`).

## Что дальше

[Вход: OAuth и токенОкно согласия, доступы, сроки токенов.](https://docs.slicer.media/mcp/authentication/)[Примеры сценариевЧто просить у агента.](https://docs.slicer.media/mcp/examples/)[Безопасность и расходыКак агент подтверждает цену.](https://docs.slicer.media/mcp/costs/)