65</Steps>65</Steps>

66 66 

67<h2 id="installing-mcp-servers">67<h2 id="installing-mcp-servers">

68 Установка MCP servers68 Установка MCP серверов

69</h2>69</h2>

70 70 

71MCP servers можно настроить несколькими способами в зависимости от ваших потребностей:71MCP серверы можно настроить несколькими способами в зависимости от ваших потребностей:

72 72 

73<h3 id="option-1-add-a-remote-http-server">73<h3 id="option-1-add-a-remote-http-server">

74 Вариант 1: Добавьте удаленный HTTP server74 Вариант 1: Добавление удалённого HTTP сервера

75</h3>75</h3>

76 76 

77HTTP servers — это рекомендуемый вариант для подключения к удаленным MCP servers. Это наиболее широко поддерживаемый транспорт для облачных сервисов.77HTTP серверы — это рекомендуемый вариант для подключения к удалённым MCP серверам. Это наиболее широко поддерживаемый транспорт для облачных сервисов.

78 78 

79```bash theme={null}79```bash theme={null}

80# Базовый синтаксис80# Базовый синтаксис

88 --header "Authorization: Bearer your-token"88 --header "Authorization: Bearer your-token"

89```89```

90 90 

91При настройке MCP servers через JSON в `.mcp.json`, `~/.claude.json` или `claude mcp add-json`, поле `type` принимает `streamable-http` как псевдоним для `http`. Спецификация MCP использует имя `streamable-http` для этого транспорта, поэтому конфигурации, скопированные из документации server, работают без изменений.91При настройке MCP серверов через JSON в `.mcp.json`, `~/.claude.json` или `claude mcp add-json`, поле `type` принимает `streamable-http` как псевдоним для `http`. Спецификация MCP использует имя `streamable-http` для этого транспорта, поэтому конфигурации, скопированные из документации сервера, работают без изменений.

92 92 

93Запись JSON, которая имеет `url`, но не имеет `type`, является ошибкой конфигурации, потому что Claude Code читает запись без `type` как stdio server. Claude Code пропускает этот server и сообщает `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. До версии 2.1.202 Claude Code сообщал об этой неправильной конфигурации как `command: expected string, received undefined`.93Запись JSON, которая имеет `url` но не имеет `type`, является ошибкой конфигурации, потому что Claude Code читает запись без `type` как stdio сервер. Claude Code пропускает этот сервер и сообщает `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. До версии v2.1.202 Claude Code сообщал об этой неправильной конфигурации как `command: expected string, received undefined`.

94 94 

