Skip to main content

Формат файла конфигурации

Серверы MCP настраиваются с помощью файла в формате JSON. Например, так можно настроить Context7 и Playwright:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp/",
      "type": "streamableHttp"
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--isolated"]
    }
  }
}

Ниже описаны все поля, которые можно указать в файле конфигурации.

env​

  • Тип: Record<string, string>
  • По умолчанию: {}

Глобальные переменные окружения для серверов stdio.

mcpServers​

  • Тип: Record<string, object>
  • По умолчанию: {}

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

Параметры серверов​

Данные параметры доступны для всех типов серверов.

server.type​

  • Тип: 'stdio' | 'sse' | 'streamableHttp'
  • По умолчанию: 'stdio' или 'sse'

Способ подключения к серверу. Возможные значения:

  • 'stdio': выполняет заданную команду и использует её стандартный ввод/вывод для обмена данными.
  • 'streamableHttp': подключается к серверу по заданной ссылке и использует HTTP для обмена данными.
  • 'sse': подключается к серверу по заданной ссылке и использует SSE для обмена данными. Этот вариант считается устаревшим, и в большинстве случаев вместо него используется 'streamableHttp'.

server.autoApprove​

  • Тип: string[]
  • По умолчанию: []

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

server.timeout​

  • Тип: number
  • По умолчанию: 60

Максимальное время ожидания ответа от сервера в секундах.

server.preConnect​

  • Тип: string

Команда, которая будет выполнена перед подключением к серверу. Если команда завершается с ошибкой, подключение к серверу будет отменено.

server.initialState​

  • Тип: 'enabled' | 'disabled' | Record<string, 'enabled' | 'disabled'>
  • По умолчанию: 'enabled'

Изначальное состояние инструментов сервера:

  • 'enabled': все инструменты включены.
  • 'disabled': все инструменты выключены.

Это поле задаёт только значение по умолчанию. Изменить состояния инструментов можно в интерфейсе настроек MCP.

Можно также задать состояние для отдельных инструментов, например:

"context7": {
    "url": "https://mcp.context7.com/mcp/",
    "type": "streamableHttp",
    "initialState": {
        "resolve-library-id": "disabled"
    }
}

Параметры серверов stdio​

Данные параметры доступны только для серверов с "type": "stdio".

server.command​

  • Тип: string

Исполняемый файл, которую требуется запустить для запуска сервера.

note

Исполняемый файл должен находится в PATH или быть задан абсолютным путём.

server.args​

  • Тип: string[]
  • По умолчанию: []

Список аргументов, которые будут переданы при запуске сервера.

server.env​

  • Тип: Record<string, string>
  • По умолчанию: {}

Переменные окружения, которые будут заданы при выполнении команды. Эти переменные будут добавлены к глобальным переменным окружения, указанным в глобальном поле env.

Параметры серверов streamableHttp и sse​

Данные параметры доступны только для серверов с "type": "streamableHttp" или "type": "sse".

server.url​

  • Тип: string

URL для подключения к серверу.

server.headers​

  • Тип: Record<string, string>
  • По умолчанию: {}

Заголовки HTTP-запроса, используемые при подключении к серверу.

Здесь можно указать токен авторизации, например:

"github": {
    "type": "streamableHttp",
    "url": "https://api.githubcopilot.com/mcp/",
    "headers": {
        "Authorization": "Bearer <token>"
    }
}