--- title: "Timeweb Cloud MCP для доступа к инфраструктуре в Timeweb Cloud через MCP-интерфейс" description: "Timeweb Cloud MCP для доступа к инфраструктуре в Timeweb Cloud через MCP-интерфейс. Подключение и настройка. Документация и инструкции по работе с облачными сервисами Timeweb Cloud." --- # Timeweb Cloud MCP > Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt). 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-сервера: ```shell https://timeweb.cloud/api/v1/mcp ``` Для авторизации используйте API-токен Timeweb Cloud. Общий пример конфигурации: ```js { "mcpServers": { "timeweb": { "type": "http", "url": "https://timeweb.cloud/api/v1/mcp", "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://timeweb.cloud/api/v1/mcp","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://timeweb.cloud/api/v1/mcp" 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://timeweb.cloud/api/v1/mcp", "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 и подсказать, в чем ошибка.