95В запусках `--output-format stream-json` Claude Code также сообщает о пропущенной записи `--mcp-config` в поле [`mcp_server_errors`](/docs/ru/headless#stream-responses) события `system/init`, поэтому скрипты могут обнаружить, что server никогда не загружался. Это требует Claude Code версии 2.1.219 или позже.95Только приложение-хост SDK, такое как приложение [Agent SDK](/docs/ru/agent-sdk/mcp) или [настольное приложение](/docs/ru/desktop), может зарегистрировать встроенный сервер `"type": "sdk"`. Claude Code пропускает запись `"type": "sdk"` в `.mcp.json`, `~/.claude.json` или параметрах и сообщает `Skipped — MCP server "<name>" declares type "sdk", which only an SDK host application can register`.

96 

97В запусках `--output-format stream-json` Claude Code также сообщает о пропущенной записи `--mcp-config` в поле [`mcp_server_errors`](/docs/ru/headless#stream-responses) события `system/init`, поэтому скрипты могут обнаружить, что сервер никогда не загружался. Это требует Claude Code v2.1.219 или позже.

96 98 

97<h3 id="option-2-add-a-remote-sse-server">99<h3 id="option-2-add-a-remote-sse-server">

98 Вариант 2: Добавьте удаленный SSE server100 Вариант 2: Добавление удалённого SSE сервера

99</h3>101</h3>

100 102 

101<Warning>103<Warning>

102 Транспорт SSE (Server-Sent Events) устарел. Используйте вместо этого HTTP servers, где они доступны.104 Транспорт SSE (Server-Sent Events) устарел. Используйте HTTP серверы вместо этого, где они доступны.

103</Warning>105</Warning>

104 106 

105Некоторые сервисы по-прежнему предоставляют только SSE endpoint. Добавьте их с помощью той же команды `claude mcp add --transport http <name> <url>`, что и [HTTP server](#option-1-add-a-remote-http-server). Claude Code сначала пытается использовать HTTP транспорт и переключается на SSE, когда server его не принимает. Автоматическое переключение требует Claude Code версии 2.1.265 или позже.107Некоторые сервисы по-прежнему предоставляют только SSE конечную точку. Добавляйте их с той же командой `claude mcp add --transport http <name> <url>`, что и [HTTP сервер](#option-1-add-a-remote-http-server). Claude Code сначала пробует HTTP транспорт и переключается на SSE, когда сервер его не принимает. Автоматическое переключение требует Claude Code v2.1.265 или позже.

106 108 

107На более ранней версии или для прямого подключения через SSE передайте `--transport sse` вместо этого:109На более ранней версии или для прямого подключения через SSE передайте `--transport sse` вместо этого:

108 110 

119```121```

120 122 

121<h3 id="option-3-add-a-local-stdio-server">123<h3 id="option-3-add-a-local-stdio-server">

122 Вариант 3: Добавьте локальный stdio server124 Вариант 3: Добавление локального stdio сервера

123</h3>125</h3>

124 126 

125Stdio servers работают как локальные процессы на вашей машине. Они идеальны для инструментов, которым требуется прямой доступ к системе или пользовательские скрипты.127Stdio серверы работают как локальные процессы на вашей машине. Они идеальны для инструментов, которым нужен прямой доступ к системе или пользовательские скрипты.

126 128 

127Claude Code устанавливает `CLAUDE_PROJECT_DIR` в окружение порожденного server в корень проекта, поэтому ваш server может разрешать пути относительно проекта без зависимости от рабочей директории. Это та же директория, которую hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Прочитайте ее изнутри вашего процесса server, например `process.env.CLAUDE_PROJECT_DIR` в Node или `os.environ["CLAUDE_PROJECT_DIR"]` в Python.129Claude Code устанавливает `CLAUDE_PROJECT_DIR` в окружение порождённого сервера в корень проекта, поэтому ваш сервер может разрешать пути относительно проекта без зависимости от рабочей директории. Это та же директория, которую hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Читайте её изнутри процесса вашего сервера, например `process.env.CLAUDE_PROJECT_DIR` в Node или `os.environ["CLAUDE_PROJECT_DIR"]` в Python.

128 130 

129`CLAUDE_PROJECT_DIR` — это стабильный корень проекта и не изменяется при добавлении или удалении рабочих директорий во время сеанса. Server, который ограничивает собственный доступ к файловой системе набором разрешенных директорий, должен вместо этого реализовать MCP запрос `roots/list`. Claude Code отвечает на `roots/list` с директорией запуска сеанса плюс каждая [дополнительная рабочая директория](/docs/ru/permissions#working-directories), которую вы предоставили с помощью `--add-dir`, `/add-dir` или параметра `additionalDirectories`. Claude Code отправляет `notifications/roots/list_changed` при изменении этого набора. До версии 2.1.203 `roots/list` возвращал только директорию запуска и Claude Code не отправлял `notifications/roots/list_changed`.131`CLAUDE_PROJECT_DIR` — это стабильный корень проекта и не меняется, когда вы добавляете или удаляете рабочие директории во время сеанса. Сервер, который ограничивает свой собственный доступ к файловой системе набором разрешённых директорий, должен вместо этого реализовать MCP запрос `roots/list`. Claude Code отвечает на `roots/list` с директорией запуска сеанса плюс каждая [дополнительная рабочая директория](/docs/ru/permissions#working-directories), которую вы предоставили с `--add-dir`, `/add-dir` или параметром `additionalDirectories`. Claude Code отправляет `notifications/roots/list_changed`, когда этот набор меняется. До версии v2.1.203 `roots/list` возвращал только директорию запуска и Claude Code не отправлял `notifications/roots/list_changed`.

130 132 

131Эта переменная устанавливается в окружение server, а не в собственное окружение Claude Code, поэтому ссылка на нее через расширение `${VAR}` в `command` или `args` записи `.mcp.json` с областью действия проекта или записи server с локальной или пользовательской областью действия в `~/.claude.json` требует значения по умолчанию, такого как `${CLAUDE_PROJECT_DIR:-.}`. Конфигурации MCP, предоставляемые плагинами, подставляют `${CLAUDE_PROJECT_DIR}` напрямую и не требуют значения по умолчанию.133Эта переменная устанавливается в окружение сервера, а не в собственное окружение Claude Code, поэтому ссылка на неё через расширение `${VAR}` в `command` или `args` записи `.mcp.json` с областью проекта или локальной или пользовательской записи сервера в `~/.claude.json` требует значения по умолчанию, такого как `${CLAUDE_PROJECT_DIR:-.}`. Конфигурации MCP, предоставляемые плагинами, подставляют `${CLAUDE_PROJECT_DIR}` напрямую и не нуждаются в значении по умолчанию.

132 134 

133```bash theme={null}135```bash theme={null}

134# Базовый синтаксис136# Базовый синтаксис

135claude mcp add [options] <name> -- <command> [args...]137claude mcp add [options] <name> -- <command> [args...]

136 138 

137# Реальный пример: добавление Airtable server139# Реальный пример: добавление сервера Airtable

138claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \140claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \

139 -- npx -y airtable-mcp-server141 -- npx -y airtable-mcp-server

140```142```

141 143 

142<Note>144<Note>

143 **Важно: разделение аргументов server с помощью `--`**145 **Важно: разделяйте аргументы сервера с помощью `--`**

144 146 

145 Для stdio servers `--` (двойной дефис) разделяет собственные опции Claude, такие как `--transport`, `--env` и `--scope`, от команды и аргументов, которые запускают server. Все, что идет после `--`, передается server без изменений.147 Для stdio серверов `--` (двойной дефис) разделяет собственные опции Claude, такие как `--transport`, `--env` и `--scope`, от команды и аргументов, которые запускают сервер. Всё после `--` передаётся серверу без изменений.

146 148 

147 Например:149 Например:

148 150 

149 * `claude mcp add --transport stdio myserver -- npx server` → запускает `npx server`151 * `claude mcp add --transport stdio myserver -- npx server` → запускает `npx server`

150 * `claude mcp add --env KEY=value --transport stdio myserver -- python server.py --port 8080` → запускает `python server.py --port 8080` с `KEY=value` в окружении152 * `claude mcp add --env KEY=value --transport stdio myserver -- python server.py --port 8080` → запускает `python server.py --port 8080` с `KEY=value` в окружении

151 153 

152 Без `--` Claude Code попытался бы разобрать флаги server, такие как `--port` выше, как свои собственные опции.154 Без `--` Claude Code попытался бы разобрать флаги сервера, такие как `--port` выше, как свои собственные опции.

153 155 

154 `--env` принимает несколько пар `KEY=value`. Если имя server идет сразу после `--env`, CLI читает имя как еще одну пару и отклоняет его, поэтому поместите хотя бы одну другую опцию, такую как `--transport stdio`, между `--env` и именем server.156 `--env` принимает несколько пар `KEY=value`. Если имя сервера идёт сразу после `--env`, CLI читает имя как другую пару и отклоняет её, поэтому поместите хотя бы одну другую опцию, такую как `--transport stdio`, между `--env` и именем сервера.

155</Note>157</Note>

156 158 

157<h3 id="option-4-add-a-remote-websocket-server">159<h3 id="option-4-add-a-remote-websocket-server">

158 Вариант 4: Добавьте удаленный WebSocket server160 Вариант 4: Добавление удалённого WebSocket сервера

159</h3>161</h3>

160 162 

161WebSocket servers поддерживают постоянное двусторонее соединение, которое подходит для удаленных MCP servers, которые отправляют события в Claude без запроса. Используйте HTTP вместо этого, когда ваш server только отвечает на запросы, так как HTTP поддерживает OAuth и флаг `claude mcp add --transport`, в то время как WebSocket не поддерживает ни то, ни другое.163WebSocket серверы поддерживают постоянное двусторонее соединение, которое подходит для удалённых MCP серверов, которые отправляют события Claude без запроса. Используйте HTTP вместо этого, когда ваш сервер только отвечает на запросы, так как HTTP поддерживает OAuth и флаг `claude mcp add --transport`, в то время как WebSocket не поддерживает ни то, ни другое.

162 164 

163Настройте WebSocket servers в `.mcp.json` или с помощью `claude mcp add-json`:165Настраивайте WebSocket серверы в `.mcp.json` или с помощью `claude mcp add-json`:

164 166 

165```bash theme={null}167```bash theme={null}

166claude mcp add-json events-server \168claude mcp add-json events-server \

170Запись `type: "ws"` принимает те же поля `url`, `headers`, `headersHelper`, `timeout` и `alwaysLoad`, что и `http`. Аутентификация только через заголовки, поэтому передайте статический токен в `headers` или сгенерируйте его во время подключения с помощью [`headersHelper`](#use-dynamic-headers-for-custom-authentication). Флаг `claude mcp add --transport` не принимает `ws`.172Запись `type: "ws"` принимает те же поля `url`, `headers`, `headersHelper`, `timeout` и `alwaysLoad`, что и `http`. Аутентификация только через заголовки, поэтому передайте статический токен в `headers` или сгенерируйте его во время подключения с помощью [`headersHelper`](#use-dynamic-headers-for-custom-authentication). Флаг `claude mcp add --transport` не принимает `ws`.

171 173 

172<h3 id="add-a-server-from-setup-instructions-written-for-another-client">174<h3 id="add-a-server-from-setup-instructions-written-for-another-client">

173 Добавьте server из инструкций по настройке, написанных для другого клиента175 Добавление сервера из инструкций по настройке, написанных для другого клиента

174</h3>176</h3>

175 177 

176MCP servers не специфичны для Claude Code, поэтому инструкции по настройке server могут быть написаны для Claude Desktop, Cursor или другого MCP клиента и не содержать команду `claude mcp add`. Чтобы добавить server в любом случае, посмотрите в этих инструкциях одно из этих трех:178MCP серверы не специфичны для Claude Code, поэтому инструкции по настройке сервера могут быть написаны для Claude Desktop, Cursor или другого MCP клиента и не давать команду `claude mcp add`. Чтобы добавить сервер в любом случае, ищите в этих инструкциях URL, команду запуска или блок JSON:

177 179 

178* **URL**, такой как `https://mcp.example.com/mcp`: server удален.180* **URL** такой как `https://mcp.example.com/mcp`: сервер удалённый.

179* **Команда запуска**, такая как `npx -y @example/mcp-server`: server работает на вашей машине.181* **Команда запуска** такая как `npx -y @example/mcp-server`: сервер работает на вашей машине.

180* **Блок JSON `mcpServers`**: конфигурация, написанная для файла параметров другого клиента.182* **Блок JSON `mcpServers`**: конфигурация, написанная для файла параметров другого клиента.

181 183 

182Каждый из них является одним из входов, которые четыре варианта в [Установка MCP servers](#installing-mcp-servers) принимают. Найдите форму, которую вы имеете ниже, чтобы превратить ее в команду, которую Claude Code принимает. Каждая команда записывает в [локальную область](#local-scope), если вы не добавите `--scope project` или `--scope user`.184Каждый из них — один из входов, которые принимают четыре варианта в [Установка MCP серверов](#installing-mcp-servers). Найдите форму, которую вы имеете ниже, чтобы превратить её в команду, которую принимает Claude Code. Каждая команда записывает в [локальную область](#local-scope), если вы не добавите `--scope project` или `--scope user`.

183 185 

184<h4 id="from-a-url">186<h4 id="from-a-url">

185 Из URL187 Из URL

186</h4>188</h4>

187 189 

188URL означает, что server удален. Для endpoint `https://`, добавьте его с помощью `--transport http`, или следуйте [Вариант 2](#option-2-add-a-remote-sse-server), когда инструкции говорят, что endpoint использует SSE. Для endpoint `wss://`, используйте [Вариант 4](#option-4-add-a-remote-websocket-server) вместо этого, так как `--transport` не принимает `ws`:190URL означает, что сервер удалённый. Для конечной точки `https://`, добавьте её с `--transport http` или следуйте [Варианту 2](#option-2-add-a-remote-sse-server), когда инструкции говорят, что конечная точка использует SSE. Для конечной точки `wss://` используйте вместо этого [Вариант 4](#option-4-add-a-remote-websocket-server), так как `--transport` не принимает `ws`:

189 191 

190```bash theme={null}192```bash theme={null}

191claude mcp add --transport http example https://mcp.example.com/mcp193claude mcp add --transport http example https://mcp.example.com/mcp

192```194```

193 195 

194Если инструкции также дают API ключ или заголовок токена, передайте его с помощью `--header`, как показано в [Вариант 1](#option-1-add-a-remote-http-server).196Если инструкции также дают ключ API или заголовок токена, передайте его с `--header`, как показано в [Варианте 1](#option-1-add-a-remote-http-server).

195 197 

196<h4 id="from-an-npx-uvx-or-binary-command">198<h4 id="from-an-npx-uvx-or-binary-command">

197 Из команды `npx`, `uvx` или binary199 Из команды `npx`, `uvx` или двоичного файла

198</h4>200</h4>

199 201 

200Команда запуска означает, что server работает как локальный stdio процесс. Поместите всю команду после `--`, чтобы Claude Code передал флаги, такие как `-y`, команде, которая запускает server, вместо того чтобы читать их как свои собственные опции. Передайте любые переменные окружения, которые инструкции просят, с помощью `--env`, после имени server и перед `--`:202Команда запуска означает, что сервер работает как локальный stdio процесс. Поместите всю команду после `--`, чтобы Claude Code передал флаги, такие как `-y`, команде, которая запускает сервер, вместо того чтобы читать их как свои собственные опции. Передайте любые переменные окружения, которые инструкции требуют, с `--env`, после имени сервера и перед `--`:

201 203 

202```bash theme={null}204```bash theme={null}

203claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server205claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server

209 Из блока JSON `mcpServers`211 Из блока JSON `mcpServers`

210</h4>212</h4>

211 213 

212Блок `mcpServers`, написанный для другого MCP клиента, такого как Claude Desktop, использует ключ-обертку и форму записи, которую Claude Code читает. Передайте `claude mcp add-json` объект внутри `mcpServers`, а не обертку. Две записи нуждаются в исправлении сначала:214Блок `mcpServers`, написанный для другого MCP клиента, такого как Claude Desktop, использует ключ обёртки и форму записи, которую читает Claude Code. Передайте `claude mcp add-json` объект внутри `mcpServers`, а не обёртку. Две записи нуждаются в исправлении сначала:

213 215 

214* **`url` без `type`**: добавьте `"type": "http"`, `"type": "sse"` или `"type": "ws"` для соответствия endpoint. Claude Code читает запись без `type` как stdio server, поэтому запись `url` без `type` не работает.216* **`url` без `type`**: добавьте `"type": "http"`, `"type": "sse"` или `"type": "ws"` для соответствия конечной точке. Claude Code читает запись без `type` как stdio сервер, поэтому запись `url` без `type` не работает.

215* **Ключ с символами, отличными от букв, цифр, дефисов и подчеркиваний**: выберите имя server, которое использует только эти символы. В противном случае ключ является именем server.217* **Ключ с символами, отличными от букв, цифр, дефисов и подчёркиваний**: выберите имя сервера, которое использует только эти символы. В противном случае ключ — это имя сервера.

216 218 

217Например, этот блок:219Например, этот блок:

218 220 

233claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'235claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'

234```236```

235 237 

236[Добавьте MCP servers из конфигурации JSON](#add-mcp-servers-from-json-configuration) охватывает экранирование shell и флаг `--scope` для `add-json`. Чтобы поделиться server с вашей командой вместо этого, добавьте `--scope project`, или добавьте запись под `mcpServers` в `.mcp.json` в корне вашего проекта и зафиксируйте ее. [Область действия проекта](#project-scope) охватывает, как Claude Code загружает и одобряет этот файл.238[Добавление MCP серверов из конфигурации JSON](#add-mcp-servers-from-json-configuration) охватывает экранирование оболочки и флаг `--scope` для `add-json`. Чтобы поделиться сервером с вашей командой вместо этого, добавьте `--scope project` или добавьте запись под `mcpServers` в `.mcp.json` в корне вашего проекта и зафиксируйте её. [Область проекта](#project-scope) охватывает, как Claude Code загружает и одобряет этот файл.

237 239 

238Каждая команда `claude mcp add` и `claude mcp add-json` выводит строку `Added ...`. Чтобы проверить, что Claude Code подключился, запустите `claude mcp get <name>`; [Статус server](#server-status) охватывает статусы, которые он показывает, и шаг одобрения для servers `.mcp.json`.240Каждая команда `claude mcp add` и `claude mcp add-json` выводит строку `Added ...`. Чтобы проверить, что Claude Code подключился, запустите `claude mcp get <name>`; [Статус сервера](#server-status) охватывает статусы, которые он показывает, и шаг одобрения для серверов `.mcp.json`.

239 241 

240<h3 id="managing-your-servers">242<h3 id="managing-your-servers">

241 Управление вашими servers243 Управление вашими серверами

242</h3>244</h3>

243 245 

244После настройки вы можете управлять своими MCP servers с помощью этих команд:246После настройки вы можете управлять вашими MCP серверами с помощью этих команд:

245 247 

246```bash theme={null}248```bash theme={null}

247# Список всех настроенных servers249# Список всех настроенных серверов

248claude mcp list250claude mcp list

249 251 

250# Получить детали для конкретного server252# Получить детали для конкретного сервера

251claude mcp get notion253claude mcp get notion

252 254 

253# Удалить server255# Удалить сервер

254claude mcp remove notion256claude mcp remove notion

255 257 

256# (в Claude Code) Проверить статус server258# (внутри Claude Code) Проверить статус сервера

257/mcp259/mcp

258```260```

259 261 

260Когда вы удаляете удаленный server, Claude Code также удаляет OAuth токены и регистрацию клиента, которые он хранил для этого server.262Когда вы удаляете удалённый сервер, Claude Code также удаляет токены OAuth и регистрацию клиента, которые он хранил для этого сервера.

261 263 

262<h4 id="server-status">264<h4 id="server-status">

263 Статус server265 Статус сервера

264</h4>266</h4>

265 267 

266`claude mcp add` подтверждает успешное добавление, выводя строку `Added ...`, что означает, что конфигурация была записана. `claude mcp list` затем показывает статус здоровья рядом с каждым server, который он перечисляет, такой как `✔ Connected`, `! Needs authentication` или `✘ Failed to connect`. Статус отказа означает, что Claude Code не мог подключиться к этому server, а не то, что команда list не удалась.268`claude mcp add` подтверждает успешное добавление, выводя строку `Added ...`, что означает, что конфигурация была записана. `claude mcp list` затем показывает статус здоровья рядом с каждым сервером, который он перечисляет, такой как `✔ Connected`, `! Needs authentication` или `✘ Failed to connect`. Статус отказа означает, что Claude Code не смог подключиться к этому серверу, а не то, что команда list не удалась.

267 269 

268Статусы в этом списке сообщают о решении конфигурации, а не о попытке подключения, поэтому Claude Code выводит их без подключения к server:270Статусы в этом списке сообщают о решении конфигурации, а не о попытке подключения, поэтому Claude Code выводит их без подключения к серверу:

269 271 

270* ``⏸ Pending approval (run `claude` to approve)``: server с областью действия проекта из `.mcp.json`, который вы еще не одобрили. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Запустите `claude` интерактивно, чтобы просмотреть и одобрить его.272* ``⏸ Pending approval (run `claude` to approve)``: сервер с областью проекта из `.mcp.json`, который вы ещё не одобрили. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Запустите `claude` интерактивно, чтобы просмотреть и одобрить его.

271* `✘ Rejected (see disabledMcpjsonServers in settings)`: server `.mcp.json`, который запись [`disabledMcpjsonServers`](/docs/ru/settings-reference#disabledmcpjsonservers) отклоняет. Claude Code показывает его только в `claude mcp get <name>`.273* `✘ Rejected (see disabledMcpjsonServers in settings)`: сервер `.mcp.json`, который запись [`disabledMcpjsonServers`](/docs/ru/settings-reference#disabledmcpjsonservers) отклоняет. Claude Code показывает его только в `claude mcp get <name>`.

272* `⊘ Disabled for this project (re-enable via /mcp)`: server, который список [`disabledMcpServers`](#disable-a-server-without-removing-it) проекта называет. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Включите server обратно из панели `/mcp`. До версии 2.1.238 обе команды подключались к отключенному server для проверки здоровья и сообщали результат подключения.274* `⊘ Disabled for this project (re-enable via /mcp)`: сервер, который список [`disabledMcpServers`](#disable-a-server-without-removing-it) проекта называет. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Включите сервер обратно из панели `/mcp`. До версии v2.1.238 обе команды подключались к отключённому серверу для проверки здоровья и сообщали результат подключения.

273 275 

274WebSocket servers не отображаются в выводе `claude mcp list`. Используйте `claude mcp get <name>` или панель `/mcp` для их проверки.276WebSocket серверы не появляются в выводе `claude mcp list`. Используйте `claude mcp get <name>` или панель `/mcp` для их проверки.

275 277 

276<h4 id="project-server-approvals-and-workspace-trust">278<h4 id="project-server-approvals-and-workspace-trust">

277 Одобрения servers проекта и доверие рабочей области279 Одобрения серверов проекта и доверие рабочей области

278</h4>280</h4>

279 281 

280Начиная с версии 2.1.196, `claude mcp list` и `claude mcp get` читают одобрения `.mcp.json` только из файлов параметров, которые не проверены в репозитории, пока вы не доверите рабочей области, запустив `claude` в ней и приняв диалог доверия рабочей области. Клонированный репозиторий не может одобрить свои собственные servers: [`enableAllProjectMcpServers`](/docs/ru/settings-reference#enableallprojectmcpservers) или [`enabledMcpjsonServers`](/docs/ru/settings-reference#enabledmcpjsonservers), зафиксированные в `.claude/settings.json` проекта, игнорируются в недоверенной папке, и server остается в состоянии `⏸ Pending approval` вместо подключения и проверки здоровья.282Начиная с версии v2.1.196, `claude mcp list` и `claude mcp get` читают одобрения `.mcp.json` только из файлов параметров, которые не зафиксированы в репозитории, пока вы не доверите рабочей области, запустив `claude` в ней и приняв диалог доверия рабочей области. Клонированный репозиторий не может одобрить свои собственные серверы: [`enableAllProjectMcpServers`](/docs/ru/settings-reference#enableallprojectmcpservers) или [`enabledMcpjsonServers`](/docs/ru/settings-reference#enabledmcpjsonservers), зафиксированные в `.claude/settings.json` проекта, игнорируются в недоверенной папке, и сервер остаётся в `⏸ Pending approval` вместо подключения и проверки здоровья.

281 283 

282Одобрения из этих источников все еще применяются в недоверенной папке:284Одобрения из этих источников по-прежнему применяются в недоверенной папке:

283 285 

284* ваш пользовательский `~/.claude/settings.json`286* ваш пользовательский `~/.claude/settings.json`

285* управляемые параметры287* управляемые параметры

286* параметры, переданные с помощью `--settings`288* параметры, переданные с `--settings`

287 289 

288Claude Code также применяет одобрения из неотслеживаемого `.claude/settings.local.json`, но он запускает git для проверки того, отслеживается ли файл, и выполняет эту проверку только в [доверенной папке](/docs/ru/permissions#project-allow-rules-and-workspace-trust). В папке, которой вы никогда не доверяли, Claude Code ждет диалога доверия перед применением одобрений файла, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). До версии 2.1.207 Claude Code применял одобрения из неотслеживаемого `.claude/settings.local.json` даже в папке, которой вы никогда не доверяли.290Claude Code также применяет одобрения из отслеживаемого `.claude/settings.local.json`, но он запускает git для проверки, отслеживается ли файл, и запускает эту проверку только в [доверенной папке](/docs/ru/permissions#project-allow-rules-and-workspace-trust). В папке, которую вы никогда не доверяли, Claude Code ждёт диалога доверия перед применением одобрений файла, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). До версии v2.1.207 Claude Code применял одобрения из отслеживаемого `.claude/settings.local.json` даже в папке, которую вы никогда не доверяли.

289 291 

290Запись `disabledMcpjsonServers` в любом файле параметров все еще отклоняет server.292Запись `disabledMcpjsonServers` в любом файле параметров по-прежнему отклоняет сервер.

291 293 

292<h4 id="server-status-detail">294<h4 id="server-status-detail">

293 Деталь статуса server295 Деталь статуса сервера

294</h4>296</h4>

295 297 

296В `/mcp`, включая меню server там, и в [менеджере `/plugin`](/docs/ru/plugins/install), удаленный HTTP или SSE server, который вы использовали раньше, может показать статус `cached`, такой как `cached 2h ago · connects on first use · 5 tools`. Claude Code загрузил список инструментов server из своего кэша обнаружения, сохраненного в предыдущем сеансе, вместо подключения при запуске, и Claude Code подключает server в первый раз, когда Claude вызывает один из инструментов server. Инструменты доступны с вашего первого сообщения, поэтому вам не нужно ничего делать. Кэш обнаружения и его статус `cached` требуют Claude Code версии 2.1.221 или позже.298В `/mcp`, включая меню сервера там, и в [менеджере](/docs/ru/plugins/install) `/plugin`, удалённый HTTP или SSE сервер, который вы использовали раньше, может показать статус `cached` такой как `cached 2h ago · connects on first use · 5 tools`. Claude Code загрузил список инструментов сервера из своего кэша обнаружения, сохранённого в предыдущем сеансе, вместо подключения при запуске, и Claude Code подключает сервер в первый раз, когда Claude вызывает один из инструментов сервера. Инструменты доступны с вашего первого сообщения, поэтому вам не нужно ничего делать. Кэш обнаружения и его статус `cached` требуют Claude Code v2.1.221 или позже.

297 

298Кэш обнаружения отключен по умолчанию, если постепенный rollout не включил его для вашей учетной записи. Установите [`MCP_DISCOVERY_CACHE=1`](/docs/ru/env-vars) для его включения или `0` для его отключения, даже если rollout включил его. До версии 2.1.238 кэш был включен по умолчанию.

299 299 

300Два действия в меню server в `/mcp` также влияют на запись кэша этого server:300Кэш обнаружения отключён по умолчанию, если постепенное развёртывание не включило его для вашей учётной записи. Установите [`MCP_DISCOVERY_CACHE=1`](/docs/ru/env-vars) для его включения или `0` для его отключения, даже если развёртывание включило его. До версии v2.1.238 кэш был включён по умолчанию.

301 301 

302* **Reconnect**: на `cached` server Claude Code подключает его сейчас, а не при его первом вызове инструмента, и сохраняет запись. На подключенном или неудачном server Claude Code переподключает его и также отбрасывает запись.302Когда вы выбираете **Disable** или **Clear authentication** из меню сервера в `/mcp`, Claude Code также отбрасывает запись кэша этого сервера. **Reconnect** отбрасывает её тоже на подключённом или неудачном сервере; на сервере `cached` **Reconnect** подключает сервер сейчас и сохраняет запись. В следующий раз, когда Claude Code подключится к серверу после отбрасывания записи, он получит список инструментов с сервера вместо кэша.

303* **Clear authentication**: Claude Code отзывает аутентификацию server и также отбрасывает запись.

304 303 

305После отбрасывания записи Claude Code получает список инструментов server из server вместо кэша.304Когда статус сервера `✘ Failed to connect`, `claude mcp list` добавляет деталь отказа к этой строке статуса, и `claude mcp get <name>` показывает её на строке `Issue:`: HTTP статус или код ошибки, плюс любой текст ошибки, который вернул сервер. Представление деталей сервера в `/mcp` включает тот же текст, сообщённый сервером, в его строку `Issue:`. Claude Code редактирует текст, похожий на учётные данные, из этой детали и никогда не включает развёрнутый URL сервера, который может нести секреты. Claude Code не добавляет деталь к статусу `✘ Connection error`, потому что текст исключения, который он выводил бы там, может встроить этот URL. До версии v2.1.219 обе команды показывали только голый статус отказа, без кода статуса или текста ошибки сервера.

306 305 

307Когда статус server — `✘ Failed to connect`, `claude mcp list` добавляет деталь отказа к этой строке статуса, и `claude mcp get <name>` показывает ее на строке `Issue:`: HTTP статус или код ошибки, плюс любой текст ошибки, который server вернул. Представление деталей server в `/mcp` включает тот же текст, сообщенный server, в его строке `Issue:`. Claude Code редактирует текст, похожий на учетные данные, из этой детали и никогда не включает развернутый URL server, который может содержать секреты. Claude Code не добавляет деталь к статусу `✘ Connection error`, потому что текст исключения, который он выводил бы там, может встроить этот URL. До версии 2.1.219 обе команды показывали только статус отказа, без кода статуса или текста ошибки server.306Когда вы завершаете аутентификацию из `/mcp` и подключение по-прежнему не удаётся с HTTP статусом или кодом ошибки транспорта, Claude Code добавляет этот код и источник URL сервера к сообщению, которое он выводит после попытки. Источник — это схема и хост, плюс порт, когда URL называет один, такой как `https://mcp.example.com`.

308 

309Когда вы завершаете аутентификацию из `/mcp` и подключение все еще не удается с HTTP статусом или кодом ошибки транспорта, Claude Code добавляет этот код и источник URL server к сообщению, которое он выводит после попытки. Источник — это схема и хост, плюс порт, когда URL называет один, такой как `https://mcp.example.com`.

310 307 

311* Путь и запрос никогда не появляются в этом сообщении.308* Путь и запрос никогда не появляются в этом сообщении.

312* Для server в локальной, проектной или пользовательской [области](#mcp-installation-scopes) или в управляемой конфигурации MCP источник показывает хост, как написано в этой конфигурации, поэтому ссылка `${VAR}` в хосте не развернута в сообщении.309* Для сервера в локальной, проектной или пользовательской [области](#mcp-installation-scopes) или в управляемой конфигурации MCP источник показывает хост, как написано в этой конфигурации, поэтому ссылка `${VAR}` в хосте не развёрнута в сообщении.

313* Для отказа без статуса или кода ошибки Claude Code показывает текст ошибки без источника.310* Для отказа без статуса или кода ошибки Claude Code показывает текст ошибки без источника.

314 311 

315Удаленный server, конфигурация которого имеет пустой `url`, отображается как `not configured` в `/mcp`, в `claude mcp list` и в [менеджере `/plugin`](/docs/ru/plugins/install), и Claude Code не пытается подключиться к нему. Плагин может включать запись-заполнитель, подобную этой, для коннектора, который вы настроите позже, поэтому Claude Code не сообщает об этом как об ошибке или проблеме настройки. Представление деталей server в `/mcp` читает `No URL configured for this server`; установите `url` записи для подключения. До версии 2.1.208 Claude Code сообщал об пустом `url` как о проблеме конфигурации с подсказкой переподключиться.312Удалённый сервер, чья конфигурация имеет пустой `url`, показывается как `not configured` в `/mcp`, в `claude mcp list` и в [менеджере](/docs/ru/plugins/install) `/plugin`, и Claude Code не пытается подключиться к нему. Плагин может включить запись-заполнитель, подобную этой, для соединителя, который вы настраиваете позже, поэтому Claude Code не сообщает об этом как об ошибке или проблеме настройки. Представление деталей сервера в `/mcp` читает `No URL configured for this server`; установите `url` записи для подключения к нему. До версии v2.1.208 Claude Code сообщал о пустом `url` как о проблеме конфигурации с подсказкой переподключиться.

316 313 

317<h4 id="configuration-warnings">314<h4 id="configuration-warnings">

318 Предупреждения конфигурации315 Предупреждения конфигурации

320 317 

321Claude Code предупреждает о проблемах конфигурации ниже. Каждая запись говорит, что Claude Code проверяет и как очистить предупреждение:318Claude Code предупреждает о проблемах конфигурации ниже. Каждая запись говорит, что Claude Code проверяет и как очистить предупреждение:

322 319 

323* **Скрытое пробельное пространство**: Claude Code предупреждает, когда значение конфигурации MCP содержит скрытое ведущее или конечное пробельное пространство, которое часто поступает из вставки токена с конечным переводом строки. Claude Code проверяет `command`, `url`, каждую запись `args` и значения и имена ключей под `env` и `headers`. Claude Code показывает предупреждение в выводе `claude mcp list` и в `/mcp`, называя затронутые поля без повторения их значений, например `Leading or trailing whitespace in: headers.Authorization`. Claude Code не обрезает пробельное пространство и использует значения точно так, как написано, поэтому отредактируйте конфигурацию, чтобы удалить его.320* **Скрытое пробельное пространство**: Claude Code предупреждает, когда значение конфигурации MCP несёт скрытое ведущее или конечное пробельное пространство, которое часто происходит из вставки токена с конечным переводом строки. Claude Code проверяет `command`, `url`, каждую запись `args` и значения и имена ключей под `env` и `headers`. Claude Code показывает предупреждение в выводе `claude mcp list` и в `/mcp`, называя затронутые поля без повторения их значений, например `Leading or trailing whitespace in: headers.Authorization`. Claude Code не обрезает пробельное пространство и использует значения точно так, как написано, поэтому отредактируйте конфигурацию, чтобы удалить его.

324* **Одно имя в более чем одной области**: если вы определяете одно имя server в более чем одной [области](#mcp-installation-scopes) с разными endpoint, Claude Code предупреждает о конфликте в выводе `claude mcp list` и в `/mcp`. Claude Code хранит OAuth входы для каждого endpoint, поэтому когда вы аутентифицируете определение, которое загружается в одном проекте, вам все еще нужно войти отдельно в проекте, где загружается другое определение. Сохраните endpoint, который вы хотите, и удалите остальные с помощью `claude mcp remove <name> --scope <scope>`. В предупреждении Claude Code цитирует endpoint каждой области, как написано в вашей конфигурации, с неразвернутыми ссылками [`${VAR}`](#environment-variable-expansion-in-mcp-json), поэтому он никогда не показывает разрешенное значение, такое как API ключ.321* **Одно имя в более чем одной области**: если вы определяете одно имя сервера в более чем одной [области](#mcp-installation-scopes) с разными конечными точками, Claude Code предупреждает о конфликте в выводе `claude mcp list` и в `/mcp`. Claude Code хранит входы OAuth для каждой конечной точки, поэтому когда вы аутентифицируете определение, которое загружается в одном проекте, вам по-прежнему нужно отдельно войти в проект, где загружается другое определение. Сохраните конечную точку, которую вы хотите, и удалите остальные с помощью `claude mcp remove <name> --scope <scope>`. В предупреждении Claude Code цитирует конечную точку каждой области, как написано в вашей конфигурации, с [ссылками `${VAR}`](#environment-variable-expansion-in-mcp-json) не развёрнутыми, поэтому она никогда не показывает разрешённое значение, такое как ключ API.

325* **Зарезервированные имена**: Claude Code резервирует имена своих встроенных servers, включая `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет server с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой. `Claude Preview` и `Claude Browser` оба называют встроенный server, который использует [панель предпросмотра приложения Claude Code desktop](/docs/ru/desktop#preview-your-app). До версии 2.1.205 `Claude Browser` не был зарезервирован, поэтому пользовательский server мог зарегистрироваться под этим именем.322* **Зарезервированные имена**: Claude Code резервирует имена своих встроенных серверов, включая `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет сервер с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение, прося вас переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой. `Claude Preview` и `Claude Browser` оба называют встроенный сервер, который использует [панель предпросмотра настольного приложения Claude Code](/docs/ru/desktop#preview-your-app). До версии v2.1.205 `Claude Browser` не был зарезервирован, поэтому пользовательский сервер мог зарегистрироваться под этим именем.

326* **Отсутствующая переменная окружения**: если ссылка [`${VAR}`](#environment-variable-expansion-in-mcp-json) в конфигурации server называет переменную, которая не установлена и не имеет `:-default`, Claude Code предупреждает в выводе `claude mcp list` и в `/mcp`, называя переменную, и все еще загружает server с текстом `${VAR}` неразвернутым. Установите переменную или добавьте fallback `${VAR:-default}`. В URL и `headers` удаленного server некоторые переменные учетных данных [читаются как пустые](#credential-variables-that-read-as-empty) вместо этого, без предупреждения.323* **Отсутствующая переменная окружения**: если ссылка [`${VAR}`](#environment-variable-expansion-in-mcp-json) в конфигурации сервера называет переменную, которая не установлена и не имеет `:-default`, Claude Code предупреждает в выводе `claude mcp list` и в `/mcp`, называя переменную, и по-прежнему загружает сервер с текстом `${VAR}` не развёрнутым. Установите переменную или добавьте резервный вариант `${VAR:-default}`. В `url` и `headers` удалённого сервера некоторые переменные учётных данных [читаются как пустые](#credential-variables-that-read-as-empty) вместо этого, без предупреждения.

327 324 

328<h4 id="tool-availability">325<h4 id="tool-availability">

329 Доступность инструментов326 Доступность инструментов

330</h4>327</h4>

331 328 

332Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.329Панель `/mcp` показывает количество инструментов рядом с каждым подключённым сервером и отмечает серверы, которые объявляют возможность инструментов, но не предоставляют инструменты.

333 330 

334Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. Как происходит ожидание, зависит от вашей конфигурации:331Если ваш запрос нуждается в инструментах с сервера, который всё ещё подключается в фоне, Claude ждёт этого сервера перед продолжением. Как происходит ожидание, зависит от вашей конфигурации:

335 332 

336* **С [поиском инструментов](#scale-with-mcp-tool-search), по умолчанию**: ожидание происходит внутри вызова `ToolSearch`.333* **С [поиском инструментов](#scale-with-mcp-tool-search), по умолчанию**: ожидание происходит внутри вызова `ToolSearch`.

337* **Без поиска инструментов**: Claude использует инструмент `WaitForMcpServers` вместо этого. Конфигурации без поиска инструментов включают пользовательский `ANTHROPIC_BASE_URL`, `ENABLE_TOOL_SEARCH=false` и модель более раннюю, чем поколение Claude 4.5 на Google Cloud's Agent Platform.334* **Без поиска инструментов**: Claude использует инструмент `WaitForMcpServers` вместо этого. Конфигурации без поиска инструментов включают пользовательский `ANTHROPIC_BASE_URL`, `ENABLE_TOOL_SEARCH=false` и модель более ранней версии, чем поколение Claude 4.5 на платформе Agent Platform Google Cloud.

338* **На развертывании Microsoft Foundry [размещенном на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)**: Claude начинает на пути поиска инструментов, а не с `WaitForMcpServers`, так как Claude Code обнаруживает отказ server-side развертывания только из API. После того как Claude Code переключит это развертывание на [upfront loading](#scale-with-mcp-tool-search), инструменты от server, который завершает подключение, становятся доступными при следующем запросе Claude.335* **На развёртывании Microsoft Foundry [размещённом на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)**: Claude начинает на пути поиска инструментов, а не с `WaitForMcpServers`, так как Claude Code обнаруживает отклонение на стороне сервера развёртывания только из API. После того как Claude Code переключит это развёртывание на [предварительную загрузку](#scale-with-mcp-tool-search), инструменты с сервера, который завершает подключение, становятся доступны при следующем запросе Claude.

339 336 

340С включенным поиском инструментов, когда server завершает подключение, пока Claude работает, Claude Code перечисляет имена инструментов server для Claude при его следующем запросе в том же ходу. Claude затем может искать и вызывать эти инструменты без ожидания вашего следующего сообщения.337С включённым поиском инструментов, когда сервер завершает подключение, пока Claude работает, Claude Code перечисляет имена инструментов сервера Claude при его следующем запросе в том же ходу. Claude затем может искать и вызывать эти инструменты без ожидания вашего следующего сообщения.

341 338 

342<h3 id="disable-a-server-without-removing-it">339<h3 id="disable-a-server-without-removing-it">

343 Отключите server без его удаления340 Отключение сервера без его удаления

344</h3>341</h3>

345 342 

346Переключите server в панели `/mcp`, чтобы остановить Claude Code от подключения к нему без потери его конфигурации. Claude Code все еще перечисляет server в `/mcp`, отмеченный как отключенный.343Переключите сервер в панели `/mcp`, чтобы остановить Claude Code от подключения к нему без потери его конфигурации. Claude Code по-прежнему перечисляет сервер в `/mcp`, отмеченный как отключённый.

347 344 

348Когда вы переключаете server, Claude Code записывает ваш выбор для каждого проекта в `~/.claude.json`, в одном из двух списков, которые охватывают непересекающиеся наборы servers:345Когда вы переключаете сервер, Claude Code записывает ваш выбор для каждого проекта в `~/.claude.json`, в один из двух списков, которые охватывают непересекающиеся наборы серверов:

349 346 

350* `disabledMcpServers`: список opt-out для пользовательских servers, plugin servers, servers, которые ваша организация [предоставляет через управляемые параметры](/docs/ru/managed-mcp#provide-servers-through-managed-settings), claude.ai коннекторов, которые Claude Code [получает сам](#how-connectors-reach-claude-code), и встроенных servers, которые по умолчанию включены. Claude Code не подключается к server, который вы перечисляете здесь. Когда вы отключаете claude.ai коннектор с помощью переключателя `/mcp` для каждого проекта, описанного в [Отключите claude.ai коннекторы](#disable-claude-ai-connectors), Claude Code записывает его в этот список под его отображаемым именем, например `claude.ai Slack`.347* `disabledMcpServers`: список отказа для пользовательских серверов, серверов плагинов, серверов, которые ваша организация [предоставляет через управляемые параметры](/docs/ru/managed-mcp#provide-servers-through-managed-settings), соединителей claude.ai, которые Claude Code [получает сам](#how-connectors-reach-claude-code), и встроенных серверов, которые по умолчанию включены. Claude Code не подключается к серверу, который вы перечисляете здесь. Когда вы отключаете соединитель claude.ai с помощью переключателя `/mcp` для каждого проекта, описанного в [Отключение соединителей claude.ai](#disable-claude-ai-connectors), Claude Code записывает его в этот список под его отображаемым именем, например `claude.ai Slack`.

351* `enabledMcpServers`: список opt-in для встроенных servers, которые по умолчанию отключены, такие как `computer-use`. Claude Code подключается к server, который по умолчанию отключен, только когда вы перечисляете его здесь.348* `enabledMcpServers`: список включения для встроенных серверов, которые по умолчанию отключены, такие как `computer-use`. Claude Code подключается к серверу, отключённому по умолчанию, только когда вы перечисляете его здесь.

352 349 

353Claude Code консультирует ровно один из двух списков для каждого server, поэтому ни один список не переопределяет другой. Если вы добавляете обычный server в `enabledMcpServers` или server, который по умолчанию отключен, в `disabledMcpServers`, Claude Code игнорирует запись.350Claude Code консультирует ровно один из двух списков для каждого сервера, поэтому ни один список не переопределяет другой. Если вы добавляете обычный сервер в `enabledMcpServers` или сервер, отключённый по умолчанию, в `disabledMcpServers`, Claude Code игнорирует запись.

354 351 

355`disabledMcpServers` и `enabledMcpServers` не связаны с [`enabledMcpjsonServers`](/docs/ru/settings-reference#enabledmcpjsonservers) и [`disabledMcpjsonServers`](/docs/ru/settings-reference#disabledmcpjsonservers), которые контролируют одобрение servers, определенных в файле `.mcp.json` проекта.352`disabledMcpServers` и `enabledMcpServers` не связаны с [`enabledMcpjsonServers`](/docs/ru/settings-reference#enabledmcpjsonservers) и [`disabledMcpjsonServers`](/docs/ru/settings-reference#disabledmcpjsonservers), которые контролируют одобрение серверов, определённых в файле `.mcp.json` проекта.

356 353 

357<h3 id="mcp-client-runtimes">354<h3 id="mcp-client-runtimes">

358 MCP client runtimes355 Среды выполнения клиента MCP

359</h3>356</h3>

360 357 

361Claude Code подключается к MCP servers через один из двух client runtimes. Runtime v1 построен на MCP TypeScript SDK 1.x. Runtime v2 — это тот же код на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/), который добавляет MCP protocol revision 2026-07-28. Остальная часть этой страницы применяется к обоим runtimes, кроме случаев, когда раздел называет runtime v2.358Claude Code подключается к MCP серверам через одну из двух сред выполнения клиента. Среда выполнения v1 построена на MCP TypeScript SDK 1.x. Среда выполнения v2 — это тот же код на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/), который добавляет пересмотр протокола MCP 2026-07-28. Остальная часть этой страницы применяется к обеим средам выполнения, кроме случаев, когда раздел называет среду выполнения v2.

362 359 

363Claude Code выбирает runtime каждый раз, когда вы его запускаете, и сохраняет его до выхода. В сеансах, где он [получает feature flags](/docs/ru/env-vars#features-that-need-feature-flag-fetching), он использует runtime v2 на Claude Code версии 2.1.232 или позже.360Claude Code выбирает среду выполнения каждый раз, когда вы его запускаете, и сохраняет её до выхода. В сеансах, где он [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), он использует среду выполнения v2 на Claude Code v2.1.232 или позже.

364 361 

365В сеансах, где он не получает feature flags, Claude Code использует runtime v2 по умолчанию на Claude Code версии 2.1.274 или позже:362В сеансах, где он не получает флаги функций, Claude Code использует среду выполнения v2 по умолчанию на Claude Code v2.1.274 или позже:

366 363 

367* Сеансы на Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform или Microsoft Foundry, если платформа-хост, которая встраивает Claude Code, не установит [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars)364* Сеансы на Amazon Bedrock, Claude Platform на AWS, платформе Agent Platform Google Cloud или Microsoft Foundry, если платформа-хост, которая встраивает Claude Code, не устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars)

368* Сеансы, вошедшие через [Claude apps gateway](/docs/ru/claude-apps-gateway)365* Сеансы, вошедшие через [шлюз приложений Claude](/docs/ru/claude-apps-gateway)

369* Сеансы, где вы отключаете телеметрию или получение feature-flag, например с `DISABLE_TELEMETRY`366* Сеансы, где вы отключаете телеметрию или получение флагов функций, например с `DISABLE_TELEMETRY`

370 367 

371На v2 Claude Code также:368На v2 Claude Code также:

372 369 

373* Спрашивает HTTP servers, поддерживают ли они более новую revision, и использует ее с теми, которые это делают. Он также спрашивает claude.ai connector servers в сеансах, где он получает feature flags. Чтобы он спрашивал stdio servers или connector servers в каждом сеансе, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto`. Он подключается к каждому другому server, как v1 это делает.370* Спрашивает HTTP серверы, поддерживают ли они более новый пересмотр, и использует его с теми, которые это делают. Он также спрашивает серверы соединителей claude.ai в сеансах, где он получает флаги функций. Чтобы заставить его спрашивать stdio серверы или серверы соединителей в каждом сеансе, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto`. Он подключается к каждому другому серверу, как v1 это делает.

374* Получает уведомления `list_changed` от servers на более новой revision через [stream, который он держит открытым](#notification-streams-on-the-v2-runtime).371* Получает уведомления `list_changed` с серверов на более новом пересмотре через [поток, который он держит открытым](#notification-streams-on-the-v2-runtime).

375* Не регистрирует [channel](#push-messages-with-channels) server, который подключается на более новой revision, потому что эта revision не может переносить channel сообщения.372* Не регистрирует сервер [канала](#push-messages-with-channels), который подключается на более новом пересмотре, потому что этот пересмотр не может нести сообщения канала.

376* Не удается [MCP OAuth sign-in](#authenticate-with-remote-mcp-servers), чей ответ авторизации называет неожиданный issuer.373* Не удаётся [вход MCP OAuth](#authenticate-with-remote-mcp-servers), чей ответ авторизации называет неожиданного издателя.

377 374 

378Anthropic может сохранить конкретный server на более ранней protocol или вне этого stream с помощью feature flag, который Claude Code получает.375Anthropic может сохранить конкретный сервер на более раннем протоколе или вне этого потока с флагом функции, который Claude Code получает.

379 376 

380Чтобы выбрать runtime самостоятельно, установите [`MCP_SDK_GENERATION`](/docs/ru/env-vars) на `v1` или `v2`. Чтобы решить, спрашивает ли Claude Code, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto` или `legacy`.377Чтобы выбрать среду выполнения самостоятельно, установите [`MCP_SDK_GENERATION`](/docs/ru/env-vars) на `v1` или `v2`. Чтобы решить, спрашивает ли Claude Code, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto` или `legacy`.

381 378 

382<h3 id="dynamic-tool-updates">379<h3 id="dynamic-tool-updates">

383 Динамические обновления инструментов380 Динамические обновления инструментов

384</h3>381</h3>

385 382 

386Claude Code поддерживает MCP `list_changed` уведомления, позволяя MCP servers динамически обновлять свои доступные инструменты, подсказки и ресурсы без необходимости отключения и переподключения. Когда MCP server отправляет уведомление `list_changed`, Claude Code автоматически обновляет доступные возможности от этого server.383Claude Code поддерживает уведомления MCP `list_changed`, позволяя MCP серверам динамически обновлять свои доступные инструменты, подсказки и ресурсы без необходимости отключения и переподключения. Когда MCP сервер отправляет уведомление `list_changed`, Claude Code автоматически обновляет доступные возможности с этого сервера.

387 384 

388Если запрос обновления не удается, Claude Code сохраняет ранее обнаруженные инструменты, подсказки и ресурсы server до тех пор, пока более позднее обновление не удастся. До версии 2.1.214 временная ошибка во время обновления заменяла инструменты, подсказки и ресурсы server пустым списком.385Если запрос обновления не удаётся, Claude Code сохраняет ранее обнаруженные инструменты, подсказки и ресурсы сервера до тех пор, пока более позднее обновление не удастся. До версии v2.1.214 переходная ошибка во время обновления заменяла инструменты, подсказки и ресурсы сервера пустым списком.

389 386 

390<h4 id="notification-streams-on-the-v2-runtime">387<h4 id="notification-streams-on-the-v2-runtime">

391 Notification streams на runtime v2388 Потоки уведомлений на среде выполнения v2

392</h4>389</h4>

393 390 

394На [runtime v2](#mcp-client-runtimes) Claude Code получает уведомления `list_changed` от server на более новой protocol revision через stream, который он держит открытым. Когда stream закрывается, Claude Code переоткрывает его с двумя ограничениями:391На [среде выполнения v2](#mcp-client-runtimes) Claude Code получает уведомления `list_changed` с сервера на более новом пересмотре протокола через поток, который он держит открытым. Когда поток закрывается, Claude Code переоткрывает его с двумя ограничениями:

395 392 

396* **Stream закрывается снова в течение 10 секунд**: Claude Code переоткрывает его до трех раз, затем останавливается для этого подключения.393* **Поток закрывается снова в течение 10 секунд**: Claude Code переоткрывает его до трёх раз, затем останавливается для этого соединения.

397* **Stream остается открытым дольше 10 секунд, затем закрывается**, как streams к serverless хостам обычно делают: после пяти переоткрытий в час Claude Code ждет примерно шесть часов перед следующим.394* **Поток остаётся открытым дольше 10 секунд, затем закрывается**, как потоки к бессерверным хостам обычно делают: после пяти переоткрытий в час Claude Code ждёт около шести часов перед следующим.

398 395 

399До переоткрытия stream вы сохраняете последний полученный инструменты, подсказки и ресурсы server. Чтобы подобрать его изменения раньше, переподключите server из `/mcp`.396До переоткрытия потока вы сохраняете последние полученные инструменты, подсказки и ресурсы сервера. Чтобы подобрать его изменения раньше, переподключите сервер из `/mcp`.

400 397 

401<h3 id="automatic-reconnection">398<h3 id="automatic-reconnection">

402 Автоматическое переподключение399 Автоматическое переподключение

403</h3>400</h3>

404 401 

405Claude Code переподключает удаленный server, который отключается во время сеанса, и повторяет попытку первого подключения HTTP или SSE server после временной ошибки. Stdio servers — это локальные процессы, и Claude Code не переподключает их автоматически.402Claude Code переподключает удалённый сервер, который отключается во время сеанса, и повторяет попытку первого подключения HTTP или SSE сервера после переходной ошибки. Stdio серверы — это локальные процессы, и Claude Code не переподключает их автоматически.

406 403 

407<h4 id="mid-session-drops-of-a-remote-server">404<h4 id="mid-session-drops-of-a-remote-server">

408 Mid-session drops удаленного server405 Отключения удалённого сервера во время сеанса

409</h4>406</h4>

410 407 

411Claude Code переподключает отключенный удаленный server с экспоненциальной задержкой: до пяти попыток, начиная с задержки в одну секунду и удваивая ее каждый раз. Что вы видите, зависит от того, как вы запускаете Claude Code:408Claude Code переподключает отключённый удалённый сервер с экспоненциальной задержкой: до пяти попыток, начиная с задержки в одну секунду и удваивая её каждый раз. То, что вы видите, зависит от того, как вы запускаете Claude Code:

412 409 

413* **В интерактивном сеансе**: `/mcp` показывает server как ожидающий, пока Claude Code переподключается. После пяти неудачных попыток Claude Code помечает server как неудачный или как нуждающийся в аутентификации, когда server нуждается в авторизации снова. Вы можете повторить попытку вручную из `/mcp`.410* **В интерактивном сеансе**: `/mcp` показывает сервер как ожидающий, пока Claude Code переподключается. После пяти неудачных попыток Claude Code отмечает сервер как неудачный или как нуждающийся в аутентификации, когда сервер нуждается в авторизации снова. Когда он отмечает сервер как неудачный, вы видите уведомление `MCP server "<name>" disconnected · open /mcp to reconnect`. Вы можете повторить попытку вручную из `/mcp`.

414* **В [`claude -p`](/docs/ru/headless) запусках и [Agent SDK](/docs/ru/agent-sdk/overview) сеансах**: Claude Code переподключается по тому же расписанию, без панели `/mcp` для показа попыток.411* **В запусках [`claude -p`](/docs/ru/headless) и сеансах [Agent SDK](/docs/ru/agent-sdk/overview)**: Claude Code переподключается по тому же расписанию, без панели `/mcp` для показа попыток.

415 412 

416<h4 id="failed-first-connections">413<h4 id="failed-first-connections">

417 Неудачные первые подключения414 Неудачные первые подключения

418</h4>415</h4>

419 416 

420Когда первое подключение HTTP или SSE server не удается с временной ошибкой, такой как ответ 5xx, отказ в соединении или timeout, Claude Code повторяет попытку до трех раз. Если подключение все еще не удается, Claude Code помечает server как неудачный. Claude Code повторяет попытку таким образом при запуске и когда server добавляется во время сеанса. Это включает server, который Claude Code добавляет к [cloud session](/docs/ru/claude-code-on-the-web) из его конфигурации, и server, который вы добавляете с помощью Agent SDK's [`setMcpServers()`](/docs/ru/agent-sdk/typescript).417Когда первое подключение HTTP или SSE сервера не удаётся с переходной ошибкой, такой как ответ 5xx, отказ в соединении или тайм-аут, Claude Code повторяет попытку до трёх раз. Если подключение по-прежнему не удаётся, Claude Code отмечает сервер как неудачный. Claude Code повторяет попытку таким образом при запуске и когда сервер добавляется во время сеанса. Это включает сервер, который Claude Code добавляет в [облачный сеанс](/docs/ru/claude-code-on-the-web) из его конфигурации, и сервер, который вы добавляете с помощью метода [`setMcpServers()`](/docs/ru/agent-sdk/typescript) Agent SDK.

421 418 

422Claude Code не повторяет попытку в этих случаях:419Claude Code не повторяет попытку в этих случаях:

423 420 

424* Первое подключение WebSocket server421* Первое подключение WebSocket сервера

425* Ошибка аутентификации или не найдено, потому что это требует изменения конфигурации для разрешения. Когда [`headersHelper`](#use-dynamic-headers-for-custom-authentication) является единственным источником server заголовка `Authorization`, Claude Code повторяет попытку ошибки аутентификации в любом случае, потому что он повторно запускает helper при каждой попытке и может подобрать свежие учетные данные422* Ошибка аутентификации или не найдено, потому что это требует изменения конфигурации для разрешения. Когда [`headersHelper`](#use-dynamic-headers-for-custom-authentication) — единственный источник сервера заголовка `Authorization`, Claude Code повторяет попытку ошибки аутентификации в любом случае, потому что он повторно запускает помощника при каждой попытке и может подобрать свежие учётные данные

426 423 

427<h4 id="failed-discovery-requests">424<h4 id="failed-discovery-requests">

428 Неудачные запросы обнаружения425 Неудачные запросы обнаружения

429</h4>426</h4>

430 427 

431После подключения server Claude Code отправляет ему запросы обнаружения возможностей, такие как `tools/list`, `prompts/list` и `resources/list`. Claude Code повторяет эти запросы до трех раз с короткой задержкой после временной сетевой или серверной ошибки. Он не повторяет ошибки аутентификации, ответы 4xx или timeout запросов.428После подключения сервера Claude Code отправляет ему запросы обнаружения возможностей, такие как `tools/list`, `prompts/list` и `resources/list`. Claude Code повторяет эти запросы до трёх раз с короткой задержкой после переходной сетевой или серверной ошибки. Он не повторяет ошибки аутентификации, ответы 4xx или тайм-ауты запросов.

432 429 

433<h4 id="how-claude-learns-that-a-server-failed">430<h4 id="how-claude-learns-that-a-server-failed">

434 Как Claude узнает, что server не удался431 Как Claude узнаёт, что сервер не удался

435</h4>432</h4>

436 433 

437Зависит ли то, что Claude Code сообщает Claude о настроенном server, который не удалось подключить, от [поиска инструментов](#scale-with-mcp-tool-search), который включен по умолчанию:434Сообщает ли Claude Code Claude о настроенном сервере, который не смог подключиться, зависит от [поиска инструментов](#scale-with-mcp-tool-search), который включён по умолчанию:

438 435 

439* С поиском инструментов Claude Code сообщает Claude, какой server не удалось подключить и его ошибку подключения, поэтому Claude сообщает об ошибке подключения в своем ответе. Claude Code включает ту же информацию в результаты `ToolSearch`, которые не находят соответствующий инструмент.436* С поиском инструментов Claude Code сообщает Claude, какой сервер не удался и его ошибка подключения, поэтому Claude сообщает об ошибке подключения в своём ответе. Claude Code включает ту же информацию в результаты `ToolSearch`, которые не находят соответствующий инструмент.

440* В любой [конфигурации без поиска инструментов](#configure-tool-search) Claude Code не сообщает Claude об ошибках подключения неудачных servers.437* В любой [конфигурации без поиска инструментов](#configure-tool-search) Claude Code не сообщает Claude о неудачных подключениях сервера.

441 438 

442<h3 id="push-messages-with-channels">439<h3 id="push-messages-with-channels">

443 Отправка сообщений через каналы440 Отправка сообщений с каналами

444</h3>441</h3>

445 442 

446MCP server также может отправлять сообщения непосредственно в вашу сессию, чтобы Claude мог реагировать на внешние события, такие как результаты CI, оповещения мониторинга или сообщения чата. Чтобы включить это, ваш server объявляет возможность `claude/channel` и вы включаете ее с флагом `--channels` при запуске. См. [Каналы](/docs/ru/channels) для использования официально поддерживаемого канала или [Справочник каналов](/docs/ru/channels-reference) для создания собственного.443MCP сервер также может отправлять сообщения непосредственно в ваш сеанс, чтобы Claude мог реагировать на внешние события, такие как результаты CI, оповещения мониторинга или сообщения чата. Чтобы включить это, ваш сервер объявляет возможность `claude/channel` и вы выбираете его с флагом `--channels` при запуске. Смотрите [Каналы](/docs/ru/channels) для использования официально поддерживаемого канала или [Справочник каналов](/docs/ru/channels-reference) для создания своего собственного.

447 444 

448На [runtime v2](#mcp-client-runtimes), если вы установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto` и channel server согласует MCP protocol revision 2026-07-28, он не может доставлять channel сообщения, поэтому Claude Code не регистрирует его как канал. Оставление переменной неустановленной или установка ее на `legacy` сохраняет stdio servers на более ранней handshake.445На [среде выполнения v2](#mcp-client-runtimes), если вы установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto` и сервер канала согласует пересмотр протокола MCP 2026-07-28, он не может доставлять сообщения канала, поэтому Claude Code не регистрирует его как канал. Оставление переменной неустановленной или установка её на `legacy` сохраняет stdio серверы на более раннем рукопожатии.

449 446 

450<Tip>447<Tip>

451 Советы:448 Советы:

452 449 

453 * Используйте флаг `-s` или `--scope` для указания места хранения конфигурации:450 * Используйте флаг `-s` или `--scope` для указания, где хранится конфигурация:

454 * `local` (по умолчанию): доступно только вам в текущем проекте451 * `local` (по умолчанию): доступно только вам в текущем проекте

455 * `project`: общий доступ для всех в проекте через файл `.mcp.json`452 * `project`: общее со всеми в проекте через файл `.mcp.json`

456 * `user`: доступно вам во всех проектах453 * `user`: доступно вам во всех проектах

457 * Установите переменные окружения с флагами `-e` или `--env` (например, `-e KEY=value`)454 * Установите переменные окружения с флагами `-e` или `--env` (например, `-e KEY=value`)

458 * Флаги `--transport` и `--header` также принимают короткие формы `-t` и `-H`455 * Флаги `--transport` и `--header` также принимают короткие формы `-t` и `-H`

459 * Настройте timeout запуска MCP server, используя переменную окружения `MCP_TIMEOUT` (например, `MCP_TIMEOUT=10000 claude` устанавливает timeout в 10 секунд)456 * Настройте тайм-аут запуска MCP сервера, используя переменную окружения `MCP_TIMEOUT` (например, `MCP_TIMEOUT=10000 claude` устанавливает тайм-аут в 10 секунд)

460 * Установите timeout выполнения инструмента для каждого server, добавив поле `timeout` в миллисекундах в запись этого server в `.mcp.json`, например `"timeout": 600000` для десяти минут. Это переопределяет переменную окружения `MCP_TOOL_TIMEOUT` только для этого server457 * Установите тайм-аут выполнения инструмента для каждого сервера, добавив поле `timeout` в миллисекундах в запись `.mcp.json` этого сервера, например `"timeout": 600000` на десять минут. Это переопределяет переменную окружения `MCP_TOOL_TIMEOUT` только для этого сервера

461 * Claude Code отобразит предупреждение, когда выход инструмента MCP превышает 10 000 токенов и ограничивает выход до 25 000 токенов по умолчанию. Чтобы увеличить этот лимит, установите переменную окружения `MAX_MCP_OUTPUT_TOKENS` (например, `MAX_MCP_OUTPUT_TOKENS=50000`); порог предупреждения фиксирован. См. [Лимиты выхода MCP и предупреждения](#mcp-output-limits-and-warnings)458 * Claude Code отображает предупреждение, когда выход инструмента MCP превышает 10 000 токенов и ограничивает выход до 25 000 токенов по умолчанию. Чтобы повысить лимит, установите переменную окружения `MAX_MCP_OUTPUT_TOKENS` (например, `MAX_MCP_OUTPUT_TOKENS=50000`); порог предупреждения фиксирован. Смотрите [Ограничения и предупреждения выхода MCP](#mcp-output-limits-and-warnings)

462 * Используйте `/mcp` для аутентификации с удаленными servers, которые требуют аутентификацию OAuth 2.0459 * Используйте `/mcp` для аутентификации с удалёнными серверами, которые требуют аутентификацию OAuth 2.0

463</Tip>460</Tip>

464 461 

465Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. Для HTTP, SSE или [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) server существует также второй таймер для каждого запроса, который охватывает каждый запрос до первого байта ответа server. Claude Code устанавливает этот таймер на наибольшее из трех значений: 60 секунд, timeout инструмента, который применяется к server, и `MCP_TIMEOUT`. Значение по умолчанию 28 часов неустановленного `MCP_TOOL_TIMEOUT` не входит в это сравнение, и значение ниже 60 секунд не сокращает таймер. Stdio и WebSocket servers не имеют таймера для каждого запроса.462Тайм-аут для каждого сервера — это жёсткий предел реального времени для каждого вызова инструмента, и уведомления о прогрессе с сервера не расширяют его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT` или к его значению по умолчанию около 28 часов, когда эта переменная не установлена. Для HTTP, SSE или [соединителя claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) сервера также есть второй таймер для каждого запроса, который охватывает каждый запрос до первого байта ответа сервера. Claude Code устанавливает этот таймер на наибольшее из трёх значений: 60 секунд, тайм-аут инструмента, который применяется к серверу, и `MCP_TIMEOUT`. Значение по умолчанию 28 часов неустановленного `MCP_TOOL_TIMEOUT` не входит в это сравнение, и значение ниже 60 секунд не сокращает таймер. Stdio и WebSocket серверы не имеют таймера для каждого запроса.

466 463 

467Timeout для каждого server не менее 1000 также действует как нижний предел для timeout неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого server из-за неактивности раньше, чем timeout для каждого server. Требуется Claude Code версии 2.1.203 или позже.464Тайм-аут для каждого сервера не менее 1000 также действует как нижний предел для тайм-аута неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого сервера из-за неактивности раньше, чем тайм-аут для каждого сервера. Требует Claude Code v2.1.203 или позже.

468 465 

469Вызов инструмента к MCP server, который не отправляет ответ и не отправляет уведомление о прогрессе в течение окна неактивности, прерывается с ошибкой вместо ожидания лимита реального времени. Он применяется к каждому типу server, кроме IDE servers и SDK in-process servers. Окно неактивности по умолчанию составляет пять минут для HTTP, SSE, WebSocket и [claude.ai connector](#use-mcp-servers-from-claude-ai) servers, и 30 минут для stdio servers. До версии 2.1.203 stdio servers были освобождены от timeout неактивности.466Вызов инструмента к MCP серверу, который не отправляет ответ и не отправляет уведомление о прогрессе в течение окна неактивности, прерывается с ошибкой вместо ожидания предела реального времени. Тайм-аут неактивности применяется к каждому типу сервера, кроме IDE серверов и SDK встроенных серверов. Окно неактивности по умолчанию составляет пять минут для HTTP, SSE, WebSocket и [соединителей claude.ai](#use-mcp-servers-from-claude-ai) серверов и 30 минут для stdio серверов. До версии v2.1.203 stdio серверы были освобождены от тайм-аута неактивности.

470 467 

471Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку.468Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите её на `0`, чтобы отключить проверку.

472 469 

473Эти timeouts ограничивают, как долго вызов может работать, не всегда как долго он блокирует сеанс: вызов основного разговора, который работает более двух минут, сначала переходит в фоновую задачу. См. [Автоматическое фоновое выполнение долгих вызовов инструментов](#automatic-backgrounding-of-long-tool-calls).470Эти тайм-ауты ограничивают, как долго может работать вызов, не всегда как долго он блокирует сеанс: вызов основного разговора, который работает более двух минут, сначала переходит в фоновую задачу. Смотрите [Автоматическое фоновое выполнение долгих вызовов инструментов](#automatic-backgrounding-of-long-tool-calls).

474 471 

475<h3 id="automatic-backgrounding-of-long-tool-calls">472<h3 id="automatic-backgrounding-of-long-tool-calls">

476 Автоматическое фоновое выполнение долгих вызовов инструментов473 Автоматическое фоновое выполнение долгих вызовов инструментов

477</h3>474</h3>

478 475 

479Вызов инструмента MCP в основном разговоре, который все еще работает после двух минут, переходит в фоновую задачу вместо блокирования сеанса. Claude получает ID задачи немедленно и продолжает работать, и результат приходит как уведомление задачи, когда вызов завершается. Автоматическое фоновое выполнение требует Claude Code версии 2.1.212 или позже.476Вызов инструмента MCP в основном разговоре, который всё ещё работает после двух минут, переходит в фоновую задачу вместо блокирования сеанса. Claude получает ID задачи немедленно и продолжает работать, и результат приходит как уведомление задачи, когда вызов завершается. Автоматическое фоновое выполнение требует Claude Code v2.1.212 или позже.

480 477 

481Задача отображается в [`/tasks`](/docs/ru/commands#all-commands), где вы также можете ее остановить, и она не сохраняется при выходе из сеанса. Лимиты для каждого вызова все еще применяются, пока вызов работает в фоне: лимит реального времени, установленный timeout для каждого server или [`MCP_TOOL_TIMEOUT`](/docs/ru/env-vars), и timeout неактивности, установленный [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars).478Задача появляется в [`/tasks`](/docs/ru/commands#all-commands), где вы также можете её остановить, и она не сохраняется при выходе из сеанса. Ограничения для каждого вызова по-прежнему применяются, пока вызов работает в фоне: предел реального времени, установленный тайм-аутом для каждого сервера или [`MCP_TOOL_TIMEOUT`](/docs/ru/env-vars), и тайм-аут неактивности, установленный [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars).

482 479 

483Установите переменную окружения [`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`](/docs/ru/env-vars) в миллисекундах, чтобы изменить порог, или установите ее на `0`, чтобы отключить автоматическое фоновое выполнение. Установка `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1` также отключает его, наряду со всеми другими функциями фоновых задач.480Установите переменную окружения [`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`](/docs/ru/env-vars) в миллисекундах, чтобы изменить порог, или установите её на `0`, чтобы отключить автоматическое фоновое выполнение. Установка `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1` также отключает его, наряду со всеми другими функциями фоновых задач.

484 481 

485Некоторые вызовы никогда не переходят в фон:482Некоторые вызовы никогда не переходят в фон:

486 483 

487* Вызовы от [subagents](/docs/ru/sub-agents); Claude Code фоновое выполнение только вызовов основного разговора484* Вызовы из [подагентов](/docs/ru/sub-agents); Claude Code фоновое выполнение только вызовов основного разговора

488* Вызовы к IDE servers485* Вызовы к IDE серверам

489* Вызовы в [non-interactive mode](/docs/ru/headless), если `CLAUDE_AUTO_BACKGROUND_TASKS` не установлен на `1`, так как одноразовый запуск может завершиться до прихода результата486* Вызовы в [неинтерактивном режиме](/docs/ru/headless), если только `CLAUDE_AUTO_BACKGROUND_TASKS` не установлена на `1`, так как одноразовый запуск может завершиться до прибытия результата

490 487 

491Вызов, ожидающий открытого [диалога elicitation](#respond-to-mcp-elicitation-requests), не фоновое выполнение, пока диалог открыт; server заблокирован на вашем вводе, а не медленный, поэтому Claude Code откладывает перемещение до закрытия диалога.488Вызов, ожидающий открытого [диалога запроса](#respond-to-mcp-elicitation-requests), не фоновое выполнение, пока диалог открыт; сервер заблокирован на вашем вводе, а не медленный, поэтому Claude Code откладывает переход до закрытия диалога.

492 489 

493<h3 id="plugin-provided-mcp-servers">490<h3 id="plugin-provided-mcp-servers">

494 Plugin-provided MCP servers491 MCP серверы, предоставляемые плагинами

495</h3>492</h3>

496 493 

497[Плагины](/docs/ru/plugins/overview) могут включать MCP servers, которые предоставляют инструменты и интеграции при включении плагина. Plugin MCP servers работают идентично пользовательским настроенным servers.494[Плагины](/docs/ru/plugins/overview) могут объединять MCP серверы, которые предоставляют инструменты и интеграции при включении плагина. MCP серверы плагинов работают идентично пользовательским настроенным серверам.

498 495 

499**Как работают plugin MCP servers**:496**Как работают MCP серверы плагинов**:

500 497 

501* Плагины определяют MCP servers в `.mcp.json` в корне плагина или встроенные в `plugin.json`498* Плагины определяют MCP серверы в `.mcp.json` в корне плагина или встроенные в `plugin.json`

502* Когда вы включаете плагин, Claude Code автоматически запускает его MCP servers499* Когда вы включаете плагин, Claude Code автоматически запускает его MCP серверы

503* Claude Code предлагает plugin MCP tools рядом с вручную настроенными MCP tools500* Claude Code предлагает инструменты MCP плагинов наряду с вручную настроенными инструментами MCP

504* Вы добавляете и удаляете plugin servers путем установки или удаления плагина, а не с помощью команд `/mcp`. Вы все еще можете [отключить установленный plugin server](#disable-a-server-without-removing-it) в `/mcp`, что останавливает Claude Code от подключения к нему без удаления плагина501* Вы добавляете и удаляете серверы плагинов, устанавливая или удаляя плагин, а не с помощью команд `/mcp`. Вы по-прежнему можете [переключить установленный сервер плагина](#disable-a-server-without-removing-it) в `/mcp`, что останавливает Claude Code от подключения к нему без удаления плагина

505 502 

506**Пример конфигурации plugin MCP**:503**Пример конфигурации MCP плагина**:

507 504 

508В `.mcp.json` в корне плагина:505В `.mcp.json` в корне плагина:

509 506 

535}532}

536```533```

537 534 

538**Функции plugin MCP**:535**Функции MCP плагинов**:

539 536 

540* **Автоматический жизненный цикл**: servers подключаются и отключаются в этих точках:537* **Автоматический жизненный цикл**: серверы подключаются и отключаются в этих точках:

541 * При запуске сеанса Claude Code автоматически подключает servers для включенных плагинов. В `/mcp` удаленный (HTTP или SSE) plugin server, который вы использовали раньше, может показать статус [`cached`](#server-status-detail) вместо этого; Claude Code подключает его, когда Claude впервые вызывает один из его инструментов538 * При запуске сеанса Claude Code автоматически подключает серверы для включённых плагинов. В `/mcp` удалённый (HTTP или SSE) сервер плагина, который вы использовали раньше, может показать статус [`cached`](#server-status-detail) вместо этого; Claude Code подключает его, когда Claude впервые вызывает один из его инструментов

542 * Если вы включаете или отключаете плагин во время сеанса, Claude Code подключает или отключает его MCP servers, когда изменение применяется. [Применить изменения плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins) описывает, когда это происходит. В сеансе без интерактивного терминала `/reload-plugins` не подключает или отключает plugin MCP servers; эти изменения вступают в силу в вашем следующем сеансе539 * Если вы включаете или отключаете плагин во время сеанса, Claude Code подключает или отключает его MCP серверы, когда изменение применяется. [Применение изменений плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins) описывает, когда это происходит. В сеансе без интерактивного терминала `/reload-plugins` не подключает и не отключает MCP серверы плагинов; эти изменения вступают в силу в вашем следующем сеансе

543 * Когда вы перезагружаете, Claude Code сохраняет живые подключения plugin servers, конфигурация которых не изменилась, и делает то же самое, когда вы [заменяете список MCP servers сеанса](/docs/ru/agent-sdk/typescript#mcpsetserversresult) из Agent SDK без их названия540 * Когда вы перезагружаете, Claude Code сохраняет живые соединения серверов плагинов, чья конфигурация не изменилась, и делает то же самое, когда вы [заменяете список MCP сервера сеанса](/docs/ru/agent-sdk/typescript#mcpsetserversresult) из Agent SDK без их названия

544 * Когда вы [перемещаете сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на версии 2.1.246 или позже, Claude Code подключает servers плагинов, которые включают параметры новой директории, и отключает servers плагинов, которые больше не включены, поэтому вам не нужно запускать `/reload-plugins` после перемещения541 * Когда вы [перемещаете сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на v2.1.246 или позже, Claude Code подключает серверы плагинов, которые включают параметры новой директории, и отключает серверы плагинов, которые больше не включены, поэтому вам не нужно запускать `/reload-plugins` после перемещения

545 * В [cloud sessions](/docs/ru/claude-code-on-the-web) вызов MCP к plugin server, который еще не подключен, такой как сразу после пробуждения неактивного сеанса, запускает server по требованию и ждет его подключения542 * В [облачных сеансах](/docs/ru/claude-code-on-the-web) вызов MCP к серверу плагина, который ещё не подключён, такой как сразу после пробуждения неактивного сеанса, запускает сервер по требованию и ждёт его подключения

546* **Заполнители пути**: `${CLAUDE_PLUGIN_ROOT}` разрешается в директорию установки плагина, `${CLAUDE_PLUGIN_DATA}` в его [директорию постоянного состояния](/docs/ru/plugins/components#path-variables-and-persistent-data), и `${CLAUDE_PROJECT_DIR}` в стабильный корень проекта. Подстановка применяется к:543* **Заполнители пути**: `${CLAUDE_PLUGIN_ROOT}` разрешается в директорию установки плагина, `${CLAUDE_PLUGIN_DATA}` в его директорию [постоянного состояния](/docs/ru/plugins/components#path-variables-and-persistent-data) и `${CLAUDE_PROJECT_DIR}` в стабильный корень проекта. Подстановка применяется к:

547 * `stdio` servers: `command`, `args`, `env`544 * серверам `stdio`: `command`, `args`, `env`

548 * `http`, `sse` и `ws` servers: `url`, `headers` и `headersHelper`. До версии 2.1.195 `headersHelper` передавал заполнитель как буквальную строку545 * серверам `http`, `sse` и `ws`: `url`, `headers` и `headersHelper`. До версии v2.1.195 `headersHelper` передавал заполнитель как буквальную строку

549* **Доступ к переменным окружения пользователя**: доступ к тем же переменным окружения, что и вручную настроенные servers546* **Доступ к пользовательскому окружению**: доступ к тем же переменным окружения, что и вручную настроенные серверы

550* **Несколько типов транспорта**: поддержка stdio, SSE, HTTP и WebSocket транспортов, хотя поддержка транспорта может варьироваться в зависимости от server547* **Несколько типов транспорта**: поддержка транспортов stdio, SSE, HTTP и WebSocket, хотя поддержка транспорта может варьироваться по серверам

551 548 

552Plugin servers отображаются в `/mcp` с индикаторами, показывающими, что они поступают из плагинов.549Серверы плагинов появляются в `/mcp` с индикаторами, показывающими, что они поступают из плагинов.

553 550 

554**Имена plugin MCP tools**:551**Имена инструментов MCP плагинов**:

555 552 

556Инструменты из MCP server, включенного в плагин, содержат как имя плагина, так и ключ server в их вызываемом имени. Полная форма — `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, где любой символ вне `A-Z`, `a-z`, `0-9`, `_` и `-` заменяется на `_`. Для server `database-tools`, включенного в плагин с именем `my-plugin`, инструмент `query` вызывается как:553Инструменты с сервера MCP, объединённого с плагином, включают как имя плагина, так и ключ сервера в их вызываемое имя. Полная форма — `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, где любой символ вне `A-Z`, `a-z`, `0-9`, `_` и `-` заменяется на `_`. Для сервера `database-tools`, объединённого в плагин с именем `my-plugin`, инструмент `query` вызывается как:

557 554 

558```555```

559mcp__plugin_my-plugin_database-tools__query556mcp__plugin_my-plugin_database-tools__query

560```557```

561 558 

562Используйте это полное имя при ссылке на инструмент в [правилах разрешений](/docs/ru/permissions), в списке `allowed-tools` skill, в [поле `tools` subagent](/docs/ru/sub-agents#available-tools) или в [matcher hook](/docs/ru/hooks#match-mcp-tools). Matcher hook, написанный против простого ключа server, такой как `mcp__database-tools__.*`, никогда не срабатывает для plugin-bundled server.559Используйте это полное имя при ссылке на инструмент в [правилах разрешений](/docs/ru/permissions), списке `allowed-tools` навыка, поле `tools` [подагента](/docs/ru/sub-agents#available-tools) или [сопоставителе hook](/docs/ru/hooks#match-mcp-tools). Сопоставитель hook, написанный для голого ключа сервера, такой как `mcp__database-tools__.*`, никогда не срабатывает для сервера, объединённого с плагином.

563 560 

564Server сам регистрируется под scoped именем `plugin:<plugin-name>:<server-name>`, такой как `plugin:my-plugin:database-tools`. Используйте это имя там, где ожидается имя настроенного server, такой как [поле `server` hook `mcp_tool`](/docs/ru/hooks#mcp-tool-hook-fields).561Сам сервер регистрируется под именем с областью `plugin:<plugin-name>:<server-name>`, такой как `plugin:my-plugin:database-tools`. Используйте это имя, где ожидается имя настроенного сервера, такое как поле `server` [hook `mcp_tool`](/docs/ru/hooks#mcp-tool-hook-fields).

565 562 

566См. [справочник компонентов плагина](/docs/ru/plugins/components#mcp-servers) для получения подробной информации о включении MCP servers в плагины.563Смотрите [справочник компонентов плагинов](/docs/ru/plugins/components#mcp-servers) для деталей об объединении MCP серверов с плагинами.

567 564 

568<h2 id="mcp-installation-scopes">565<h2 id="mcp-installation-scopes">

569 Области установки MCP566 Области установки MCP

6694. [Plugin-provided servers](/docs/ru/plugins/components#mcp-servers)6664. [Plugin-provided servers](/docs/ru/plugins/components#mcp-servers)

6705. [claude.ai connectors](#use-mcp-servers-from-claude-ai)6675. [claude.ai connectors](#use-mcp-servers-from-claude-ai)

671 668 

672Три области совпадают дубликаты по имени. Плагины и соединители совпадают по конечной точке, поэтому тот, который указывает на тот же URL или команду, что и server выше, рассматривается как дубликат.669Claude Code совпадает дубликаты по трем областям по имени. Плагины и соединители совпадают по конечной точке, поэтому тот, который указывает на тот же URL или команду, что и server выше, рассматривается как дубликат.

670 

671Два написания URL считаются одной конечной точкой, когда они отличаются только буквой регистра схемы или хоста, портом по умолчанию схемы, таким как `:443` на `https`, или косой чертой в конце. Другой путь, строка запроса, userinfo или нестандартный порт делают два servers разными.

673 672 

674Server, который ваша организация предоставляет через управляемый параметр [`managedMcpServers`](/docs/ru/managed-mcp#provide-servers-through-managed-settings), занимает место выше всех этих, поэтому когда один из них дублирует его, Claude Code подключает определение организации. Требует Claude Code v2.1.259 или позже.673Server, который ваша организация предоставляет через управляемый параметр [`managedMcpServers`](/docs/ru/managed-mcp#provide-servers-through-managed-settings), занимает место выше всех этих, поэтому когда один из них дублирует его, Claude Code подключает определение организации. Требует Claude Code v2.1.259 или позже.

675 674 

816```815```

817 816 

818<h2 id="authenticate-with-remote-mcp-servers">817<h2 id="authenticate-with-remote-mcp-servers">

819 Аутентификация с удаленными MCP servers818 Аутентификация с удаленными MCP серверами

820</h2>819</h2>

821 820 

822Многие облачные MCP servers требуют аутентификации. Claude Code поддерживает OAuth 2.0 для безопасных соединений.821Многие облачные MCP серверы требуют аутентификации. Claude Code поддерживает OAuth 2.0 для безопасных соединений.

823 822 

824Claude Code отмечает удаленный server как требующий аутентификации, когда server отвечает с `401 Unauthorized` или `403 Forbidden`. То, что показывает Claude Code, зависит от server:823Claude Code помечает удаленный сервер как требующий аутентификации, когда сервер отвечает с `401 Unauthorized` или `403 Forbidden`. То, что показывает Claude Code, зависит от сервера:

825 824 

826* Для server, на который вы еще не вошли, любой из этих кодов состояния отмечает его в `/mcp`, чтобы вы могли завершить поток OAuth.825* Для сервера, на который вы еще не вошли, любой из этих кодов состояния помечает его в `/mcp`, чтобы вы могли завершить поток OAuth.

827* Для [разъема claude.ai](#use-mcp-servers-from-claude-ai), `401`, вызванный отклонением claude.ai вашего токена сеанса, не отмечает разъем, потому что повторная авторизация разъема не может исправить вашу учетную запись. Claude Code показывает [состояние отклонения токена сеанса](/docs/ru/errors#claude-ai-rejected-the-session-token) вместо этого.826* Для [коннектора claude.ai](#use-mcp-servers-from-claude-ai), `401`, вызванный отклонением claude.ai вашего токена сеанса, не помечает коннектор, потому что повторная авторизация коннектора не может исправить вашу учетную запись. Claude Code показывает [состояние отклонения токена сеанса](/docs/ru/errors#claude-ai-rejected-the-session-token) вместо этого.

828* Для server, чей заголовок `Authorization` вы настроили в `headers` или через [`headersHelper`](#use-dynamic-headers-for-custom-authentication), `401` или `403` при подключении не отмечает server, потому что учетные данные для исправления — это те, которые вы настроили. Claude Code сообщает о соединении как о неудачном вместо этого. Если вы установили этот заголовок из ссылки `${VAR}`, проверьте, является ли эта переменная одной из тех, которые Claude Code [читает как пустые](#credential-variables-that-read-as-empty).827* Для сервера, чей заголовок `Authorization` вы настроили в `headers` или через [`headersHelper`](#use-dynamic-headers-for-custom-authentication), `401` или `403` при подключении не помечает сервер, потому что учетные данные для исправления — это те, которые вы настроили. Claude Code вместо этого сообщает о неудачном соединении. Если вы установили этот заголовок из ссылки `${VAR}`, проверьте, является ли эта переменная одной из тех, которые Claude Code [читает как пустые](#credential-variables-that-read-as-empty).

829* Для разъема [доставленного в облачный сеанс](#how-connectors-reach-claude-code), Claude Code не запускает поток входа, потому что прокси сеанса аутентифицируется с разъемом с авторизацией, которую вы предоставили в claude.ai. Когда разъем там требует авторизации снова, переподключите его на [claude.ai/customize/connectors](https://claude.ai/customize/connectors) вместо сеанса.828* Для коннектора [доставленного в облачный сеанс](#how-connectors-reach-claude-code), Claude Code не запускает поток входа, потому что прокси сеанса аутентифицируется на коннекторе с авторизацией, которую вы предоставили в claude.ai. Когда коннектор там требует повторной авторизации, переподключитесь на [claude.ai/customize/connectors](https://claude.ai/customize/connectors) вместо сеанса.

830 829 

831Когда запрос к OAuth server, на который вы уже вошли, возвращает `401 Unauthorized`, Claude Code обновляет сохраненный токен, переподключается и повторяет запрос один раз. Он отмечает server в `/mcp` только если этот повторный запрос также не удается. До v2.1.206 обновление токена, которое не удалось по временной причине, такой как ошибка сети, отмечало OAuth server как требующий аутентификации для остальной части сеанса, даже если его токен обновления был все еще действителен.830Когда запрос к OAuth серверу, на который вы уже вошли, возвращает `401 Unauthorized`, Claude Code обновляет сохраненный токен, переподключается и повторяет запрос один раз. Он помечает сервер в `/mcp` только если этот повтор также не удается. До v2.1.206 обновление токена, которое не удалось по временной причине, такой как ошибка сети, помечало OAuth сервер как требующий аутентификации на остаток сеанса, даже если его токен обновления был все еще действителен.

832 831 

833Когда server отклоняет сохраненный токен обновления, Claude Code немедленно показывает уведомление, указывающее на `/mcp`. Откройте `/mcp` и выберите **Re-authenticate** на server, чтобы снова войти перед следующим вызовом инструмента.832Когда сервер отклоняет сохраненный токен обновления, Claude Code немедленно показывает уведомление, указывающее на `/mcp`. Откройте `/mcp` и выберите **Re-authenticate** на сервере, чтобы войти снова перед следующим вызовом инструмента.

834 833 

835Пользовательский server, который возвращает заголовок `WWW-Authenticate`, указывающий на его сервер авторизации, получает то же автоматическое обнаружение, как и любой другой удаленный server.834Пользовательский сервер, который возвращает заголовок `WWW-Authenticate`, указывающий на его сервер авторизации, получает такое же автоматическое обнаружение, как и любой другой удаленный сервер.

836 835 

837Claude Code также показывает уведомление при запуске, когда один или несколько настроенных servers требуют аутентификации, поэтому вам не нужно открывать `/mcp` для обнаружения, какие servers требуют входа. Уведомление требует Claude Code v2.1.193 или позже. Оно считает только servers, на которые вы можете войти из Claude Code. До v2.1.218 оно также считало [разъемы claude.ai](#use-mcp-servers-from-claude-ai), которые не были подключены в claude.ai, которые вы можете подключить только из параметров claude.ai.836Claude Code также показывает уведомление при запуске, когда один или несколько настроенных серверов требуют аутентификации, поэтому вам не нужно открывать `/mcp`, чтобы узнать, какие серверы требуют входа. Уведомление требует Claude Code v2.1.193 или позже. Оно считает только серверы, на которые вы можете войти из Claude Code. До v2.1.218 оно также считало [коннекторы claude.ai](#use-mcp-servers-from-claude-ai), которые не были подключены в claude.ai, которые вы можете подключить только из параметров claude.ai.

838 837 

839Уведомление объявляет каждый server один раз и исключает его из подсчета при последующих запусках, пока этот server не подключится и не потребует входа снова. `/mcp` по-прежнему перечисляет каждый server, который требует входа.838Уведомление объявляет каждый сервер один раз и исключает его из подсчета при последующих запусках, пока этот сервер не подключится и снова не потребует входа. `/mcp` по-прежнему перечисляет каждый сервер, который требует входа.

840 839 

841В неинтерактивном режиме нет панели `/mcp`, поэтому Claude Code не может запустить поток OAuth для вас. Начиная с v2.1.196, когда настроенный server требует аутентификации во время запуска `claude -p` или Agent SDK с включенным [поиском инструментов](#scale-with-mcp-tool-search), что является значением по умолчанию, Claude Code сообщает Claude, что инструменты server недоступны, пока вы его не авторизуете. Claude затем может назвать server, который требует входа, вместо того чтобы отвечать так, как будто server не был настроен. Завершите вход из интерактивного сеанса с помощью `/mcp` или `claude mcp login <name>`.840В неинтерактивном режиме нет панели `/mcp`, поэтому Claude Code не может запустить поток OAuth для вас. Начиная с v2.1.196, когда настроенный сервер требует аутентификации во время запуска `claude -p` или Agent SDK с включенным [поиском инструментов](#scale-with-mcp-tool-search), что является значением по умолчанию, Claude Code сообщает Claude, что инструменты сервера недоступны, пока вы его не авторизуете. Claude затем может назвать сервер, который требует входа, вместо того чтобы отвечать так, как если бы сервер не был настроен. Завершите вход из интерактивного сеанса с `/mcp` или `claude mcp login <name>`.

842 841 

843Если вы настроили `headers.Authorization` для server и server отклонил этот заголовок, Claude Code сообщает о соединении как о неудачном вместо того, чтобы вернуться к OAuth. Проверьте, что токен действителен для конечной точки MCP, или удалите заголовок, чтобы использовать поток OAuth.842Если вы настроили `headers.Authorization` для сервера и сервер отклоняет этот заголовок, Claude Code сообщает о неудачном соединении вместо возврата к OAuth. Проверьте, что токен действителен для конечной точки MCP, или удалите заголовок, чтобы использовать поток OAuth.

844 843 

845<Steps>844<Steps>

846 <Step title="Добавьте server, который требует аутентификации">845 <Step title="Добавьте сервер, требующий аутентификации">

847 Если вы уже добавили server `sentry` в [быстром старте MCP](/docs/ru/mcp-quickstart#connect-a-server-that-requires-sign-in), пропустите этот шаг: запуск `claude mcp add` снова с тем же именем server в той же области не удается с `MCP server sentry already exists in local config`. В противном случае запустите:846 Если вы уже добавили сервер `sentry` в [быстром старте MCP](/docs/ru/mcp-quickstart#connect-a-server-that-requires-sign-in), пропустите этот шаг: повторный запуск `claude mcp add` с тем же именем сервера в той же области завершится ошибкой `MCP server sentry already exists in local config`. В противном случае запустите:

848 847 

849 ```bash theme={null}848 ```bash theme={null}

850 claude mcp add --transport http sentry https://mcp.sentry.dev/mcp849 claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

869 * Используйте "Clear authentication" в меню `/mcp` для отзыва доступа868 * Используйте "Clear authentication" в меню `/mcp` для отзыва доступа

870 * Если ваш браузер не открывается автоматически, скопируйте предоставленный URL и откройте его вручную869 * Если ваш браузер не открывается автоматически, скопируйте предоставленный URL и откройте его вручную

871 * Если перенаправление браузера не удается с ошибкой соединения после аутентификации, вставьте полный URL обратного вызова из адресной строки браузера в приглашение URL, которое появляется в Claude Code870 * Если перенаправление браузера не удается с ошибкой соединения после аутентификации, вставьте полный URL обратного вызова из адресной строки браузера в приглашение URL, которое появляется в Claude Code

872 * Аутентификация OAuth работает с HTTP servers871 * Аутентификация OAuth работает с HTTP серверами

873</Tip>872</Tip>

874 873 

875<h3 id="authenticate-from-the-command-line">874<h3 id="authenticate-from-the-command-line">

876 Аутентификация из командной строки875 Аутентификация из командной строки

877</h3>876</h3>

878 877 

879Команда `claude mcp login <name>` запускает поток OAuth настроенного server прямо из вашей оболочки, поэтому вам не нужно открывать панель `/mcp` внутри сеанса.878Команда `claude mcp login <name>` запускает поток OAuth настроенного сервера непосредственно из вашей оболочки, поэтому вам не нужно открывать панель `/mcp` внутри сеанса.

880 879 

881```bash theme={null}880```bash theme={null}

882claude mcp login sentry881claude mcp login sentry

884 883 

885Чтобы позже очистить сохраненные учетные данные, запустите `claude mcp logout <name>`.884Чтобы позже очистить сохраненные учетные данные, запустите `claude mcp logout <name>`.

886 885 

887`claude mcp login` обнаруживает, когда локальный браузер недоступен, например во время сеанса SSH или на Linux без сервера отображения, и выводит URL авторизации вместо попытки открыть браузер. Откройте URL на вашей локальной машине, затем вставьте полный URL перенаправления из адресной строки браузера обратно в приглашение. Команде требуется интерактивный терминал для шага вставки, поэтому подключитесь с помощью `ssh -t`. Передайте `--no-browser` для принудительного приглашения URL даже при обнаружении локального браузера.886`claude mcp login` обнаруживает, когда локальный браузер недоступен, например во время сеанса SSH или на Linux без сервера отображения, и выводит URL авторизации вместо попытки открыть браузер. Откройте URL на вашей локальной машине, затем вставьте полный URL перенаправления из адресной строки браузера обратно в приглашение. Команде требуется интерактивный терминал для шага вставки, поэтому подключитесь с `ssh -t`. Передайте `--no-browser`, чтобы принудительно использовать приглашение URL даже при обнаружении локального браузера.

888 887 

889```bash theme={null}888```bash theme={null}

890claude mcp login sentry --no-browser889claude mcp login sentry --no-browser

894 Используйте фиксированный порт обратного вызова OAuth893 Используйте фиксированный порт обратного вызова OAuth

895</h3>894</h3>

896 895 

897Некоторые MCP servers требуют конкретный URI перенаправления, зарегистрированный заранее. По умолчанию Claude Code выбирает случайный доступный порт для обратного вызова OAuth. Используйте `--callback-port` для фиксации порта, чтобы он соответствовал предварительно зарегистрированному URI перенаправления формы `http://localhost:PORT/callback`. Если вход на Claude Code v2.1.229 не удается с несоответствием URI перенаправления, см. примечание версии в разделе [Используйте предварительно настроенные учетные данные OAuth](#use-pre-configured-oauth-credentials).896Некоторые MCP серверы требуют определенный URI перенаправления, зарегистрированный заранее. По умолчанию Claude Code выбирает случайный доступный порт для обратного вызова OAuth. Используйте `--callback-port`, чтобы зафиксировать порт так, чтобы он соответствовал предварительно зарегистрированному URI перенаправления формы `http://localhost:PORT/callback`. Если вход на Claude Code v2.1.229 не удается с несоответствием URI перенаправления, см. примечание версии в разделе [Используйте предварительно настроенные учетные данные OAuth](#use-pre-configured-oauth-credentials).

898 897 

899Вы можете использовать `--callback-port` самостоятельно (с динамической регистрацией клиента) или вместе с `--client-id` (с предварительно настроенными учетными данными).898Вы можете использовать `--callback-port` самостоятельно (с динамической регистрацией клиента) или вместе с `--client-id` (с предварительно настроенными учетными данными).

900 899 

909 Используйте предварительно настроенные учетные данные OAuth908 Используйте предварительно настроенные учетные данные OAuth

910</h3>909</h3>

911 910 

912Некоторые MCP servers не поддерживают автоматическую настройку OAuth через Dynamic Client Registration. Если вы видите ошибку типа "Incompatible auth server: does not support dynamic client registration", server требует предварительно настроенные учетные данные. Claude Code также поддерживает servers, которые используют Client ID Metadata Document (CIMD) вместо Dynamic Client Registration, и обнаруживает их автоматически. Если автоматическое обнаружение не удается, сначала зарегистрируйте приложение OAuth через портал разработчика server, затем предоставьте учетные данные при добавлении server.911Некоторые MCP серверы не поддерживают автоматическую настройку OAuth через Dynamic Client Registration. Если вы видите ошибку типа "Incompatible auth server: does not support dynamic client registration," сервер требует предварительно настроенные учетные данные. Claude Code также поддерживает серверы, которые используют Client ID Metadata Document (CIMD) вместо Dynamic Client Registration, и обнаруживает их автоматически. Если автоматическое обнаружение не удается, сначала зарегистрируйте приложение OAuth через портал разработчика сервера, затем предоставьте учетные данные при добавлении сервера.

913 912 

914<Steps>913<Steps>

915 <Step title="Зарегистрируйте приложение OAuth с помощью server">914 <Step title="Зарегистрируйте приложение OAuth на сервере">

916 Создайте приложение через портал разработчика server и запишите ваш client ID и client secret.915 Создайте приложение через портал разработчика сервера и запишите ваш ID клиента и секрет клиента.

917 916 

918 Многие servers также требуют URI перенаправления. Если это так, выберите порт и зарегистрируйте URI перенаправления в формате `http://localhost:PORT/callback`. Используйте тот же порт с `--callback-port` на следующем шаге.917 Если форма регистрации запрашивает URI перенаправления, выберите любой доступный порт и введите `http://localhost:PORT/callback` с этим портом. Вы будете использовать тот же порт на следующем шаге.

919 918 

920 В v2.1.229 Claude Code отправлял `http://127.0.0.1:PORT/callback` вместо этого, и servers, которые точно совпадают с зарегистрированным URI перенаправления, отклоняли вход с несоответствием URI перенаправления. Claude Code v2.1.231 восстановил форму `localhost`. Чтобы восстановиться на v2.1.229, обновите Claude Code или временно добавьте форму `http://127.0.0.1:PORT/callback` к зарегистрированным URI перенаправления server.919 В v2.1.229 Claude Code отправлял `http://127.0.0.1:PORT/callback` вместо этого, и серверы, которые точно совпадают с зарегистрированным URI перенаправления, отклоняли вход с несоответствием URI перенаправления. Claude Code v2.1.231 восстановил форму `localhost`. Чтобы восстановиться на v2.1.229, обновите Claude Code или временно добавьте форму `http://127.0.0.1:PORT/callback` к зарегистрированным URI перенаправления сервера.

921 </Step>920 </Step>

922 921 

923 <Step title="Добавьте server с вашими учетными данными">922 <Step title="Добавьте сервер с вашими учетными данными">

924 Выберите один из следующих методов. Порт, используемый для `--callback-port`, может быть любым доступным портом. Он должен соответствовать URI перенаправления, который вы зарегистрировали на предыдущем шаге.923 Вкладки охватывают обе команды: `claude mcp add` принимает ваш ID клиента и порт обратного вызова как флаги, а `claude mcp add-json` принимает их в объекте `oauth`. Если вы зарегистрировали URI перенаправления, установите порт обратного вызова на порт в этом URI.

925 924 

926 <Tabs>925 <Tabs>

927 <Tab title="claude mcp add">926 <Tab title="claude mcp add">

928 Используйте `--client-id` для передачи client ID вашего приложения. Флаг `--client-secret` запрашивает secret с замаскированным вводом:927 Используйте `--client-id` для передачи ID клиента вашего приложения. Флаг `--client-secret` запрашивает секрет с замаскированным вводом:

929 928 

930 ```bash theme={null}929 ```bash theme={null}

931 claude mcp add --transport http \930 claude mcp add --transport http \

945 </Tab>944 </Tab>

946 945 

947 <Tab title="claude mcp add-json (только порт обратного вызова)">946 <Tab title="claude mcp add-json (только порт обратного вызова)">

948 Используйте `--callback-port` без client ID для фиксации порта при использовании динамической регистрации клиента:947 Чтобы зафиксировать только порт обратного вызова и позволить Claude Code зарегистрировать клиента автоматически, установите `callbackPort` самостоятельно:

949 948 

950 ```bash theme={null}949 ```bash theme={null}

951 claude mcp add-json my-server \950 claude mcp add-json my-server \

954 </Tab>953 </Tab>

955 954 

956 <Tab title="CI / переменная окружения">955 <Tab title="CI / переменная окружения">

957 Установите secret через переменную окружения, чтобы пропустить интерактивное приглашение:956 Установите секрет через переменную окружения, чтобы пропустить интерактивное приглашение:

958 957 

959 ```bash theme={null}958 ```bash theme={null}

960 MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \959 MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \

965 </Tabs>964 </Tabs>

966 </Step>965 </Step>

967 966