mcp-iva-mcu
Servidor MCP para IVA MCU
42 herramientas · 391 acciones REST · 368 endpoints de API · 17 canales WebSocket
Servidor MCP para la plataforma de videoconferencias IVA MCU. Envuelve Clients API (v2.28.12), Integration API (v1.28.12) y Bot API (v1.28.12) en 42 herramientas que su agente de IA puede invocar directamente.
Instalación · Configuración · Herramientas · Uso · Desarrollo
Idiomas: Inglés · Русский
Versiones de API compatibles
API | Versión | Ruta base | Autenticación | Endpoints |
IVA Clients API | 2.28.12 |
| Cabecera | 310 |
IVA System Integration API | 1.28.12 |
| Token Bearer | 54 |
IVA Chat Bot API | 1.28.12 |
| Cabecera | 4 |
Las especificaciones OpenAPI para estas versiones exactas se encuentran en specs/ (solo en el repositorio fuente).
Related MCP server: Pipecat MCP Server
Instalación
Requisitos previos
Node.js 18+
URL del servidor IVA MCU (p. ej.,
https://your-iva-server.ru)Al menos un token de autenticación (consulte Variables de entorno)
Variables de entorno
Variable | Requerida | Descripción |
| Sí | URL del servidor IVA MCU |
| Clients API | UUID de sesión |
| Clients API | Token JWT (alternativa a la sesión) |
| Integration API | Token Bearer |
| Bot API | Token de Bot API |
Configure al menos un token por cada API que desee utilizar.
Configuración del cliente MCP
Claude Desktop
Añada a claude_desktop_config.json:
npx (recomendado):
{
"mcpServers": {
"iva-mcu": {
"command": "npx",
"args": ["-y", "mcp-iva-mcu"],
"env": {
"IVA_BASE_URL": "https://your-iva-server.ru",
"IVA_SESSION_TOKEN": "your-session-uuid",
"IVA_INTEGRATION_TOKEN": "your-integration-token",
"IVA_BOT_TOKEN": "your-bot-token"
}
}
}
}Windows — use cmd /c:
{
"mcpServers": {
"iva-mcu": {
"command": "cmd",
"args": ["/c", "npx", "-y", "mcp-iva-mcu"],
"env": {
"IVA_BASE_URL": "https://your-iva-server.ru",
"IVA_SESSION_TOKEN": "your-session-uuid",
"IVA_INTEGRATION_TOKEN": "your-integration-token",
"IVA_BOT_TOKEN": "your-bot-token"
}
}
}
}Docker:
docker build -t mcp/iva-mcu .{
"mcpServers": {
"iva-mcu": {
"command": "docker",
"args": ["run", "--rm", "-i", "mcp/iva-mcu"],
"env": {
"IVA_BASE_URL": "https://your-iva-server.ru",
"IVA_SESSION_TOKEN": "your-session-uuid",
"IVA_INTEGRATION_TOKEN": "your-integration-token",
"IVA_BOT_TOKEN": "your-bot-token"
}
}
}
}Cursor
Añada a .cursor/mcp.json:
{
"mcpServers": {
"iva-mcu": {
"command": "npx",
"args": ["-y", "mcp-iva-mcu"],
"env": {
"IVA_BASE_URL": "https://your-iva-server.ru",
"IVA_SESSION_TOKEN": "your-session-uuid"
}
}
}
}VS Code
Añada a .vscode/mcp.json:
{
"servers": {
"iva-mcu": {
"command": "npx",
"args": ["-y", "mcp-iva-mcu"],
"env": {
"IVA_BASE_URL": "https://your-iva-server.ru",
"IVA_SESSION_TOKEN": "your-session-uuid"
}
}
}
}Codex CLI
codex mcp add iva-mcu npx -y mcp-iva-mcuDesde el código fuente
git clone https://github.com/kostikpenzin/mcp_iva_mcu.git
cd mcp_iva_mcu
npm install
npm run build{
"mcpServers": {
"iva-mcu": {
"command": "node",
"args": ["/absolute/path/to/mcp_iva_mcu/dist/index.js"],
"env": {
"IVA_BASE_URL": "https://your-iva-server.ru",
"IVA_SESSION_TOKEN": "your-session-uuid"
}
}
}
}Resumen de herramientas
Clients API — 28 herramientas, 315 acciones
Herramienta | Descripción | Acciones |
| Inicio de sesión, cierre de sesión, 2FA, gestión de sesiones | 10 |
| Perfil, desvío de llamadas, contraseña, disco, suscripciones | 19 |
| Contactos, invitaciones, presencias, etiquetas | 12 |
| Buscar interlocutores, suscripción de presencia | 7 |
| Registrar/anular el registro de dispositivos | 2 |
| Convertir, eliminar, listar páginas | 4 |
| Crear, subir, descargar, estado de escaneo | 5 |
| Información del sistema, medios, servidores ICE, diseños | 10 |
| CRUD de chat, búsqueda, reenvío, notificaciones | 13 |
| Añadir, eliminar, actualizar participantes | 3 |
| Enviar, editar, eliminar, destacar, adjuntos | 14 |
| Unirse/salir/retener, grabar, compartir pantalla, transferir, DTMF | 16 |
| CRUD de conferencias, programación, salas, invitaciones | 12 |
| Ciclo de vida de la sesión, grabación, transcripción, medios | 35 |
| Crear/activar/desactivar/mover/eliminar grupos | 7 |
| Información de medios, diseño, perfil, idioma, atención | 12 |
| Añadir/eliminar/silenciar/mano/reacción/DTMF/llamada de retorno | 23 |
| Unirse/salir, aprobar/rechazar | 7 |
| Documentos, directorios, control de demostración | 19 |
| Encuestas: CRUD, respuestas, iniciar/detener, exportar | 16 |
| Chat de conferencia: enviar/editar/moderar/exportar | 10 |
| Obtener cuestionario, guardar respuestas | 2 |
| Iniciar/detener/confirmar control de presencia | 3 |
| Registrarse, comprobar/reenviar correo electrónico | 3 |
| Estadísticas, exportaciones, agregación (v1 + v2) | 17 |
| CRUD de plantillas, establecer predeterminada | 6 |
| Libros, páginas, demostración, exportar, deshacer | 21 |
| Compartición de pantalla Web/VNC, control remoto | 7 |
Integration API — 11 herramientas, 72 acciones
Herramienta | Descripción | Acciones |
| CRUD de usuarios, bloquear/desbloquear, llamadas de pago, inicio de sesión | 12 |
| CRUD de empresas, bloquear/desbloquear, disco, llamadas de pago | 11 |
| CRUD de grupos, subgrupos, gestión de usuarios | 8 |
| CRUD de conferencias, participantes, plantillas | 7 |
| CRUD de sesiones, salas, participantes, documentos | 11 |
| CRUD de chats, participantes, llamadas, documentos | 11 |
| Archivos de disco, eliminar documentos | 3 |
| Obtener información del dominio | 2 |
| CRUD de suscripciones | 5 |
| Obtener información del perfil | 1 |
| Descargar archivo | 1 |
Bot API — 2 herramientas, 4 acciones
Herramienta | Descripción | Acciones |
| Enviar mensaje, crear/subir/descargar archivos | 4 |
| Recopilar eventos de chat mediante WebSocket | — |
Eventos — 1 herramienta, 17 canales WebSocket
Herramienta | Descripción |
| Recopilar eventos de canales WebSocket (chat, conferencia, conferencia activa, contacto, grupo, perfil, sistema) |
Ejemplos de uso
Cada herramienta utiliza un parámetro action (enumeración de cadenas) para seleccionar la operación.
Crear una conferencia:
Tool: iva_conference
Arguments:
action: "create"
conferenceData: { "name": "Team Meeting", "type": "PERIODICAL" }Enviar un mensaje de chat:
Tool: iva_chat_messages
Arguments:
action: "send"
chatRoomId: "abc-123-def-456"
messageData: { "text": "Hello everyone!" }Recopilar eventos:
Tool: iva_events
Arguments:
event_type: "chat"
duration: 15Desarrollo
npm install # Install dependencies
npm run build # Compile TypeScript + chmod +x
npm run dev # Watch mode
npm start # Run server
docker build -t mcp/iva-mcu . # Docker image
npm publish # Publish to npm (auto clean + build)Estructura del proyecto
mcp_iva_mcu/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── config.ts # Environment configuration
│ ├── api-client.ts # HTTP client with auth
│ ├── ws-client.ts # WebSocket client for events
│ ├── error.ts # Error handling
│ ├── types.ts # Shared types
│ └── tools/
│ ├── framework.ts # Data-driven tool framework
│ ├── params.ts # Reusable param schemas
│ ├── index.ts # Tool registration (42 tools)
│ ├── clients/ # 28 Clients API tools
│ ├── integration/ # 11 Integration API tools
│ ├── bot/ # 2 Bot API tools
│ └── events.ts # WebSocket events tool
├── specs/ # OpenAPI specifications
├── i18n/ # Translations (README.ru.md)
├── Dockerfile # Multi-stage Docker build
├── LICENSE
├── package.json
└── tsconfig.jsonLicencia
Available Tools
28 toolsiva_chatB
IVA chat management: create group chat, get/search/update/delete chats, forward messages, clear history, manage notifications, get P2P chat, get muted chats. Clients API v2.28.12.
Inputs: action (required), name, size, email, +17 more.
iva_chat_callC
IVA chat calls: join/leave/hold calls, start/stop recording, start/stop screen sharing, transfer calls, DTMF, media state, start outgoing call, cancel outgoing call. Clients API v2.28.12.
Inputs: action (required), confirm, callData, dtmfData, +5 more.
iva_chat_messagesC
IVA chat messages: send/edit/delete/star messages, search attachments, get messages/changes/starred, typing notification, read receipt. Clients API v2.28.12.
Inputs: action (required), size, limit, dateTo, +16 more.
iva_chat_participantsA
IVA chat participants: add and remove participants, update participant settings. Clients API v2.28.12.
Inputs: action (required), confirm, profileId, chatRoomId, +3 more.
iva_conferenceC
IVA conference management: create/get/update/delete conferences, calculate session schedule, quick start, create rooms, get participants, respond to invitations, get free resources. Clients API v2.28.12.
Inputs: action (required), limit, offset, confirm, +7 more.
iva_conference_chatC
IVA conference chat messages: send/edit/remove/moderate messages, get messages/participant-targets, export to txt, typing notification, remove all messages. Clients API v2.28.12.
Inputs: action (required), size, limit, dateTo, +13 more.
iva_conference_documentsC
IVA conference documents: create/delete/update/move/list documents and directories, document/video demonstration control (start/stop/pause/play/position), get pages/path/can-upload, public documents. Clients API v2.28.12.
Inputs: action (required), limit, offset, confirm, +10 more.
iva_conference_inquiryC
IVA conference inquiries (polls): create/find/get/delete/update inquiries, start/stop individual or all inquiries, answer/edit answers, find responders, get aggregated answers, export. Clients API v2.28.12.
Inputs: action (required), limit, offset, confirm, +7 more.
iva_conference_lobbyB
IVA conference lobby: join/leave lobby, get lobby participants, approve/reject individual or all participant requests. Clients API v2.28.12.
Inputs: action (required), confirm, profileId, conferenceSessionId.
iva_conference_mediaC
IVA conference media: get media/room info, report media state, request/revoke attention, report equipment, set layout/media-profile/broadcast-language/original-volume/screen-orientation/translation-direction. Clients API v2.28.12.
Inputs: action (required), layout, confirm, mediaProfile, +8 more.
iva_conference_participantsB
IVA conference participants: add/remove/find/get/disconnect participants, mute/unmute media, hand up/down, DTMF, reactions, audio callback, outgoing calls, layout settings, update settings, return to lobby. Clients API v2.28.12.
Inputs: action (required), limit, offset, confirm, +11 more.
iva_conference_presence_controlC
IVA conference presence control: start/stop presence control, confirm attendance. Clients API v2.28.12.
Inputs: action (required), confirm, startData, confirmData, +2 more.
iva_conference_questionnaireB
IVA conference questionnaire: get questionnaire, save questionnaire answers. Clients API v2.28.12.
Inputs: action (required), confirm, answersData, conferenceSessionId.
iva_conference_self_registrationB
IVA conference self-registration: register, check email, resend email. Clients API v2.28.12.
Inputs: action (required), confirm, emailData, registrationData, +1 more.
iva_conference_sessionB
IVA conference session management: get/find/update/delete sessions, join/leave, start/stop, timer control, recording, transcription, subtitling, media publication, invitations, public info. Clients API v2.28.12.
Inputs: action (required), limit, query, state, +17 more.
iva_conference_session_groupsC
IVA conference session groups: create/activate/deactivate/remove groups, extend duration, move participants, get groups. Clients API v2.28.12.
Inputs: action (required), confirm, moveData, extendData, +5 more.
iva_conference_statisticsC
IVA conference statistics: get session/participant statistics, participants activity, sessions statistics aggregation, export to CSV, user participation statistics. Clients API v2.28.12.
Inputs: action (required), limit, dateTo, offset, +7 more.
iva_conference_templatesA
IVA conference templates: list/create/get/delete/update templates, set template as default. Clients API v2.28.12.
Inputs: action (required), confirm, templateData, conferenceTemplateId.
iva_contactsC
IVA contacts management: get/search contacts, changes, presences, invitations, tags, invite, reject, remove, update, create note. Clients API v2.28.12.
Inputs: action (required), id, limit, dateTo, +8 more.
iva_devicesC
IVA device management: register and deregister user devices. Clients API v2.28.12.
Inputs: action (required), confirm, deviceId, profileId, +1 more.
iva_documentsC
IVA user documents: convert document, delete single/multiple, list converted pages. Clients API v2.28.12.
Inputs: action (required), limit, offset, confirm, +2 more.
iva_file_resourcesC
IVA file resources: create resource, download/upload files, get resources info, subscribe to scanning status. Clients API v2.28.12.
Inputs: action (required), confirm, scanData, resourceId, +2 more.
iva_interlocutorsC
IVA interlocutors: find by contact/ldap/profile/profileIds, find interlocutors, get available types, subscribe to presence. Clients API v2.28.12.
Inputs: action (required), userId, confirm, contactId, +3 more.
iva_profileB
IVA user profile management: get/update profile, call forwarding rules, disk utilization, notifications, subscriptions. Clients API v2.28.12. Note: password management and recovery actions are excluded for security.
Inputs: action (required), confirm, profileId, forwardingId, +4 more.
iva_systemC
IVA system info: system info, media info, ICE servers, layouts, broadcast notifications, SMS approval, crash report, mail to support, client applications. Clients API v2.28.12.
Inputs: action (required), fileId, confirm, smsData, +2 more.
iva_user_sessionA
IVA user session management: logout, session info, guest login, session state, login URL. Clients API v2.28.12. Note: login and 2FA actions are excluded for security — authentication is handled automatically via IVA_LOGIN/IVA_PASSWORD environment variables.
Inputs: action (required), confirm, providerId, sessionState.
iva_whiteboardA
IVA whiteboard: start/stop demonstration, manage books and pages (add/delete/update/clear/copy/reorder), get whiteboard/books/pages, export to PNG, undo, save change, update cursor/demo state. Clients API v2.28.12.
Inputs: action (required), limit, bookId, offset, +13 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 28 tools
Tools are grouped by resource domain, so most have clearly separate purposes. The main ambiguities are between iva_documents, iva_file_resources, and iva_conference_documents, and between iva_chat and iva_conference_chat, but the descriptions clarify those boundaries.
All 28 tools follow the same iva_<domain> snake_case pattern, making the set highly predictable. No camelCase or mixed verb styles are present, and singular/plural differences are minor.
At 28 tools, the set exceeds the 25+ threshold and reads as a kitchen-sink API wrapper rather than a focused MCU toolset. Even though each tool covers a distinct area, the breadth creates a heavy navigation burden for agents.
The surface is very complete for the IVA platform: chats, conferences, sessions, media, lobby, statistics, templates, documents, whiteboard, contacts, profile, devices, and system operations are all covered. Excluded login/2FA/password actions are intentional security boundaries, not coverage gaps.
Maintenance
Related MCP Connectors
Voice and chat for AI agents — Discord, Teams, Meet, Slack, Zoom, Telegram, WhatsApp, NC Talk, SIP
Create voice-agent scenarios, pull session analytics, place SIP calls, schedule meeting bots.
AI agent platform: manage leads, conversations, bots, calendar and CRM via MCP.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables managing AI meeting bots that can join, record, transcribe meetings, speak, send messages, and display media across platforms like Zoom, Google Meet, and Microsoft Teams.12MIT

Pipecat MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceEnables voice conversations and screen capture for AI agents via MCP-compatible clients, using Pipecat for speech-to-text and text-to-speech, with support for browser, WebRTC, and phone transport.157BSD 2-Clause "Simplified"- AlicenseNot gradedqualityCmaintenanceEnables AI agents to join and actively participate in video calls, providing real-time interaction and meeting tools through an MCP server.573MIT
- AlicenseNot gradedqualityCmaintenanceEnables managing video conferencing platform tasks like creating rooms, managing recordings, and controlling live sessions through natural language with AI assistants.98 npm1MIT