x-openapi-flow-mcp — MCP-сервер для Claude Code
MCP-сервер, который отдаёт ИИ-агенту готовый контракт потоков API: порядок вызовов, правила решений и ссылки на поля. Пригодится, когда интеграцию собирает агент, а не человек.
claude mcp add x-openapi-flow-mcp -- npx -y x-openapi-flowЧто делает x-openapi-flow-mcp
Сервер работает поверх x-openapi-flow — расширения спецификации OpenAPI, которое описывает жизненный цикл ресурсов как конечный автомат прямо в операциях. Вместо императивного кода вы объявляете переходы в openapi.x.json: текущее состояние, условие, правило решения, целевое состояние, следующий operationId и пути отказа. Агент через MCP получает эту схему как плотный контракт без прозы — команда export-llm-flows умеет выгружать его же, но здесь она вызывается как инструмент.
Установка идёт через npx, поэтому нужен Node.js версии 18 или выше. Сам пакет ставится командой claude mcp add x-openapi-flow-mcp -- npx -y x-openapi-flow; в Cursor и GitHub Copilot сервер прописывается в конфиг как stdio-запуск npx -y x-openapi-flow. Без Node.js в PATH сервер не поднимется.
Полезен там, где шаги API легко перепутать: оплата до создания заказа, отгрузка до подтверждения. Агент видит, какие операции обязательны перед вызовом, и не выдумывает порядок сам.
Какие задачи решает
- собрать контракт потоков API для агента без пересказа документации
- запретить вызов операции до выполнения обязательной предыдущей
- описать переходы состояний заказа прямо в спецификации OpenAPI
- выгрузить порядок вызовов и правила решений для кодового агента
- проверять корректность жизненного цикла API в CI
Примеры запросов агенту
- Покажи контракт потоков для операции
createOrderи порядок вызовов - Какие операции обязательны перед вызовом
payOrder? - Выгрузи правила решений и ссылки на поля для интеграции оплаты заказа
Как установить x-openapi-flow-mcp
Командой платформы
claude mcp add x-openapi-flow-mcp -- npx -y x-openapi-flowКомандой платформы
codex mcp add x-openapi-flow -- npx -y x-openapi-flowФайл настроек
{
"mcpServers": {
"x-openapi-flow": {
"command": "npx",
"args": [
"-y",
"x-openapi-flow"
]
}
}
}Файл настроек
{
"servers": {
"x-openapi-flow": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"x-openapi-flow"
]
}
}
}Командой платформы
gemini mcp add x-openapi-flow npx -y x-openapi-flowПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о x-openapi-flow-mcp
Как установить x-openapi-flow-mcp в Claude Code?
Выполните claude mcp add x-openapi-flow-mcp -- npx -y x-openapi-flow. Нужен Node.js 18 или выше.
Что делает x-openapi-flow-mcp?
Отдаёт агенту контракт потоков API: порядок вызовов, правила решений и ссылки на поля, выведенные из openapi.x.json. Агенту не приходится выводить их из человеческой документации.
Что нужно для работы сервера?
Node.js версии 18 или выше: сервер запускается через npx -y x-openapi-flow. В Cursor и GitHub Copilot он прописывается как stdio-сервер с той же командой.
