> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Сервер MCP

> Узнайте, как интегрировать сервер MCP SUNRA с Cursor, VS Code, Cline, Windsurf и другими средами разработки для беспрепятственного доступа к моделям ИИ.

# Настройка сервера MCP SUNRA

Сервер SUNRA Model Context Protocol (MCP) обеспечивает бесшовную интеграцию с популярными средами разработки, позволяя вам получать доступ к моделям ИИ SUNRA непосредственно из вашего редактора или IDE. В этом руководстве вы узнаете, как настроить сервер MCP с помощью различных инструментов.

## Что такое MCP?

Model Context Protocol (MCP) — это стандартизированный способ для помощников ИИ безопасного доступа к внешним ресурсам и инструментам. Сервер MCP SUNRA позволяет:

* **Перечислять и искать модели ИИ**, доступные на SUNRA
* **Отправлять запросы** к любой конечной точке модели
* **Проверять статус** и получать результаты из системы очередей
* **Загружать файлы** и управлять схемами моделей
* **Беспрепятственно управлять аутентификацией API**

## Предварительные требования

Перед настройкой сервера MCP убедитесь, что у вас есть:

1. **Node.js** (версия 18 или выше)
2. **Ключ API SUNRA** из [вашей панели управления](https://sunra.ai/dashboard/api-tokens)
3. Установленный предпочитаемый редактор/IDE

## Установка

Сервер MCP SUNRA доступен в виде пакета npm:

```bash theme={null}
npm install -g @sunra/mcp-server
```

Или используйте его напрямую с npx (рекомендуется):

```bash theme={null}
npx @sunra/mcp-server
```

## Конфигурация по редакторам

### Cursor

Cursor поддерживает MCP через свой файл конфигурации. Создайте или обновите `.cursor/mcp.json` в корне вашего проекта:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
```

**Альтернативная глобальная конфигурация** в ваших пользовательских настройках:

1. Откройте настройки Cursor
2. Перейдите в «Серверы MCP»
3. Добавьте новый сервер с:
   * **Имя**: `sunra-mcp-server`
   * **Команда**: `npx`
   * **Аргументы**: `@sunra/mcp-server`

### VS Code

Для VS Code с поддержкой MCP (требуется совместимое расширение):

Создайте `.vscode/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "ваш-ключ-api-здесь"
      }
    }
  }
}
```

### Cline

Cline поддерживает серверы MCP через свои настройки. Добавьте в свою конфигурацию Cline:

```json theme={null}
{
  "mcpServers": {
    "sunra": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "description": "Доступ к модели ИИ SUNRA"
    }
  }
}
```

### Windsurf

Для IDE Windsurf настройте MCP в настройках рабочей области:

```json theme={null}
{
  "mcp": {
    "servers": {
      "sunra-mcp-server": {
        "command": "npx",
        "args": ["@sunra/mcp-server"],
        "timeout": 30000
      }
    }
  }
}
```

### Claude Desktop

Добавьте в свой файл конфигурации Claude Desktop:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
```

### Другие инструменты, совместимые с MCP

Для любого другого инструмента, поддерживающего MCP, используйте этот общий шаблон конфигурации:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "${SUNRA_KEY}"
      }
    }
  }
}
```

## Настройка среды

### Установка ключа API

Вы можете настроить свой ключ API SUNRA несколькими способами:

#### Вариант 1: переменная среды (рекомендуется)

```bash theme={null}
export SUNRA_KEY="ваш-ключ-api-здесь"
```

Для Windows:

```cmd theme={null}
set SUNRA_KEY=ваш-ключ-api-здесь
```

#### Вариант 2: файл конфигурации

Некоторые редакторы позволяют устанавливать переменные среды непосредственно в конфигурации MCP:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "ваш-ключ-api-здесь"
      }
    }
  }
}
```

#### Вариант 3: конфигурация во время выполнения

Сервер MCP также поддерживает установку ключа API во время выполнения с помощью инструмента `set-sunra-key`.

## Доступные инструменты MCP

После настройки вы получите доступ к этим инструментам через своего помощника ИИ:

### Управление моделями

* `list-models` - просмотр всех доступных моделей ИИ
* `search-models` - поиск моделей по ключевым словам
* `model-schema` - получение схем ввода-вывода для конкретных моделей

### Управление запросами

* `submit` - отправка запросов к конечным точкам модели
* `status` - проверка статуса запроса и журналов
* `result` - получение завершенных результатов
* `cancel` - отмена выполняемых запросов
* `subscribe` - отправка и ожидание завершения

### Управление файлами

* `upload` - загрузка файлов в хранилище SUNRA

## Примеры использования

### Список доступных моделей

```
Используйте инструмент list-models, чтобы показать мне, какие модели ИИ доступны.
```

### Создание изображения

```
Используйте инструмент submit, чтобы создать изображение с помощью конечной точки black-forest-labs/flux-1.1-pro/text-to-image. 
Используйте подсказку: «Безмятежный горный пейзаж на закате»
```

### Проверка статуса запроса

```
Проверьте статус запроса с идентификатором: pd_xxxxxx
```

## Устранение неполадок

### Общие проблемы

**Сервер MCP не найден**

* Убедитесь, что Node.js установлен и доступен
* Попробуйте установить глобально: `npm install -g @sunra/mcp-server`
* Убедитесь, что путь к команде указан правильно

**Ошибки аутентификации**

* Убедитесь, что установлена переменная среды SUNRA\_KEY
* Убедитесь, что ваш ключ API действителен на [панели управления SUNRA](https://sunra.ai/dashboard/api-tokens)
* Попробуйте установить ключ с помощью инструмента `set-sunra-key`

**Тайм-ауты подключения**

* Увеличьте значения тайм-аута в вашей конфигурации
* Проверьте подключение к Интернету
* Проверьте статус API SUNRA

**Ошибки разрешений**

* Обеспечьте надлежащие права доступа к файлам конфигурации
* Попробуйте запустить с соответствующими правами пользователя

### Получение помощи

Если у вас возникли проблемы:

1. Проверьте [документацию SUNRA](https://docs.sunra.ai)
2. Просмотрите документацию MCP вашего редактора
3. Сообщите о проблеме на [GitHub](https://github.com/sunra-ai/sunra-clients/issues)

## Следующие шаги

После настройки сервера MCP:

1. **Изучите модели**: используйте `list-models`, чтобы увидеть все доступные возможности ИИ
2. **Попробуйте примеры**: начните с простых генераций текста в изображение или текста в видео
3. **Создайте рабочие процессы**: объедините несколько моделей для сложных конвейеров ИИ
4. **Отслеживайте использование**: отслеживайте использование API на [панели управления SUNRA](https://sunra.ai/dashboard/)

Интеграция MCP позволяет легко встраивать мощные модели ИИ непосредственно в ваш рабочий процесс разработки, обеспечивая быстрое прототипирование и бесшовные функции на основе ИИ в ваших приложениях.