Para conectar o Codex ao NicoChat, adicione o servidor MCP oficial https://mcp.nicochat.com/mcp no arquivo ~/.codex/config.toml e rode codex mcp login nicochat. A partir daí, o Codex opera sua conta do NicoChat por linguagem natural, direto do terminal. Ele lista canais, cria e duplica fluxos, instala templates, valida automações antes de publicar e consulta analytics. Neste tutorial, mostramos a configuração completa e três casos de uso que fazem sentido justamente no terminal: operação de fluxos em lote, validação como rotina de trabalho e onboarding de clientes por script.
guia completo do MCP do NicoChat
Resumo rápido
- O NicoChat expõe um servidor MCP oficial em
https://mcp.nicochat.com/mcp, com autenticação OAuth pelo navegador.- No Codex, a configuração é um bloco
[mcp_servers.nicochat]no~/.codex/config.tomlmais umcodex mcp login nicochat.- Se sua versão do Codex não aceitar conexão HTTP direta, o fallback via
mcp-remote(stdio) resolve.- Casos de uso que brilham no terminal: duplicar fluxos entre canais em lote, validar fluxos antes de publicar e criar automações dentro de scripts de onboarding.
- O MCP funciona com qualquer plano do NicoChat que tenha acesso à plataforma. Há teste grátis de 7 dias sem cartão.
Por que operar o NicoChat pelo terminal
O terminal é onde o trabalho repetitivo vira rotina automatizada. O builder visual do NicoChat resolve bem a criação de um fluxo. Mas algumas tarefas são naturalmente de linha de comando: repetir a mesma operação em dez canais, rodar uma checagem antes de cada publicação, encaixar a criação de automação num script maior.
É aqui que entra o MCP (Model Context Protocol), um padrão aberto que conecta assistentes de IA a ferramentas externas. A especificação oficial está em modelcontextprotocol.io. O NicoChat trabalha com MCP nas duas direções. Seus agentes podem consumir servidores MCP externos dentro dos fluxos. E a plataforma expõe o próprio servidor MCP oficial, para que um assistente crie e edite fluxos, agentes e automações por você. Este segundo lado é o que usamos neste tutorial.
O Codex é o agente de código da OpenAI que roda no terminal. A documentação oficial de instalação e configuração está na central de ajuda da OpenAI. Conectado ao MCP do NicoChat, ele deixa de ser só um assistente de programação. Vira um operador da sua conta: você descreve a tarefa em português e ele executa as chamadas na plataforma.
Se você prefere trabalhar dentro de um editor, também publicamos guias equivalentes para outros clientes MCP.
como conectar o Cursor ao NicoChat
Como configurar o MCP do NicoChat no Codex
A configuração leva uns dois minutos e tem três passos: editar o arquivo de configuração, autenticar e testar.
1. Adicione o servidor no config.toml
Abra (ou crie) o arquivo ~/.codex/config.toml e adicione o bloco:
[mcp_servers.nicochat]
url = "https://mcp.nicochat.com/mcp"2. Autentique com sua conta
No terminal, rode:
codex mcp login nicochatO comando abre o navegador para o login OAuth na sua conta do NicoChat. Autorize e volte ao terminal. Pronto: o Codex já enxerga as ferramentas da plataforma.
3. Fallback: conexão via stdio
Algumas versões do Codex, ou ambientes com restrição de rede, não aceitam a conexão HTTP direta. Nesse caso, use o mcp-remote como ponte stdio:
[mcp_servers.nicochat]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.nicochat.com/mcp"]O mcp-remote faz a mesma autenticação OAuth pelo navegador na primeira execução. Você precisa do Node.js instalado para o npx funcionar.
4. Teste a conexão
Abra uma sessão do Codex e peça algo simples:
Liste os canais do meu workspace no NicoChat e me diga o tipo de cada um.Se a resposta trouxer seus canais reais (WhatsApp, Instagram, web e afins), a conexão está ativa. Um detalhe útil: o servidor MCP inclui documentação de autoria embutida. Antes de criar fluxos, o assistente consulta essa referência e escreve blocos no formato correto, sem chute.
Caso de uso 1: operar fluxos em lote entre canais
Este é o caso que justifica o terminal sozinho. O foco aqui é a operação em lote: repetir a mesma instalação de template em vários canais, de uma vez, como rotina. Imagine um subfluxo de qualificação de leads que funciona bem no WhatsApp. Você quer o mesmo comportamento no Instagram e no canal web. No builder visual, isso significa recriar bloco a bloco em cada canal. Com o Codex, é um prompt. Se o seu cenário é uma migração única com relatório de diferenças, o post do Windsurf desta série cobre esse caminho.
O caminho técnico usa os templates de fluxo do NicoChat: a instalação de um template migra o conteúdo entre canais de tipos diferentes, ajustando o que cada canal suporta. O Codex encadeia as etapas por você.
Prompt pronto para adaptar:
No NicoChat, pegue o subfluxo "Qualificação de leads" do canal
WhatsApp Principal. Salve como template e instale esse template
nos canais "Instagram Loja" e "Site". Ao final, liste o que foi
criado em cada canal e aponte diferenças entre as versões.O mesmo padrão serve para operações maiores. Alguns exemplos que rodamos em produção no nosso próprio workspace:
- Duplicar um fluxo de boas-vindas para todos os canais de um tipo, de uma vez.
- Padronizar um subfluxo de transbordo humano em vários canais, mantendo horário comercial.
- Renomear e reorganizar subfluxos seguindo uma convenção de nomes, canal por canal.
A regra prática: se você faria a mesma sequência de cliques mais de duas vezes, descreva a sequência uma vez e deixe o Codex repetir.
MCP do NicoChat no VS Code Copilot
Caso de uso 2: validar fluxos antes de publicar
Todo gestor de automação já publicou um fluxo com um botão sem destino ou uma condição que nunca dispara. O cliente encontra o erro antes de você. A solução é tratar publicação como um dev trata deploy: com uma checagem antes.
Com o MCP, o Codex exporta a estrutura do fluxo e roda a validação da plataforma antes de qualquer publicação. Você transforma isso num ritual de fim de tarefa:
Antes de publicar: exporte o fluxo "Funil Black Friday" do canal
WhatsApp Principal, rode a validação e me mostre os problemas
encontrados por severidade. Não publique nada ainda. Se houver
blocos sem conexão de saída ou variáveis usadas antes de serem
definidas, liste cada um com o nome do bloco.O retorno vira sua checklist de correção. Depois de ajustar, você pede a revalidação e só então publica. Dois hábitos que recomendamos junto:
- Exportar o fluxo validado para um arquivo local, como registro de versão. O terminal facilita: o export cai direto na pasta do projeto do cliente.
- Pedir ao Codex um resumo em texto da lógica do fluxo. Ler a lógica em prosa revela erros de raciocínio que o diagrama esconde.
Para fluxos de WhatsApp, vale validar também as premissas de negócio: janela de atendimento, tipo de mensagem e opt-in. Esses conceitos estão detalhados no nosso guia de automação de atendimento no WhatsApp.
automação de atendimento no WhatsApp, guia completo
Caso de uso 3: onboarding de cliente por script (para agências)
Agências que entregam automação repetem a mesma fundação a cada cliente novo: criar canal, aplicar templates do nicho, configurar tags e campos, ajustar horário comercial, apontar o transbordo. Feito à mão, é uma tarde de trabalho. Descrito uma vez num roteiro, vira um procedimento que o Codex executa em minutos.
A ideia é manter um arquivo de onboarding no repositório da agência, por exemplo onboarding-clinica.md, com o passo a passo em linguagem natural. Na chegada de um cliente, você abre o Codex e aponta para o roteiro:
Leia o arquivo onboarding-clinica.md e execute o procedimento no
NicoChat para o novo workspace do cliente "Clínica Sorriso":
instale o template de clínica no canal WhatsApp, crie as tags e
os campos listados, configure o horário comercial descrito e
monte o subfluxo de transbordo para o grupo "Recepção".
Ao final, gere um relatório do que foi criado para eu conferir.O ganho não é só velocidade. É consistência: todo cliente novo nasce com a mesma fundação, sem depender de quem executou o onboarding naquele dia. E o relatório final vira o documento de entrega para o cliente.
Um cuidado importante: revise o relatório antes de ativar qualquer disparo. O Codex executa bem, mas a responsabilidade pela conta segue sendo sua. Comece com operações de leitura e criação em rascunho. Deixe publicação e broadcast sempre como decisão humana.
Esse padrão de trabalho, em que a IA executa tarefas na plataforma em vez de só responder perguntas, é o que chamamos de IA agêntica.
IA agêntica no atendimento, o que muda quando a IA executa
Perguntas frequentes
Preciso de assinatura do NicoChat para usar o MCP?
Você precisa de uma conta ativa do NicoChat, porque o login OAuth autentica na sua conta real. O servidor MCP opera os recursos que seu plano já inclui. Para testar, o teste grátis de 7 dias sem cartão dá acesso à plataforma. Do lado do Codex, vale o acesso do seu plano da OpenAI.
Qual a diferença entre usar o Codex e o Claude Code?
O servidor MCP é o mesmo, então as capacidades na plataforma são idênticas. A diferença está no cliente: modelo de IA, fluxo de configuração e assinatura. No Claude Code, a conexão usa o comando claude mcp add em vez do config.toml. Escolha o agente que você já usa no dia a dia. O guia central do MCP compara a configuração em todos os clientes.
Dá para usar em CI, sem interação humana?
O modo não interativo do Codex (codex exec) permite rodar prompts em pipeline. O ponto de atenção é a autenticação: o login OAuth do MCP abre navegador, o que exige um primeiro login manual na máquina que roda o job. Para rotinas como a validação de fluxos do caso 2, funciona bem como etapa de checagem. Evite dar a um job autônomo poder de publicar ou disparar mensagens. Mantenha o passo final com aprovação humana.
Conclusão: comece com uma tarefa repetitiva
O caminho até aqui foi curto: dois blocos de configuração, um login e três padrões de uso. A recomendação para começar é escolher uma tarefa que você repete toda semana no builder e descrevê-la uma vez no Codex. Duplicação de fluxo entre canais costuma ser a primeira vitória.
Se você ainda não tem conta, crie uma no teste grátis de 7 dias sem cartão, conecte o MCP e rode o primeiro prompt deste tutorial. Em uma tarde, seu terminal vira a mesa de operação do seu atendimento.
hub de configuração do MCP do NicoChat em todos os clientes