---
url: https://flip-chart.ru/developers/on-premise/config/mcp.md
description: >-
  Конфигурация MCP-сервера flip On-Premise для подключения AI-ассистентов и
  агентов по Model Context Protocol: отдельный домен, OAuth-авторизация, поля
  config.yaml.
---

# Конфигурация приложения mcp-server

 Скачать пример файла конфигурации 

MCP-сервер (Model Context Protocol) обеспечивает подключение AI-ассистентов и агентов к flip. Сервис публикуется на отдельном домене (`mcp.example.flip-chart.ru`), авторизация клиентов — через OAuth на стороне backend.

Файл конфигурации монтируется в контейнер по пути `/flip/cfg/config.yaml`.

::: danger Настройка backend
Требуется `McpAgentTokens.Enable: true` в [конфигурации backend](/on-premise/config/backend#mcpagenttokens). Значение `flipApi.clientId` соответствует встроенному OAuth-клиенту `flip-mcp`.
:::

## Описание конфигурационных полей

### server

* **name**: Имя сервера, передаётся клиентам MCP.\
  Пример: `flip-mcp-server`
* **version**: Версия, передаётся клиентам MCP.\
  Пример: `"0.1.0"`
* **transport**: Транспорт. Значение `http`.
* **httpAddr**: Адрес и порт HTTP-сервера.\
  Пример: `":8090"`

### logLevel

* **logLevel**: Уровень логирования: `debug`, `info`, `warn`, `error`.\
  Пример: `info`

### flipApi

* **serverUrl**: Внешний адрес приложения (без пути `/app`). Используется в OAuth-метаданных; должен быть доступен клиентам MCP.\
  Пример: `https://example.flip-chart.ru`
* **frontendUrl**: Внешний адрес интерфейса flip.\
  Пример: `https://example.flip-chart.ru`
* **clientId**: Идентификатор OAuth-клиента, зарегистрированного в backend.\
  Пример: `flip-mcp`
* **publicUrl**: Публичный адрес MCP-сервера.\
  Пример: `https://mcp.example.flip-chart.ru`
* **internalUrl**: Внутренний адрес backend для запросов внутри сети. Если не задан, используется `serverUrl`.\
  Пример: `http://flip-backend:9000`

### RedisClient (Valkey)

::: danger Примечание
Сервис должен быть подключён к тому же экземпляру Valkey, что и backend.
:::

* **Address**: Адрес сервера Valkey.\
  Пример: `flip-valkey:6379`
* **Username**: Имя пользователя. Пустое значение, если ACL не используется.
* **Password**: Пароль. Пустое значение, если не используется.
* **DB**: Номер базы данных.\
  Пример: `0`