# Timeweb Cloud MCP — полный текст документации

> Полный текст раздела «Timeweb Cloud MCP» документации Timeweb Cloud в markdown. Каждая статья начинается с заголовка первого уровня и ссылки на свою каноническую страницу.

Индекс: https://timeweb.cloud/docs/timeweb-cloud-mcp/llms.txt
Статей: 1
Последнее обновление: 2026-10-22

# Timeweb Cloud MCP

Source: https://timeweb.cloud/docs/timeweb-cloud-mcp

MCP — это протокол, который позволяет AI-агентам работать с внешними инструментами и сервисами. Timeweb Cloud MCP дает агентам доступ к инфраструктуре в Timeweb Cloud через MCP-интерфейс: агент может получать данные, выполнять действия с ресурсами и использовать эти возможности в продуктах и агентских сценариях.

## Ограничения

При работе с Timeweb Cloud MCP учитывайте, что:

-   методы удаления ресурсов не поддерживаются;
-   мутирующие методы требуют подтверждения перед выполнением;
-   перед выполнением действия агент уточнит в чате, действительно ли вы хотите его совершить.

## Подключение

Для подключения Timeweb Cloud MCP нужен [API-токен Timeweb Cloud](https://timeweb.cloud/docs/account-management/token). Получить его можно во вкладке «[API и Terraform](https://timeweb.cloud/my/api-keys)».

Ограничения прав, заданные для токена, отразятся и на работе MCP. Если агент не должен иметь доступ к какому-либо разделу, ограничьте доступ в настройках токена.

Вы можете подключить Timeweb Cloud MCP к AI-агентам Timeweb Cloud или к сторонним агентам с поддержкой MCP.

## Подключение к AI-агентам Timeweb Cloud

Чтобы подключить Timeweb Cloud MCP к AI-агенту:

1.  Перейдите во вкладку «MCP-серверы» в разделе «ИИ-сервисы».
    
2.  Выберите «Timeweb Cloud MCP».
    

![Scr 20260603 Pxhr](https://content.timeweb.com/assets/5cda5af3-ef75-4c1c-b9b8-90a20b9eea3a.png?width=2196&height=1652)

3.  В открывшемся окне укажите полученный ранее токен в поле «API-токен».
    
4.  Нажмите «Установить».
    

После подключения MCP-сервер будет доступен при работе с агентом в чате и через API. При работе через AI Gateway MCP-сервер доступен не будет.

## Подключение к сторонним агентам

Timeweb Cloud MCP можно подключить к сторонним агентам с поддержкой удаленных MCP-серверов.

URL MCP-сервера:

```
https://api.timeweb.cloud/api/v1/mcp/search
```

Для авторизации используйте API-токен Timeweb Cloud.

Общий пример конфигурации:

```js
{
  "mcpServers": {
    "timewebCloud": {
      "type": "http",
      "url": "https://api.timeweb.cloud/api/v1/mcp/search",
      "headers": {
        "Authorization": "Bearer TIMEWEB_CLOUD_TOKEN"
      }
    }
  }
}
```

### Добавление токена в переменные окружения

Чтобы не указывать токен в каждом конфигурационном файле вручную, добавьте его в переменную окружения `TIMEWEB_CLOUD_TOKEN`.

Замените `ваш_токен` на API-токен, полученный ранее.

macOS

Откройте терминал и выполните команды:

```shell
launchctl setenv TIMEWEB_CLOUD_TOKEN "ваш_токен"
```

Windows

Откройте PowerShell и выполните команду:

```shell
[Environment]::SetEnvironmentVariable(
   "TIMEWEB_CLOUD_TOKEN",
   "ваш_токен",
   "User"
)
```

После этого закройте PowerShell и откройте его заново.

Linux

Откройте терминал и выполните команды:

```shell
echo 'export TIMEWEB_CLOUD_TOKEN="ваш_токен"' >> ~/.bashrc
source ~/.bashrc
```

### Настройка Claude Code

Для настройки MCP нужна консольная версия Claude Code. Это не то же самое, что десктопное приложение Claude Code или Cowork: они могут быть установлены, но команда `claude` при этом может отсутствовать.

Чтобы проверить установку, откройте терминал или PowerShell и выполните команду:

```shell
claude --version
```

Если команда выводит номер версии, переходите к подключению MCP-сервера.

Если терминал пишет, что команда не найдена, установите Claude Code CLI.

#### Установка Claude Code CLI

macOS

Выполните команду:

```shell
curl -fsSL https://claude.ai/install.sh | bash
```

Windows

Откройте PowerShell и выполните команду:

```shell
irm https://claude.ai/install.ps1 | iex
```

После установки закройте терминал, откройте его заново и снова проверьте:

```shell
claude --version
```

Если установщик сообщит, что каталог `.local\bin` не добавлен в `PATH`, добавьте его командой:

```shell
setx PATH "$($env:PATH);C:\Users\$env:USERNAME\.local\bin"
```

Затем закройте PowerShell, откройте его заново и повторите проверку.

#### Подключение MCP-сервера

Добавьте Timeweb Cloud MCP:

```shell
claude mcp add-json timewebCloud '{"type":"http","url":"https://api.timeweb.cloud/api/v1/mcp/search","headers":{"Authorization":"Bearer ${TIMEWEB_CLOUD_TOKEN}"}}'
```

Проверьте, что сервер добавлен:

```shell
claude mcp list
```

Внутри Claude Code можно проверить состояние MCP-серверов командой:

```shell
/mcp
```

### Настройка Codex

Codex хранит настройки MCP в файле `~/.codex/config.toml`.

Откройте или создайте этот файл и добавьте конфигурацию:

```shell
[mcp_servers.timewebCloud]
url = "https://api.timeweb.cloud/api/v1/mcp/search"
bearer_token_env_var = "TIMEWEB_CLOUD_TOKEN"
```

Проверить подключение можно через настройки. Нажмите «Настройки» → «Настройки» → «Серверы MCP» — в списке должно появиться новое подключение timewebCloud.

### Настройка Cursor

Cursor читает настройки MCP из файла `mcp.json`.

Для глобального подключения создайте или откройте файл:

```shell
~/.cursor/mcp.json
```

Для подключения только в рамках одного проекта создайте файл:

```shell
.cursor/mcp.json
```

Добавьте конфигурацию:

```shell
{
 "mcpServers": {
   "timewebCloud": {
     "url": "https://api.timeweb.cloud/api/v1/mcp/search",
     "headers": {
       "Authorization": "Bearer ${env:TIMEWEB_CLOUD_TOKEN}"
     }
   }
 }
}
```

Перезапустите Cursor. После этого агент Cursor сможет использовать инструменты Timeweb Cloud MCP, если они подходят для запроса пользователя.

Проверить подключение можно в настройках MCP:

1.  Нажмите `Ctrl + Shift + P`.
    
2.  Выполните команду MCP: Open MCP Settings.
    
3.  Найдите сервер `timewebCloud` в списке.
    
4.  Проверьте его статус:
    

-   -   `Connected` — сервер подключен;
        
    -   `Connecting` — идет подключение;
        
    -   `Error` или `Disconnected` — есть проблема с подключением.
        

## Проверка подключения

После подключения MCP-сервера проверьте, подключается ли он корректно. В чате с агентом попросите перечислить список доступных инструментов:

```shell
Какие инструменты MCP тебе доступны для работы с Timeweb Cloud? Перечисли все инструменты.
```

При корректном подключении агент выведет список инструментов Timeweb Cloud MCP.

![Scr 20260603 Qcqn](https://content.timeweb.com/assets/8d33c61d-59af-4c0d-8918-0f03fdc5d2f3.png?width=1932&height=1778)

Если что-то не работает, попросите агента проверить настройки MCP и подсказать, в чем ошибка.