MCP: сценарии, документация и спецификации API Райффайзен Банка
RaifMCP 0.0.3
# Документация API Портала для ИИ-ассистентов Сервис предоставляет ИИ-ассистентам доступ к материалам, опубликованным на [developer.raif.ru](https://developer.raif.ru/): документации на русском и английском языках, каталогу бизнес-сценариев, публичных API, их операциям и актуальным версиям спецификаций. Сервис работает по протоколу MCP (Model Context Protocol). MCP позволяет подключать внешние источники данных к ИИ-ассистентам: ассистент вызывает доступные инструменты, получает нужный документ или спецификацию и использует их для ответа на вопрос, анализа API или подготовки интеграции. Обычно работа строится так: 1. Получить список бизнес-сценариев, документов или публичных API. 2. Выбрать сценарий, документ, API либо его вариант по содержимому или идентификатору. 3. Получить компактный список операций API и при необходимости отфильтровать его по варианту. 4. Загрузить полное содержимое документа или спецификации, когда требуется полный контракт. Для этих задач сервер предоставляет семь инструментов. ## Инструменты ### `list_public_scenarios` Возвращает полный актуальный каталог бизнес-сценариев в том же порядке, что и на публичном Портале, со всеми полями публичного представления, включая описание для бизнеса и разработчика. Возвращаются только сценарии на языке, заданном необязательным параметром `language` (`ru` по умолчанию или `en`), в том числе помеченные `isDraft`. Если получить весь каталог не удалось, инструмент возвращает ошибку вместо неполного списка. **Когда использовать:** - Нужно узнать, какие задачи бизнеса можно решить с помощью API Банка - Нужно выбрать подходящий сценарий и изучить его шаги и связанные API - Нужно получить актуальный список сценариев на русском или английском языке --- ### `list_public_documentation` Возвращает упорядоченный список доступных документов с метаданными. Необязательный параметр `language` ограничивает результат документами на русском (`ru`) или английском (`en`) языке. **Когда использовать:** - Нужно узнать, какие инструкции и справочные материалы доступны - Нужно получить `documentId` перед вызовом `get_public_documentation` - Нужно отфильтровать документацию по языку --- ### `get_public_documentation` Возвращает метаданные и полное исходное содержимое документа по его `documentId`. **Когда использовать:** - `documentId` уже получен через `list_public_documentation` - Нужен полный текст инструкции, справочного материала или связанного файла --- ### `list_public_apis` Возвращает полный актуальный каталог публичных API со всех страниц API Router. **Когда использовать:** - Нужно узнать, какие публичные API доступны - Нужно получить `apiId` перед поиском вариантов, операций или загрузкой спецификации --- ### `list_public_api_variants` Возвращает актуальные варианты публичного API по его `apiId`. **Когда использовать:** - `apiId` уже получен через `list_public_apis` - Нужно получить `variantCode` перед фильтрацией операций или загрузкой спецификации --- ### `list_public_api_operations` Возвращает полный список операций публичного API по обязательному `apiId`. Необязательный `variantCode` ограничивает результат выбранным вариантом. **Когда использовать:** - `apiId` уже получен через `list_public_apis` - Нужно быстро узнать доступные операции без загрузки полной спецификации - Нужно найти operationId, метод и путь либо отфильтровать операции по `variantCode` --- ### `get_public_api_specification` Возвращает полное актуальное содержимое спецификации выбранного варианта публичного API в исходном формате YAML или JSON. **Когда использовать:** - `apiId` и `variantCode` получены через инструменты каталога - Нужен полный контракт API для анализа, генерации клиента или интеграции
Варианты
- Паблик
Исходный контракт
---
raifmcp: "1.1.0"
info:
title: "MCP: сценарии, документация и спецификации API Райффайзен Банка"
version: "0.0.3"
summary: "Бизнес-сценарии, документация и спецификации API с developer.raif.ru д\
ля ИИ-ассистентов"
description: "# Документация API Портала для ИИ-ассистентов\n\nСервис предоставл\
яет ИИ-ассистентам доступ к материалам, опубликованным на\n[developer.raif.ru](https://developer.raif.ru/):\
\ документации на русском и английском\nязыках, каталогу бизнес-сценариев, пуб\
личных API, их операциям и актуальным\nверсиям спецификаций.\n\nСервис работае\
т по протоколу MCP (Model Context Protocol). MCP позволяет подключать\nвнешние\
\ источники данных к ИИ-ассистентам: ассистент вызывает доступные инструменты\
,\nполучает нужный документ или спецификацию и использует их для ответа на воп\
рос,\nанализа API или подготовки интеграции.\n\nОбычно работа строится так:\n\n\
1. Получить список бизнес-сценариев, документов или публичных API.\n2. Выбрать\
\ сценарий, документ, API либо его вариант по содержимому или идентификатору.\n\
3. Получить компактный список операций API и при необходимости отфильтровать е\
го по варианту.\n4. Загрузить полное содержимое документа или спецификации, ко\
гда требуется полный контракт.\n\nДля этих задач сервер предоставляет семь инс\
трументов.\n\n## Инструменты\n\n### `list_public_scenarios`\n\nВозвращает полн\
ый актуальный каталог бизнес-сценариев в том же порядке, что и на публичном По\
ртале,\nсо всеми полями публичного представления, включая описание для бизнеса\
\ и разработчика.\nВозвращаются только сценарии на языке, заданном необязатель\
ным параметром `language`\n(`ru` по умолчанию или `en`), в том числе помеченны\
е `isDraft`.\nЕсли получить весь каталог не удалось, инструмент возвращает оши\
бку вместо неполного списка.\n\n**Когда использовать:**\n- Нужно узнать, какие\
\ задачи бизнеса можно решить с помощью API Банка\n- Нужно выбрать подходящий\
\ сценарий и изучить его шаги и связанные API\n- Нужно получить актуальный спи\
сок сценариев на русском или английском языке\n\n---\n\n### `list_public_documentation`\n\
\nВозвращает упорядоченный список доступных документов с метаданными. Необязат\
ельный параметр\n`language` ограничивает результат документами на русском (`ru`)\
\ или английском (`en`) языке.\n\n**Когда использовать:**\n- Нужно узнать, как\
ие инструкции и справочные материалы доступны\n- Нужно получить `documentId` п\
еред вызовом `get_public_documentation`\n- Нужно отфильтровать документацию по\
\ языку\n\n---\n\n### `get_public_documentation`\n\nВозвращает метаданные и по\
лное исходное содержимое документа по его `documentId`.\n\n**Когда использоват\
ь:**\n- `documentId` уже получен через `list_public_documentation`\n- Нужен по\
лный текст инструкции, справочного материала или связанного файла\n\n---\n\n###\
\ `list_public_apis`\n\nВозвращает полный актуальный каталог публичных API со\
\ всех страниц API Router.\n\n**Когда использовать:**\n- Нужно узнать, какие п\
убличные API доступны\n- Нужно получить `apiId` перед поиском вариантов, опера\
ций или загрузкой спецификации\n\n---\n\n### `list_public_api_variants`\n\nВоз\
вращает актуальные варианты публичного API по его `apiId`.\n\n**Когда использо\
вать:**\n- `apiId` уже получен через `list_public_apis`\n- Нужно получить `variantCode`\
\ перед фильтрацией операций или загрузкой спецификации\n\n---\n\n### `list_public_api_operations`\n\
\nВозвращает полный список операций публичного API по обязательному `apiId`. Н\
еобязательный\n`variantCode` ограничивает результат выбранным вариантом.\n\n**К\
огда использовать:**\n- `apiId` уже получен через `list_public_apis`\n- Нужно\
\ быстро узнать доступные операции без загрузки полной спецификации\n- Нужно н\
айти operationId, метод и путь либо отфильтровать операции по `variantCode`\n\n\
---\n\n### `get_public_api_specification`\n\nВозвращает полное актуальное соде\
ржимое спецификации выбранного варианта публичного API\nв исходном формате YAML\
\ или JSON.\n\n**Когда использовать:**\n- `apiId` и `variantCode` получены чер\
ез инструменты каталога\n- Нужен полный контракт API для анализа, генерации кл\
иента или интеграции\n"
contact: {}
servers:
- type: "streamable-http"
url: "https://api.raiffeisen.ru/developer-portal/public/mcp"
name: "prod"
description: "Продуктивный MCP-сервер публичной документации и спецификаций API\
\ Портала"