Como integrar o Cord ao seu site com um único comando
O assistente da CLI do Cord integra seu site em minutos: gerador de orçamentos, webhooks, seus apps e seus agentes de IA, sem copiar chaves e em modo de teste.
E
Equipe CordEngenharia de produto
Colocar o Cord no seu site significa várias coisas ao mesmo tempo: mostrar o gerador de orçamentos para que seus clientes montem a proposta deles, receber um aviso nos seus sistemas quando alguém aprova ou paga, e fazer com que o seu CRM e a sua equipe fiquem sabendo sem que ninguém copie dados à mão. Até agora, isso exigia uma tarde de documentação, chaves copiadas de um painel e testes às cegas.
A partir de hoje, quem mantém o seu site executa um comando e o assistente do Cord faz esse trabalho em poucos minutos.
À mão
01Entrar no painel, criar uma chave e copiá-la02Colá-la em um .env sem enviá-la ao repositório03Instalar o SDK e escrever a rota de webhooks04Verificar a assinatura de cada webhook05Montar o proxy do Cord Elements06Abrir um túnel para receber webhooks no localhost07Conectar HubSpot, Shopify ou Slack em outra aba08Configurar o MCP do Cord em cada agente
Com a CLI$ npx @flouviahq/cli
✓Você entra pelo navegador, sem copiar chaves✓SDK, rota de webhooks e proxy do Elements✓Chave de teste em um .env que o git ignora✓Webhooks assinados chegando ao seu localhost✓Seus apps, conectados pelo navegador✓O MCP do Cord nos seus agentes de IA
O que antes eram oito passos manuais, o assistente resolve em uma única sessão.
O que é a CLI do Cord
É a ferramenta de linha de comando do Cord. Ela é instalada pelo npm e, sem argumentos, abre um assistente que ocupa o terminal e guia a integração do começo ao fim. Antes de mexer em qualquer coisa, ela lê o projeto: reconhece a tecnologia com que o seu site foi feito, vê quais apps ele usa e explica o que vai fazer.
minha-loja — npx @flouviahq/cli
Assistente do Cord cli 2.2.0Ajuda: docs.cordhq.app/cli
Conectamos sua conta, integramos o Cord ao seu projeto e deixamos seus webhooks escutando.Veja o que é compartilhado em “Privacidade e dados”. Os valores dos seus .env* ficam no seu computador.
Sua conta, seu projeto e seus webhooks prontos em poucos minutos.
Pasta ✓ ~/minha-lojaFramework✓ Next.js (App Router) detectadoPlano ✓ SDK · rota de webhooks · proxy do Elements · sua configuraçãoApps ✓ HubSpot, Shopify, Slack oferecemos conectá-losConta ○ não conectada seu navegador vai abrir
▸ Continuar Trocar o framework O que ele vai fazer Privacidade e dados Cancelar
↑↓ moverenter escolheresc sair
As boas-vindas do assistente: sua pasta, seu framework, seus apps e o que ele vai integrar.
Você entra com a sua conta, não com uma chave
O primeiro passo é conectar a sua conta. Em vez de pedir que você procure e cole uma chave de API, o assistente abre o seu navegador no Cord. Lá você escolhe a organização e decide o que a chave do projeto pode fazer: ler o seu catálogo, criar orçamentos, administrar webhooks. A opção sugerida é a mínima que a integração usa.
Você autoriza, o Cord confirma que é você e o terminal se conecta sozinho. Tudo em modo de teste: nada do que o assistente fizer toca nas suas vendas reais.
AmbienteO assistente só usa chaves de teste. Sua conta real não muda sem que você aprove cada mudança.Teste
PermissõesO sugeridoSó leituraNada
Conectar o terminalSimuladores, eventos, propostas de configuração e o assistente com IA, com uma chave de teste que expira em 90 dias.Obrigatório
Chave do projetoO assistente a salva no arquivo de ambiente do seu projeto para seu servidor e o Cord Elements. Conta como uma das chaves do seu plano.
ProdutosO gerador de orçamentos mostra seu catálogo.Sem acessoLeituraEscrita
ClientesSeu servidor busca clientes do seu CRM.Sem acessoLeituraEscrita
OrçamentosO gerador de orçamentos cria orçamentos.Sem acessoLeituraEscrita
WebhooksSeu código cria e gerencia endpoints de webhooks.Sem acessoLeituraEscrita
ElementsA configuração do gerador de orçamentos e o rascunho com IA.Sem acessoLeituraEscrita
Ao autorizar, você volta ao seu terminal em localhost:52814. Se você não abriu o assistente, cancele.CancelarAutorizar assistente
minha-loja — npx @flouviahq/cli
Assistente do Cord cli 2.2.0Ajuda: docs.cordhq.app/cli
Autorize no seu navegadorEscolha a organização e as permissões e clique em Autorizar. O terminal se conecta sozinho, sem copiar nenhum código.
https://cordhq.app/app/cli/autorizar?codigo=KXTW-4829&proyecto=1Pressione a tecla o para abrir o link no navegador ou c para copiá-lo.
⠹Aguardando sua autorização no navegador
o abrir no navegadorc copiar linkesc sair
Enquanto o terminal espera, você decide no navegador em qual organização ele entra e com quais permissões.
Seu site, integrado
Com a conta conectada, o assistente deixa o seu projeto pronto:
O SDK do Cord, instalado com o gerenciador de pacotes que o seu projeto já usa.
A rota que recebe os avisos do Cord (os webhooks), que verifica a assinatura de cada um para que ninguém possa se passar pelo Cord.
A ponte para o gerador de orçamentos (o proxy do Cord Elements), para que seus clientes façam orçamentos no seu site sem expor a sua chave.
Sua chave de teste, salva em um arquivo que não vai para o repositório.
Sua configuração, se você informar o seu site e com o que trabalha: o Cord propõe seus produtos, impostos e modelos, e você os aprova antes que sejam aplicados.
Ao terminar, ele deixa um relatório com cada arquivo que criou. E nunca sobrescreve um arquivo que já existia.
Transparente com os seus dados
Antes de começar, o assistente diz o que sai do seu computador e o que nunca sai. As senhas e chaves dos seus arquivos de ambiente ficam no seu computador.
minha-loja — npx @flouviahq/cli
Assistente do Cord cli 2.2.0Ajuda: docs.cordhq.app/cli
Privacidade e dados
O que sai do seu computador+ Seu site, a descrição e a lista de preços que você enviar, para propor a configuração da sua conta.+ O nome deste computador, para nomear a chave que cria. Se você integrar com IA, os caminhos dos seus arquivos e os que a IA abre.
O que nunca sai− Os valores dos seus .env* e qualquer segredo.− Sua pasta .git, node_modules e tudo o que está fora deste projeto.
O que ele faz sem perguntarInstalar os pacotes do Cord, criar ou ajustar os arquivos da integração e salvar sua chave de teste em um .env que o git ignora.
O que ele nunca fazRodar um comando fora da lista: só instala pacotes do Cord e roda seus scripts de build, lint e testes.
Sua conta real não muda: a configuração fica como proposta até você aprová-la em cordhq.app.
▸ Voltar Ler o guia completo docs.cordhq.app/cli
↑↓ moverenter escolheresc voltar
A tela Privacidade e dados, sempre a um passo do menu.
A versão 2.1 traz também uma IA que adapta a integração ao jeito como o seu projeto foi feito, com ferramentas que não saem da pasta dele e uma lista fechada de comandos. Ainda não a ativamos: faremos isso quando a nossa divulgação sobre inteligência artificial cobrir que a IA leia o código de quem integra. Enquanto isso, o assistente integra com modelos testados, sem que você precise fazer nada diferente.
Conecte os apps que você já usa
Se o seu projeto já trabalha com HubSpot, Shopify ou Slack, o assistente percebe isso nas dependências e oferece conectá-los ao Cord. Cada um se conecta no seu navegador, com a própria autorização, e a tela marca a conexão sozinha ao terminar. Ele também reconhece QuickBooks Online, Xero, Google Sheets e Microsoft Teams.
minha-loja — npx @flouviahq/cli
Assistente do Cord cli 2.2.0Materiais Serra Azul · teste
Conecte os apps que você já usaSeu projeto usa estes apps. Conecte-os ao Cord pelo navegador, ou depois em Configurações › Integrações.
HubSpot ✓ Conectado Clientes e orçamentos como Negócios▸ Shopify ○ Não conectado Catálogo, clientes e pedidosSlack ○ Não conectado Avisos de orçamentos e pagamentos
Os apps do seu projeto, com o status no Cord e o que cada conexão faz.
O que você ganha com cada um: com o HubSpot, seus clientes e orçamentos também ficam lá como Negócios; com o Shopify, seu catálogo, seus clientes e seus pedidos; com o Slack, um aviso no seu canal quando um cliente aprova ou paga.
Seus agentes de IA, conectados ao Cord
No final, o assistente oferece deixar o Cord nos agentes de IA da sua equipe: Claude Code, Cursor e VS Code. Com isso, o seu agente pode consultar orçamentos, clientes e pagamentos e preparar rascunhos. O que envia, cobra ou altera um cliente é aprovado por você no Cord, nunca pelo agente.
minha-loja — npx @flouviahq/cli
Assistente do Cord cli 2.2.0Materiais Serra Azul · teste
Leve o Cord aos seus agentes de IACom o MCP do Cord, seu agente consulta orçamentos, clientes e cobranças e prepara rascunhos. O que envia, cobra ou altera um cliente, você aprova no Cord.
▸ [x] Claude Code .mcp.json[x] Cursor .cursor/mcp.json[ ] VS Code .vscode/mcp.json
No Claude ou no ChatGPT, adicione um conector personalizado com https://cordhq.app/api/mcpSó o endereço é gravado: na primeira vez, o agente pede que você autorize no Cord.
Você marca os agentes da sua equipe e o assistente deixa o Cord em cada um, sem guardar nenhuma chave.
Se você prefere o Claude ou o ChatGPT, o Cord é adicionado como conector personalizado. Contamos por que conectamos o Cord aos agentes neste artigo sobre MCP.
Testar sem esperar um cliente
Para ver a integração funcionando, não é preciso que um cliente aprove um orçamento. O assistente deixa o seu servidor recebendo avisos de teste, e com um comando você dispara o mesmo aviso que o Cord enviaria quando um cliente aprova ou paga.
minha-loja — npx @flouviahq/cli
Assistente do Cord cli 2.2.0Materiais Serra Azul · teste · 2:18
O Cord está integrado
✓ Conectado a Materiais Serra Azul · modo de teste
O resumo final: o que ficou pronto, o que falta e os avisos de teste já chegando ao seu servidor.
Comece hoje
Passe isto para quem mantém o seu site:
npx @flouviahq/cli
Se você quiser o detalhe técnico, como funciona o login pelo navegador, o que a IA pode e não pode fazer e todos os comandos, está no artigo do dev blog e no guia da CLI.
Perguntas frequentes
Quem executa o assistente?
Quem mantém o seu site, seja a sua equipe ou a sua agência: executa o assistente na pasta do projeto com Node 22 ou posterior. O assistente instala o necessário, cria os arquivos e deixa um relatório com o que mudou.
Ele pode alterar a minha conta real?
Não. O terminal trabalha com chaves de teste. Se você informar o seu site e com o que trabalha, o Cord propõe a sua configuração, e essa proposta só é aplicada quando você a aprova em cordhq.app.
Com quais tecnologias ele funciona?
Next.js (App Router e Pages Router), Astro, Express, Laravel, Django, Flask e FastAPI. Se não reconhecer o framework da pasta, ele deixa você escolher.
O que acontece com as minhas senhas e chaves?
Os valores dos seus arquivos .env nunca saem do seu computador. O assistente só grava a chave de teste do projeto em um arquivo de ambiente que o git ignora, e não mexe nas outras linhas.
Tem custo?
A CLI é gratuita e é instalada pelo npm. A chave do projeto que ela cria conta como uma chave do seu plano.
Assine o Blog do Cord
Estratégias financeiras, análises de mercado e novidades do produto direto na sua caixa de entrada.
Usamos cookies essenciais para o Cord funcionar. Somente se você aceitar, medimos o uso do site com o PostHog e as visitas e o desempenho com a Vercel. Você pode mudar sua escolha quando quiser. Política de cookies