NicoChatNicoChatDocumentaçãoBuscar na documentação…
Entrar
MCP do NicoChat

MCP do NicoChat

O NicoChat oferece um servidor MCP (Model Context Protocol) remoto que permite conectar sua conta a assistentes de IA e outras ferramentas compatíveis com o protocolo.

2026-09-08

O NicoChat oferece um servidor MCP (Model Context Protocol) remoto que permite conectar sua conta a assistentes de IA e outras ferramentas compatíveis com o protocolo. Uma vez conectado, o assistente passa a operar sua conta NicoChat conversando com você: analisar canais e contatos, criar automações, configurar agentes de IA, montar apps e testar fluxos.

Dados do servidor

Dado
Valor
URL
https://mcp.nicochat.com/mcp
Transporte
Streamable HTTP
Autenticação
OAuth 2.0 com PKCE e registro dinâmico de cliente (RFC 7591)

Qualquer cliente MCP compatível com Streamable HTTP e OAuth 2.0 pode se conectar. Não é necessário solicitar credenciais de aplicação ao NicoChat: o cliente se registra sozinho no primeiro acesso.

Como conectar

O procedimento é o mesmo em qualquer cliente MCP:

  • Adicione o servidor https://mcp.nicochat.com/mcp no seu cliente.
  • O cliente se registra automaticamente e abre a autorização no navegador.
  • Faça login na sua conta NicoChat.
  • Na tela de consentimento, escolha as permissões que deseja conceder e por quanto tempo a autorização vale.
  • Autorize. O cliente passa a enxergar suas workspaces.

Cada cliente tem o próprio lugar para cadastrar o servidor e o próprio jeito de iniciar a autorização. Os guias abaixo cobrem os mais usados, passo a passo:

Outro cliente? Se ele aceita servidor remoto por URL com OAuth, funciona do mesmo jeito: informe a URL, deixe Client ID e Secret em branco e autorize no navegador.

Pré-requisitos

  • Conta NicoChat com workspace em plano pago ou de teste.
  • Ser proprietário ou administrador da workspace que deseja operar.

O que o servidor expõe

São mais de 200 ferramentas, organizadas por área. O nome de cada uma segue o padrão grupo_assunto_ação (por exemplo, channel_sub_flow_publish), então o prefixo diz sobre o que ela opera.

Área
Prefixo
O que faz
Workspace
workspace_ collaborator_
Listar workspaces e colaboradores, ver e ajustar a barra lateral, a visibilidade de canais, o link omnicanal e as planilhas Google registradas.
Análise da operação
channel_analytics channel_blueprint
Métricas de contatos, mensagens e tempos por canal; digestão da estrutura do canal (fluxos, agentes, quadros, sequências) numa chamada; conversas, logs de erro e rastreio de contato.
Automações
channel_sub_flow_ subflow_node_ channel_trigger_ channel_keyword_
Criar, ler, validar, duplicar e publicar fluxos; editar nó a nó e ligar conexões; gatilhos por palavra-chave, por comentário no Facebook e Instagram e por evento; fluxo inicial, sequências, quadros kanban, traduções do canal, webhooks e ações de integração.
Inteligência artificial
ai_agent_ ai_function_ ai_task_ knowledge_base_ vector_store_
Agentes de IA e suas funções, tarefas de IA, provedor de IA, bases de conhecimento e Armazenamentos de Vetores com seus arquivos.
Catálogo do canal
content_
Tags, etiquetas, campos de contato e do bot, eventos personalizados (com dados e resumo), segmentos, idiomas e personas.
Contatos
contact_
Criar (um ou em lote), atualizar, remover; tags, etiquetas e campos; pausar e retomar o bot; atribuir a atendente ou grupo; mover no kanban; rodar um fluxo; opt-in e opt-out; mensagens e histórico; contatos de teste.
Equipe
human_agent_ settings_business_hours_
Atendentes humanos, grupos de atendimento e seus membros, resumo e log de atividade, horários de funcionamento.
WhatsApp
channel_wa_ whatsapp_cloud_ nicozap_
Templates oficiais, WhatsApp Flows, registro e saúde da Cloud API, números da conta; instâncias NicoZap (criar, conectar, status).
Campanhas
broadcast_
Disparos para listas, tags e segmentos.
Meus Apps e Mini Apps
myapp_ integration_mini_app_
Montar apps próprios (ações, fontes, gatilhos, variáveis, pastas, autenticação, metadados, sub-fluxos); navegar o catálogo de Mini Apps, instalar e configurar; gravar credenciais de integrações.
Templates e arquivos
template_ file_
Criar e instalar templates de canal, listar instalações; listar, criar e enviar arquivos.
CRM
crm_pipeline_
Pipelines, campos, itens e log. Recurso contratado à parte: aparece vazio se não estiver ativo.
Testes
sandbox_ channel_action_test channel_sub_flow_validate
Enviar mensagens a um contato de sandbox e ver a resposta do fluxo, apagar o contato de teste, testar uma ação de integração, validar um fluxo antes de publicar.
Portal e referência
portal_ reference_get
Ler a documentação e as notícias do portal NicoChat, publicar e despublicar notícias; consultar a referência de autoria de fluxos, agentes e funções sem gastar limite de requisições.
Kanban não é CRM
O kanban (channel_kanban_list, contact_chat_move) é a organização visual das conversas e vem em todos os planos. O CRM (crm_pipeline_*) é um complemento contratado à parte. Quando você pede "funil" ou "quadro" de conversas, o assistente usa o kanban.

