Omilia MCP Tools

Servidor Omilia MCP

Documentación: learn.ocp.ai

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los clientes LLM compatibles con MCP crear, implementar y operar agentes conversacionales de IA en la Plataforma en la Nube Omilia (OCP) mediante lenguaje natural. Cree una aplicación orquestadora, active un agente autónomo, adjunte una base de conocimientos desde una URL, conecte una herramienta de servicio web, implemente y pruebe el resultado — todo desde un mensaje de chat en su editor o aplicación de escritorio.

El servidor se ejecuta localmente y se comunica con OCP a través de HTTPS autenticado. Ningún dato sale de su máquina excepto las solicitudes que su cliente MCP realiza en su nombre.

Clientes MCP compatibles

Claude Desktop, Claude Code, Cursor, VS Code (con Copilot) y Codex.

Instalación

Recomendado — asistente interactivo (responde algunas preguntas y luego confirma antes de escribir cualquier cosa):

npx github:omilia/mcp init

El asistente selecciona su cliente, recopila credenciales con entrada enmascarada, ejecuta verificaciones de requisitos previos (Node 20+, uv), instala la configuración e imprime un resumen de prueba de humo APROBADO/REPROBADO antes de salir. Consulte la sección del asistente interactivo en la guía de instalación para la secuencia completa de preguntas.

No interactivo / CI — proporcione todas las banderas para omitir preguntas:

npx github:omilia/mcp init --client <claude|claude-code|cursor|vscode|codex>

Consulte la guía de instalación completa en docs/installation.md para el paquete de un solo clic .mcpb (Claude Desktop) y las alternativas de configuración manual.

Autenticación

Recomendado: concesión de contraseña Keycloak — configure OCP_USERNAME, OCP_PASSWORD y OCP_KEYCLOAK_REALM (predeterminado master). Ruta más rápida: un Token de Acceso Personal mediante OCP_ACCESS_TOKEN. Ambos se ejecutan solo en memoria — las credenciales nunca se persisten. Consulte docs/installation.md para la tabla de realm por entorno.

Herramientas (31)

La superficie MCP, agrupada por área. Cada fila es una herramienta que su LLM compatible con MCP puede invocar a través de tools/call.

Descubrimiento y guías

Herramienta	Descripción
read_guide	Devuelve una guía en markdown para un flujo de trabajo canónico de OCP MCP
list_groups	Lista los grupos de OCP a los que el usuario actual tiene acceso
list_agents	Lista todos los agentes en el ámbito
list_knowledge_bases	Lista las bases de conocimientos (almacenes vectoriales de preguntas frecuentes)
list_pathfinder_projects	Lista los proyectos Pathfinder (filtrables por búsqueda)
search_orchestrator_apps	Busca aplicaciones Orchestrator
search_miniapps	Busca miniapps
search_numbers	Busca números de teléfono adjuntos a aplicaciones
search_variable_collections	Busca colecciones de variables
search_dialog_logs	Busca registros de diálogo por grupo / aplicación / fecha

Aplicaciones Orchestrator

Herramienta	Descripción
create_orchestrator_app	Crea una nueva aplicación Orchestrator
get_orchestrator_app	Obtiene el lienzo de una aplicación
add_concierge_to_orc_app	Conecta un Concierge al lienzo de una aplicación
deploy_orc_app	Implementa una aplicación Orchestrator
talk_to_app	Envía un mensaje a una aplicación implementada y recibe la respuesta del agente

Agentes (Concierge y Tarea)

Herramienta	Descripción
create_agent	Crea un agente Concierge o Tarea
update_agent_instructions	Actualiza las instrucciones de un agente
update_concierge	Actualiza la lista de subagentes del Concierge
add_agent_to_concierge	Agrega un subagente a un Concierge
add_escalation_queue_to_agent	Agrega cola(s) de escalamiento a un agente

Miniapps y agentes WebService

Herramienta	Descripción
create_webservice_miniapp	Crea una miniapp WebService (herramienta HTTP)
get_miniapp	Obtiene la configuración de una miniapp
edit_webservice_miniapp	Edita la configuración de solicitud de una miniapp WebService
set_miniapp_prompt	Establece mensajes de bienvenida / iniciales / de error en una miniapp
create_webservice_agent	Crea un agente Tarea que utiliza una miniapp WebService
add_tool_to_webservice_agent	Agrega otra herramienta WebService a un agente Tarea

Pathfinder (conocimiento)

Herramienta	Descripción
create_pathfinder_project	Crea un proyecto Pathfinder
add_faq_to_agent	Rastrea una URL en un FAQ de Pathfinder y lo adjunta a un agente
add_knowledge_base_to_agent	Adjunta una base de conocimientos existente a un agente

Variables y diálogos

Herramienta	Descripción
get_collection_variables	Lista variables en una colección
get_dialog_logs	Obtiene el registro de diálogo completo para un ID de diálogo

Ejemplos

Los recorridos de extremo a extremo de los flujos canónicos (crear, implementar, probar, extender) se encuentran en docs/examples/.

Licencia

MIT. Consulte LICENSE.

Procedencia

Este repositorio se genera automáticamente a partir de una fuente interna en cada versión. Generado a partir de la confirmación interna 333d04b1f44b7f54b0803eba5c1631dd8b101444 en la rama mirror/333d04b1f44b. Esta versión expone 31 herramientas en src/main.py, src/server.py. Las solicitudes de extracción contra este repositorio no se pueden fusionar upstream — abra problemas para visibilidad y comentarios; las correcciones de errores se rastrean en la fuente interna.