Cognigy.AI Management MCP

Servidor MCP para Cognigy.AI - 132 ferramentas que permitem que Claude, Cursor e outros assistentes de IA construam, configurem, testem e operem agentes de IA conversacional por meio do Model Context Protocol.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP de Gerenciamento Cognigy.AI

Servidor de Protocolo de Contexto de Modelo (MCP) para gerenciar agentes virtuais Cognigy.AI por meio da API de Gerenciamento

Este é um servidor MCP independente e de código aberto, não afiliado, endossado ou patrocinado pela Cognigy ou NiCE. Ele requer sua própria conta válida no Cognigy.AI e chave de API, usados de acordo com os termos de licença comercial da Cognigy. "Cognigy" e "Cognigy.AI" são marcas registradas de seus respectivos proprietários.

O que é isso?

cognigy-ai-mcp-management-server é um servidor MCP local que permite que assistentes de codificação com IA (Claude, Cursor, etc.) criem, configurem, testem e operem agentes de IA conversacional Cognigy.AI programaticamente.

Em vez de navegar pela interface do Cognigy, agora você pode:

Criar e gerenciar fluxos, nós e intenções por meio de linguagem natural
Executar treinamento de NLU e testes de regressão automaticamente
Implantar snapshots e pacotes entre ambientes
Configurar LLMs, Knowledge AI e integrações

Feito para: Desenvolvedores, arquitetos de soluções e parceiros de SI que desenvolvem na Cognigy.AI.

Requisitos

Node.js 20.0.0 ou superior
Conta Cognigy.AI com acesso à API (Trial, SaaS ou on-premises)
Chave de API gerada na interface do Cognigy (Meu Perfil → Chaves de API)

Instalação

# 1. Install the Cognigy REST API client (required peer dependency)
npm install @cognigy/rest-api-client

# 2. Install this MCP server
npm install -g cognigy-ai-mcp-management-server

Importante: O pacote @cognigy/rest-api-client é licenciado sob a "Licença Proprietária Cognigy". Ao instalá-lo, você concorda com os termos de licença da Cognigy.

Configuração

Defina as variáveis de ambiente antes de executar:

# Required: Your Cognigy API endpoint
export COGNIGY_BASE_URL=https://api-trial.cognigy.ai

# Required: Your API key (never commit this!)
export COGNIGY_API_KEY=your-api-key-here

# Optional: Default project for operations
export COGNIGY_DEFAULT_PROJECT_ID=your-project-id

URLs Base Comuns:

Ambiente	URL Base
Trial	`https://api-trial.cognigy.ai`
SaaS UE	`https://api-app.cognigy.ai`
SaaS EUA	`https://api-app-us.cognigy.ai`
Dedicado	`https://api-<company>.cognigy.cloud`

Configuração do Cliente MCP

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Adicione ao .mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Adicione ao .cursor/mcp.json:

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Ferramentas Disponíveis

Todas as Ferramentas

Este servidor fornece 132 ferramentas MCP organizadas por domínio:

Categoria	Ferramentas	Descrição
Projetos e Fluxos	5	Listar projetos, fluxos, configurações de fluxo, logs
Nós	9	Operações CRUD, busca, mover, geração de saída de IA
Intenções e NLU	10	Gerenciamento de intenções, treinamento, pontuação, auditoria
Endpoints	2	Listar e inspecionar configurações de endpoints
Sessões	2	Injetar/redefinir contexto de conversa
Conversas	3	Buscar conversas, transcrições
Playbooks e Testes	6	Executar playbooks, testes de regressão
Snapshots	9	Criar, restaurar, empacotar, comparar, promover
Pacotes	7	Criar, mesclar, enviar, baixar
Conexões	5	Gerenciar conexões de API (segredos ocultos)
LLMs	7	Configurar provedores de IA generativa
Conectores NLU	5	NLU externo (Dialogflow, LUIS, etc.)
Knowledge AI	21	Armazenamentos, fontes, blocos, conectores (RAG)
Funções	9	Funções de código personalizadas, instâncias
Extensões	6	Enviar, configurar, gerenciar extensões
Perfis de Contato	11	CRUD de perfis, mesclar, exportar (LGPD)
Analytics	4	Métricas de conversa, chamada, conhecimento
Auditoria	2	Logs de eventos de auditoria
Transferência	7	Provedores e serviços de agente ao vivo
Busca	1	Busca de recursos em toda a organização
Tarefas	2	Rastreamento de status de tarefas assíncronas

Principais Recursos

Seguro por padrão: Todas as ferramentas de mutação usam dryRun: true por padrão
Ciente de assincronia: Operações de longa duração fazem polling até a conclusão
Segurança: Chaves de API apenas em memória, segredos ocultos automaticamente
Paginação: Todas as operações de listagem suportam limit e skip

Desenvolvimento e Testes

Desenvolvimento com Mock Primeiro

Execute contra o servidor mock Prism (sem necessidade de conta Cognigy):

# Terminal 1: Start mock server
npm run mock

# Terminal 2: Run tests
npm test

Testes com API ao Vivo

# Create .env from template
cp .env.example .env
# Edit .env with your credentials

# Run development server
npm run dev

Build

npm run build    # Compile TypeScript
npm test         # Run test suite (49 tests)
npm run lint     # Check code style

Regenerar Tipos (opcional)

Se você precisar atualizar os tipos gerados a partir de uma API Cognigy mais recente:

npm run update:spec   # Download latest OpenAPI spec
npm run gen:types     # Regenerate TypeScript types

Importante: Dependências

Este pacote requer @cognigy/rest-api-client como dependência de pares (peer dependency). Isso significa:

Você deve instalá-lo separadamente (veja Instalação acima)
Você aceita os termos de licença da Cognigy ao instalar o pacote deles
Não empacotamos nem redistribuímos nenhum código da Cognigy

Você é responsável por:

Revisar e aceitar os termos da licença proprietária da Cognigy
Ter os direitos apropriados para usar a API Cognigy
Manter suas credenciais de API seguras

O cliente da API REST Cognigy é o SDK oficial mantido pela Cognigy GmbH e publicado no npm sob a "Licença Proprietária Cognigy".

Licença

Este servidor MCP é lançado sob a Licença MIT. Veja LICENÇA para detalhes.

Nota: A licença MIT se aplica apenas ao código deste servidor MCP. Dependências (particularmente @cognigy/rest-api-client) estão sujeitas às suas próprias licenças.

Contribuindo

Contribuições são bem-vindas! Por favor:

Faça um fork do repositório
Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
Siga os padrões de código existentes (esquemas Zod, flags dryRun, etc.)
Adicione testes para novas ferramentas
Execute npm test && npm run build antes de commitar
Envie um Pull Request

Diretrizes de Desenvolvimento

Todas as ferramentas devem ter validação de entrada Zod
Ferramentas de mutação devem suportar a flag dryRun (padrão: true)
Descrições de ferramentas devem ser amigáveis para LLM (1-2 frases)
Nunca registre ou exponha chaves/segredos de API
Teste contra o servidor mock antes da API ao vivo

Suporte

Problemas: Issues do GitHub
Docs Cognigy: docs.cognigy.com
Especificação MCP: modelcontextprotocol.io

Construído com o SDK do Model Context Protocol