iiko-mcp

MCP-сервер для отладки запросов к iikoTransport API (api-ru.iiko.services). Транспорт — Streamable HTTP.

Адрес MCP-эндпоинта:

https://iiko-mcp-dev.k6.actonica.ru/mcp

Авторизация. При первом подключении MCP-клиент откроет в браузере страницу, где нужно ввести API-ключ iiko (iikoWeb → Интеграции → API-ключи). Сервер проверит ключ в iiko и выдаст клиенту токен доступа, внутри которого ключ хранится в зашифрованном виде. Сам ключ не попадает ни в конфиг, ни в чат, ни на серверы AI-ассистента. Токен обновляется автоматически, ключ вводится один раз.

Cursor

Добавь в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json (в проекте):

{
  "mcpServers": {
    "iiko": {
      "url": "https://iiko-mcp-dev.k6.actonica.ru/mcp"
    }
  }
}

Затем Cursor Settings → MCP → у сервера iiko нажми Connect и введи ключ в открывшемся окне.

Claude Code

Одной командой, для всех проектов:

claude mcp add --transport http --scope user iiko https://iiko-mcp-dev.k6.actonica.ru/mcp

Или для одного проекта — файл .mcp.json в корне репозитория:

{
  "mcpServers": {
    "iiko": {
      "type": "http",
      "url": "https://iiko-mcp-dev.k6.actonica.ru/mcp"
    }
  }
}

Затем в сессии claude выполни /mcp → iiko → Authenticate.

Claude Desktop

Через коннектор (рекомендуется)

Settings → Connectors → Add custom connector, URL:

https://iiko-mcp-dev.k6.actonica.ru/mcp

После добавления нажми Connect. Коннектор подключается со стороны Anthropic, поэтому сервер должен быть доступен из интернета.

Через локальный мост mcp-remote

Добавь в claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) и перезапусти Claude Desktop — mcp-remote сам откроет страницу авторизации:

{
  "mcpServers": {
    "iiko": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://iiko-mcp-dev.k6.actonica.ru/mcp"
      ]
    }
  }
}

Codex (CLI, IDE-расширение, приложение)

Одной командой:

codex mcp add iiko --url https://iiko-mcp-dev.k6.actonica.ru/mcp

Или вручную в ~/.codex/config.toml:

[mcp_servers.iiko]
url = "https://iiko-mcp-dev.k6.actonica.ru/mcp"

Если браузер не открылся автоматически, авторизуйся командой:

codex mcp login iiko

Проверка: codex mcp list. Конфиг общий для CLI, расширения и приложения Codex.

VS Code (Copilot)

Файл .vscode/mcp.json в проекте:

{
  "servers": {
    "iiko": {
      "type": "http",
      "url": "https://iiko-mcp-dev.k6.actonica.ru/mcp"
    }
  }
}

При запуске сервера VS Code предложит пройти авторизацию.

Другие клиенты

Подойдёт любой клиент с поддержкой Streamable HTTP и авторизации MCP (OAuth 2.1 с динамической регистрацией клиента и PKCE): укажи адрес https://iiko-mcp-dev.k6.actonica.ru/mcp. Сервер stateless: принимает только POST, сессий и SSE-потока по GET нет.

Инструменты

Инструмент	Назначение
`iiko_request`	Любой метод + путь + тело с авто-авторизацией → статус, correlationId, тело
`iiko_access_token`	Получить/обновить токен (для отладки авторизации)
`iiko_organizations`	POST /api/1/organizations
`iiko_nomenclature`	POST /api/1/nomenclature
`iiko_stop_lists`	POST /api/1/stop_lists
`iiko_payment_types`	POST /api/1/payment_types
`iiko_deliveries_by_id`	POST /api/1/deliveries/by_id

Все инструменты работают от имени точки, ключ которой введён при авторизации. Документация iiko API: api-ru.iiko.services/docs.