> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tenderly.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Быстрый старт MCP Server

> Подключите Tenderly MCP Server к Claude Code, Claude.ai, Claude Desktop и другим MCP-клиентам.

Запустите Tenderly MCP Server в своём AI-ассистенте менее чем за минуту.

## Предварительные требования

* [Аккаунт Tenderly](https://dashboard.tenderly.co/register)
* Хотя бы один проект Tenderly

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

<Tabs>
  <Tab title="Shell">
    Выполните следующую команду в терминале:

    ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
    claude mcp add tenderly --transport http https://mcp.tenderly.co/mcp
    ```

    Проверьте, что сервер подключён:

    ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
    claude mcp list
    ```

    Запустите `/mcp` внутри Claude Code, выберите **tenderly** и пройдите вход в браузере для аутентификации.
  </Tab>

  <Tab title="1. Open [claude.ai](https://claude.ai) a">
    1. Откройте [claude.ai](https://claude.ai) и перейдите в **Settings → Connectors**.
    2. Нажмите **Add custom connector** внизу.
    3. Введите URL: `https://mcp.tenderly.co/mcp`
    4. Нажмите **Add** и завершите OAuth-вход.

    После подключения инструменты Tenderly станут доступны в любом диалоге.

    > **Примечание:** пользовательские коннекторы требуют плана Claude Pro или выше. На тарифах Enterprise добавлять коннекторы могут только администраторы workspace.
  </Tab>

  <Tab title="1. Open Claude Desktop and go to Setting">
    1. Откройте Claude Desktop и перейдите в **Settings → Connectors**.
    2. Нажмите **Add custom connector**.
    3. Введите URL: `https://mcp.tenderly.co/mcp`
    4. Нажмите **Add** и завершите OAuth-вход.

    > **Примечание:** пользовательские коннекторы требуют плана Claude Pro или выше. На тарифах Enterprise добавлять коннекторы могут только администраторы workspace.
  </Tab>

  <Tab title="JSON">
    Добавьте следующее в свой файл конфигурации MCP (`.cursor/mcp.json`, `.vscode/mcp.json` или аналогичный):

    ```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
    {
      "mcpServers": {
        "tenderly": {
          "type": "streamable-http",
          "url": "https://mcp.tenderly.co/mcp"
        }
      }
    }
    ```

    Ваш редактор предложит пройти аутентификацию при первом использовании инструмента Tenderly.
  </Tab>
</Tabs>

## Первый вызов инструмента

После подключения попробуйте простой запрос, чтобы убедиться, что всё работает:

> "Как называется мой аккаунт и какой проект сейчас активен?"

Claude вызовет `get_user_info` и вернёт информацию о вашем аккаунте и текущем активном проекте (если он задан). Если это сработало — всё готово.

## Установка активного проекта

Большинству инструментов нужен контекст проекта. Установите его один раз за сессию:

> "Установи активным проект my-project под my-account"

Claude вызовет `set_active_project`. Все последующие вызовы инструментов (симуляции, Virtual Environments, трассы) будут использовать этот проект.

<Note>
  Вы также можете позволить Claude определить проект автоматически — просто попросите его что-то сделать, и при необходимости он сначала вызовет `list_projects`.
</Note>

## Устранение неполадок

### Аутентификация не проходит или коннектор не входит

Если OAuth-вход зацикливается или выдаёт ошибку, отключите коннектор Tenderly в клиенте Claude (Settings → Connectors) и добавьте его заново. В Claude Code запустите `/mcp`, выберите **tenderly** и повторите вход в браузере. Пользовательские коннекторы в Claude.ai и Claude Desktop требуют плана Pro или выше; на тарифах Enterprise добавлять их могут только администраторы workspace.

### Ошибки "No active project"

Большинству инструментов нужен контекст проекта. Попросите Claude установить его:

> "Установи активным проект my-project под my-account"

Или дайте Claude выбрать проект автоматически, попросив сначала перечислить проекты.

### Ошибки "No active Virtual Environment"

Инструменты Virtual Environment работают с активным Virtual Environment. Либо создайте/форкните Virtual Environment (это автоматически активирует его), либо попросите Claude вызвать `set_active_vnet` с существующим ID Virtual Environment.

### Трасса вызовов или события усечены

`get_simulation_call_trace` ограничен 256 записями, а `get_simulation_events` — 100. Для больших транзакций используйте инструменты [продвинутой навигации по трассе](/ai-tools/tools#advanced-trace-navigation): начните с `get_trace_stats` для оценки размера, затем `get_trace_skeleton`, чтобы увидеть структуру дерева, и `get_call_trace_node`, `get_subtree_events` или `search_call_trace`, чтобы углубиться в нужные части. Для revert'ов быстрее всего добраться до корневой причины с помощью `find_failures` и `get_error_path`.

### Claude выбирает не ту сеть, проект или Virtual Environment

Указывайте это явно в запросе — назовите сеть, слаг проекта или Virtual Environment. Также можно попросить Claude подтвердить активный контекст через `get_user_info` до запуска задачи.

### Вызов инструмента возвращает устаревшие или неверные данные

Активный проект и состояние Virtual Environment хранятся в рамках сессии. Если вы переключились между проектами или Virtual Environment по ходу диалога, подтвердите активный контекст через `get_user_info` перед запуском следующих инструментов.

## Дальнейшие шаги

* [Tools Reference](/ai-tools/tools): все 59 инструментов и что они делают
* [Examples](/ai-tools/examples): пошаговые сценарии для типичных задач
* [Virtual Environments](/virtual-environments/overview): подробнее о средах, которые вы можете создавать
* [Simulations](/simulations/overview): как работает симуляция транзакций