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

# Avala с AI

> Подключите Avala к Claude, Cursor, VS Code и ChatGPT через MCP

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) — это открытый стандарт, позволяющий AI-ассистентам вызывать внешние инструменты и обращаться к источникам данных. MCP-сервер Avala предоставляет ваши наборы данных, проекты и экспорты как инструменты, чтобы вы могли управлять рабочим процессом аннотации на естественном языке в Claude, Cursor, VS Code или ChatGPT.

## Быстрая настройка

Установите MCP-сервер с любым совместимым AI-клиентом. Вам понадобится **Node.js 18+** и [API-ключ Avala](/docs/api-reference/authentication).

Для Claude Desktop добавьте в файл конфигурации (`~/Library/Application Support/Claude/claude_desktop_config.json` на macOS):

<Warning>
  Никогда не сохраняйте конфигурационные файлы с настоящими API-ключами в системе контроля версий. Установите `AVALA_API_KEY` как системную переменную окружения или замените `"your-api-key"` на ваш реальный ключ локально.
</Warning>

```json theme={null}
{
  "mcpServers": {
    "avala": {
      "command": "npx",
      "args": ["-y", "@avala-ai/mcp-server"],
      "env": {
        "AVALA_API_KEY": "your-api-key"
      }
    }
  }
}
```

Перезапустите Claude Desktop. Инструменты Avala появятся в списке инструментов.

<Info>
  MCP по умолчанию работает в режиме только для чтения. Чтобы включить инструменты записи/удаления, установите `AVALA_MCP_ENABLE_MUTATIONS=true` перед запуском MCP-сервера.
</Info>

## Что можно делать

После подключения вы можете просить AI-ассистента взаимодействовать с Avala на естественном языке:

```
Покажи все мои наборы данных
```

```
Покажи статус проекта "Pedestrian Detection"
```

```
Сколько задач завершено в "Lidar QA"?
```

```
Покажи задания экспорта для набора данных ds_abc123
```

```
Покажи статистику моего рабочего пространства
```

Ассистент вызывает соответствующий инструмент Avala MCP, обрабатывает ответ и представляет результаты. Вы можете объединять несколько запросов в одном диалоге — например, показать список наборов данных, выбрать один и запустить экспорт.

## Полное руководство по настройке

Для VS Code, ChatGPT и полного списка доступных инструментов MCP см. полное [руководство по настройке MCP-сервера](/docs/integrations/mcp-setup).

<CardGroup cols={2}>
  <Card title="Настройка MCP-сервера" icon="plug" href="/docs/integrations/mcp-setup">
    Полные инструкции по установке для всех поддерживаемых AI-клиентов и справочник по инструментам.
  </Card>

  <Card title="Аутентификация API" icon="key" href="/docs/api-reference/authentication">
    Создание и управление API-ключами, используемыми MCP-сервером.
  </Card>
</CardGroup>