# Интеграция с AI

Vilna предоставляет [MCP](https://modelcontextprotocol.io/)-сервер (Model Context Protocol), который даёт AI-ассистентам прямой доступ к актуальному справочнику API, деталям эндпоинтов и поиску по документации. Вместо переключения между редактором и браузером ради пути или параметра ассистент запрашивает текущую спецификацию напрямую.

Один эндпоинт для всех клиентов
6 инструментов
Доступ к справочнику API
Встроенный поиск по документации

## Подключите свой AI-инструмент 

Любой MCP-клиент с транспортом Streamable HTTP подключается по одному URL:

URL MCP-сервера

https://docs.vilna.io/mcp

Выберите клиента для точной настройки:

Claude Code

Одна команда CLI

Добавьте сервер одной командой, затем введите `/mcp` в CLI для проверки - Claude Code покажет доступные инструменты с параметрами.

```bash
claude mcp add --transport http vilna-docs https://docs.vilna.io/mcp
```

Cursor

Настройки mcp.json

Откройте палитру команд, выполните «Open MCP settings» и добавьте свой сервер в `mcp.json`:

```json
{
  "mcpServers": {
    "vilna-docs": { "url": "https://docs.vilna.io/mcp" }
  }
}
```

Сохраните и подтвердите подключение в настройках MCP.

VS Code

Палитра команд

Откройте палитру команд (`Cmd+Shift+P` / `Ctrl+Shift+P`), выполните **MCP: Add Server** и выберите **HTTP**.

Укажите URL `https://docs.vilna.io/mcp` и имя `vilna-docs`.

Откройте чат в режиме **Agent** и нажмите иконку Tools для проверки.

Claude Desktop

Удалённый connector

Откройте **Settings → Connectors**, выберите **Add custom connector** и укажите `https://docs.vilna.io/mcp`. Подключите его и разрешите использование в нужном разговоре. Доступность настройки может зависеть от правил вашей организации; актуальные шаги описаны в [инструкции Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

Другие инструменты

Streamable HTTP

Любой клиент с поддержкой транспорта MCP Streamable HTTP может зарегистрировать `https://docs.vilna.io/mcp` как HTTP-сервер. API-ключ не нужен.

## Доступные инструменты 

После подключения у ассистента шесть инструментов - пять для обзора API и один для поиска:

| Инструмент | Параметры | Описание |
|  --- | --- | --- |
| `list-apis` | `filter?` | Список доступных API (Platform, Management) с описаниями |
| `get-endpoints` | `name` | Все эндпоинты API с описаниями |
| `get-endpoint-info` | `name`, `path`, `method` | Полные детали эндпоинта - параметры, тело, ответы, примеры |
| `get-security-schemes` | `name` | Требования к аутентификации API |
| `get-full-api-description` | `name` | Полная спецификация OpenAPI |
| `search` | `query` | Поиск по всей документации |


## Как это выглядит на практике 

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

## Область доступа 

MCP-сервер предоставляет публичную документацию. Он не даёт доступа к данным вашей учётной записи и не выполняет операции с ними.