Перейти к содержимому
Последнее обновление

MCP-сервер

Документация Vilna предоставляет Model Context Protocol (MCP) сервер, который даёт AI-ассистентам прямой доступ к справочнику API, деталям эндпоинтов и поиску по документации.

Вместо переключения между IDE и браузером для поиска путей эндпоинтов или названий параметров, ваш AI-ассистент может обращаться к живой спецификации API и самостоятельно генерировать корректный код интеграции.

Подключите ваш инструмент

MCP-сервер доступен по адресу:

https://docs.vilna.io/mcp

Claude Code

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

После добавления введите /mcp в CLI Claude Code для проверки подключения. Claude Code покажет список доступных инструментов с описаниями и параметрами.

Cursor

  1. Откройте палитру команд (Cmd+Shift+P на macOS, Ctrl+Shift+P на Windows/Linux).
  2. Введите "Open MCP settings" и выберите "Add custom MCP".
  3. Добавьте в mcp.json:
{
  "mcpServers": {
    "vilna-docs": {
      "url": "https://docs.vilna.io/mcp"
    }
  }
}
  1. Сохраните и подтвердите подключение в настройках MCP.

VS Code

  1. Откройте палитру команд (Cmd+Shift+P на macOS, Ctrl+Shift+P на Windows/Linux).
  2. Введите "MCP: Add Server" и выберите "HTTP".
  3. Введите URL: https://docs.vilna.io/mcp
  4. Введите имя: vilna-docs

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

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "vilna-docs": {
      "type": "url",
      "url": "https://docs.vilna.io/mcp"
    }
  }
}

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

Любой MCP-клиент с поддержкой Streamable HTTP transport может подключиться к https://docs.vilna.io/mcp.

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

После подключения AI-ассистент получает доступ к следующим инструментам:

Обнаружение API

ИнструментПараметрыОписание
list-apisfilter?Список доступных API (Platform API, Management API) с описаниями
get-endpointsnameВсе эндпоинты конкретного API с описаниями
get-endpoint-infoname, path, methodПолная информация об эндпоинте - параметры, тело запроса, ответы, примеры
get-security-schemesnameТребования аутентификации для API
get-full-api-descriptionnameПолная спецификация OpenAPI

Поиск по документации

ИнструментПараметрыОписание
searchqueryПоиск по всей документации с возвратом релевантного контента

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

С подключённым MCP-сервером можно спрашивать AI-ассистента:

  • "Как зарегистрировать блокчейн-адрес для мониторинга через Vilna API?"
  • "Какие параметры принимает эндпоинт создания счёта?"
  • "Покажи формат вебхук-payload для событий депозита"
  • "Какие заголовки аутентификации нужны для Platform API?"
  • "Сгенерируй TypeScript-функцию для запроса балансов Ethereum-адреса"

Ассистент обращается к MCP-серверу Vilna, получает актуальную спецификацию API и даёт точный ответ с правильными путями эндпоинтов, параметрами и схемами ответов - без выхода из редактора.

Зачем использовать MCP-сервер

Быстрее интеграция. AI-ассистент знает весь API - каждый эндпоинт, параметр и схему ответа. Не нужно читать страницы документации вручную.

Всегда актуально. MCP-сервер читает из живой спецификации API. Когда эндпоинты меняются, ассистент получает обновлённую информацию сразу.

Меньше ошибок. Вместо угадывания названий параметров или форматов ответов ассистент работает с реальной OpenAPI-спецификацией и генерирует корректный код с первой попытки.

Работает с вашими инструментами. Claude Code, Cursor, VS Code, Claude Desktop - настройка занимает одну команду или небольшое изменение конфига.

Следующие шаги