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

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

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

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

Настройка backend

Требуется McpAgentTokens.Enable: true в конфигурации backend. Значение 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)

Примечание

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

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