Omilia MCP Tools

Omilia MCP Server

Documentação: learn.ocp.ai

Um servidor Model Context Protocol que permite que clientes LLM compatíveis com MCP criem, implantem e operem agentes de IA conversacional na Omilia Cloud Platform (OCP) por meio de linguagem natural. Crie um aplicativo orquestrador, inicie um agente autônomo, anexe uma base de conhecimento a partir de uma URL, conecte uma ferramenta de webservice, implante e faça o smoke-test do resultado — tudo a partir de um prompt de chat no seu editor ou aplicativo de desktop.

O servidor é executado localmente e se comunica com a OCP por HTTPS autenticado. Nenhum dado sai da sua máquina, exceto as solicitações que seu cliente MCP faz em seu nome.

Clientes MCP suportados

Claude Desktop, Claude Code, Cursor, VS Code (com Copilot) e Codex.

Instalação

Recomendado — assistente interativo (responde a algumas perguntas e confirma antes de gravar qualquer coisa):

npx github:omilia/mcp init

O assistente seleciona seu cliente, coleta credenciais com entrada mascarada, executa verificações de pré-requisitos (Node 20+, uv), instala a configuração e imprime um resumo do smoke-test PASS/FAIL antes de sair. Consulte a seção do assistente interativo no guia de instalação para a sequência completa de prompts.

Não interativo / CI — forneça todas as flags para pular os prompts:

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

Consulte o guia de instalação completo em docs/installation.md para o pacote de um clique .mcpb (Claude Desktop) e alternativas de configuração manual.

Autenticação

Recomendado: concessão de senha Keycloak — defina OCP_USERNAME, OCP_PASSWORD e OCP_KEYCLOAK_REALM (padrão master). Caminho mais rápido: um Personal Access Token via OCP_ACCESS_TOKEN. Ambos são executados apenas em memória — as credenciais nunca são persistidas. Consulte docs/installation.md para a tabela de realm por ambiente.

Ferramentas (31)

A superfície MCP, agrupada por área. Cada linha é uma ferramenta que seu LLM compatível com MCP pode invocar por meio de tools/call.

Descoberta e guias

Ferramenta	Descrição
read_guide	Retorna um guia markdown para um fluxo de trabalho MCP canônico da OCP
list_groups	Lista os grupos da OCP aos quais o usuário atual tem acesso
list_agents	Lista todos os agentes no escopo
list_knowledge_bases	Lista as bases de conhecimento (armazenamentos vetoriais de FAQ)
list_pathfinder_projects	Lista os projetos Pathfinder (pesquisa filtrável)
search_orchestrator_apps	Pesquisa aplicativos Orchestrator
search_miniapps	Pesquisa miniapps
search_numbers	Pesquisa números de telefone vinculados a aplicativos
search_variable_collections	Pesquisa coleções de variáveis
search_dialog_logs	Pesquisa logs de diálogo por grupo / aplicativo / data

Aplicativos Orchestrator

Ferramenta	Descrição
create_orchestrator_app	Cria um novo aplicativo Orchestrator
get_orchestrator_app	Busca o canvas de um aplicativo
add_concierge_to_orc_app	Conecta um Concierge ao canvas de um aplicativo
deploy_orc_app	Implanta um aplicativo Orchestrator
talk_to_app	Envia uma mensagem a um aplicativo implantado e recebe a resposta do agente

Agentes (Concierge e Task)

Ferramenta	Descrição
create_agent	Cria um agente Concierge ou Task
update_agent_instructions	Atualiza as instruções de um agente
update_concierge	Atualiza a lista de subagentes do Concierge
add_agent_to_concierge	Adiciona um subagente a um Concierge
add_escalation_queue_to_agent	Adiciona fila(s) de escalonamento a um agente

Miniapps e agentes WebService

Ferramenta	Descrição
create_webservice_miniapp	Cria um miniapp WebService (ferramenta HTTP)
get_miniapp	Busca a configuração de um miniapp
edit_webservice_miniapp	Edita a configuração de solicitação de um miniapp WebService
set_miniapp_prompt	Define prompts de boas-vindas / inicial / erro em um miniapp
create_webservice_agent	Cria um agente Task que usa um miniapp WebService
add_tool_to_webservice_agent	Adiciona outra ferramenta WebService a um agente Task

Pathfinder (conhecimento)

Ferramenta	Descrição
create_pathfinder_project	Cria um projeto Pathfinder
add_faq_to_agent	Rastreia uma URL em um FAQ Pathfinder e o anexa a um agente
add_knowledge_base_to_agent	Anexa uma base de conhecimento existente a um agente

Variáveis e diálogos

Ferramenta	Descrição
get_collection_variables	Lista as variáveis em uma coleção
get_dialog_logs	Busca o log de diálogo completo para um ID de diálogo

Exemplos

Walkthroughs de ponta a ponta dos fluxos canônicos (criar, implantar, testar, estender) estão em docs/examples/.

Licença

MIT. Consulte LICENSE.

Procedência

Este repositório é gerado automaticamente a partir de uma fonte interna a cada release. Gerado a partir do commit interno 333d04b1f44b7f54b0803eba5c1631dd8b101444 no branch mirror/333d04b1f44b. Este release expõe 31 ferramentas em src/main.py, src/server.py. PRs contra este repositório não podem ser mesclados de volta ao upstream — abra issues para visibilidade e feedback; correções de bugs são rastreadas na fonte interna.