Novidades

As áreas abaixo foram acrescentadas ao servidor depois da primeira versão. Se você conectou antes, reconecte para que o cliente atualize a lista de ferramentas:

  • Edição de fluxo nó a nó — criar, editar e apagar nós e conexões de um fluxo existente, além de validar, duplicar e mover fluxos entre pastas.
  • Meus Apps e Mini Apps — construir apps próprios completos e instalar Mini Apps do catálogo.
  • NicoZap — criar instâncias, gerar a conexão e acompanhar o status.
  • Tarefas de IA e provedor de IA — criar e ajustar tarefas de IA e trocar o provedor usado pelo canal.
  • Templates e arquivos — criar e instalar templates; enviar arquivos para uso em fluxos.
  • Testes em sandbox — conversar com o fluxo por um contato de teste e ler a resposta, sem tocar em contatos reais.
  • Traduções do canal e Google Sheets — ler e gravar traduções da interface do bot; registrar planilhas e inspecionar abas e colunas.
  • Diagnóstico — log de erros do canal, rastreio de eventos de um contato, log de atividade dos atendentes e registro de eventos personalizados.
  • Portal e referência — documentação e notícias do portal NicoChat, e a referência de autoria que ensina o assistente a montar fluxos e agentes na forma correta.

Permissões

Você escolhe as permissões no momento da conexão. Nenhuma escrita acontece sem que a permissão correspondente tenha sido concedida.

Permissão
O que libera
Leitura e análise
Ver workspaces, canais, contatos, estatísticas, conversas e a referência de autoria. Sempre ativa.
Configuração
Criar e editar tags, campos, etiquetas, grupos, fluxos, agentes de IA, apps e configurações.
Gerenciar contatos
Criar, editar e remover contatos, suas tags e campos; mover no kanban; atribuir a atendentes.
Integrações
Gravar credenciais de integrações (OpenAI, Shopify e outras) e instalar Mini Apps.
Campanhas
Enviar disparos para listas, tags e segmentos.

As ferramentas disponíveis na sessão são filtradas pelas permissões concedidas: se você conectar apenas com leitura, as ferramentas de escrita não aparecem. Você pode ampliar depois, reconectando.

Duração e revogação

Ao autorizar, você define a validade da conexão: 1, 7, 30 ou 90 dias, ou sem expiração. A autorização pode ser revogada a qualquer momento no painel NicoChat, em Configurações da Conta, ou removendo o servidor no seu cliente MCP. A revogação tem efeito imediato.

Segurança

  • A autenticação usa OAuth 2.0 com PKCE. Sua senha nunca é entregue ao cliente MCP.
  • Sua identidade vem sempre da credencial autorizada, nunca de algo informado na conversa.
  • Cada conexão opera apenas nas workspaces das quais você é proprietário ou administrador. Tentativas de acessar outra workspace são recusadas.
  • Toda resposta passa por uma camada de sanitização que remove segredos. Tokens de API, chaves de integração e credenciais nunca são devolvidos ao cliente.
  • Operações de escrita validam a workspace de destino antes de executar; em caso de dúvida, a operação falha em vez de prosseguir.

Limites conhecidos

  • O servidor opera sobre workspaces em plano pago ou de teste. Workspaces gratuitas não são acessíveis.
  • Recursos contratados à parte (como o CRM) só aparecem se estiverem ativos na sua conta.
  • Ferramentas específicas de WhatsApp exigem um número comercial aprovado pela Meta e conectado ao canal.
  • Fluxos criados ou editados precisam ser publicados para entrar em operação.
  • Alguns clientes limitam o total de ferramentas ativas (o VS Code, por exemplo, aceita 128 por pedido). Conectar só com as permissões necessárias reduz a lista.

Suporte

Dúvidas ou problemas com o servidor MCP: fale com o suporte NicoChat pelos canais habituais de atendimento.