FlipLink CLI vs. API vs. MCP: qual integração você deve usar?

O FlipLink te dá três formas de automatizar flipbooks sem tocar no painel: uma ferramenta de linha de comando, uma API REST e um servidor MCP para assistentes de IA. Parecem três produtos diferentes, mas não são. São três portas de entrada para o mesmo motor — os mesmos endpoints, os mesmos dados, a mesma conta.

Então a pergunta de verdade não é “qual é a melhor?”. É “qual se encaixa no que você está fazendo agora?”. Este guia te dá uma comparação neutra e uma regra rápida de “escolha uma”.

Três portas de entrada, uma API

Tudo o que o FlipLink faz de forma programática passa por uma única API REST em https://go.fliplink.me, autenticada com um cabeçalho X-Api-Key. A CLI e o servidor MCP são construídos diretamente em cima dessa mesma API — na verdade, a lista de comandos da CLI e a lista de ferramentas do MCP são geradas a partir da mesma especificação de endpoints, então elas não saem de sincronia.

Isso tem uma consequência útil: o que você consegue fazer em uma, consegue fazer nas três. As diferenças são sobre quem está no comando e quanto código você quer escrever — não sobre capacidade.

Matriz de decisão

As três compartilham o mesmo modelo de resposta: cada retorno é um JSON com um Result de nível superior igual a "OK" ou "ERROR", e o mesmo limite de 300 requisições por minuto por chave.

Quando recorrer a cada uma

CLI — para scripts, terminais e CI/CD

Use a CLI quando você vive em um terminal ou em um pipeline. É o caminho mais rápido de “tenho um PDF” até “tenho um flipbook publicado” sem escrever um cliente HTTP. Coloque ela em um script shell, um cron job ou um passo do GitHub Actions e você tem automação repetível. Adicione --json a qualquer comando e mande para o jq para fazer scripting. Veja como começar com a CLI.

API — para aplicações

Use a API quando o FlipLink é um recurso dentro de algo que você está construindo — um portal de clientes que gera flipbooks no cadastro, um painel que puxa dados de captura de leads ou uma sincronização com CRM. Você tem controle total e pode chamá-la a partir de qualquer linguagem que fale HTTP. A referência da API tem todos os endpoints com um console Try-It ao vivo.

MCP — para assistentes de IA e quem não é dev

Use o servidor MCP quando a pessoa (ou o agente) que faz o trabalho não deveria precisar saber que um endpoint existe. Conecte o FlipLink ao Claude, ao Cursor ou a outro cliente MCP e você pode dizer “publique o deck do Q3 e me dê o link de compartilhamento” em linguagem comum. O assistente escolhe a ferramenta certa e preenche os parâmetros. É a opção de menor atrito para quem não programa — e vem com proteções de segurança, então ações destrutivas precisam de confirmação antes.

🚀

Experimente o FlipLink Grátis

Converta seu PDF em segundos. Sem cadastro, sem cartão de crédito — basta enviar o arquivo.

Drop your PDF here or click to browse

Máx 40MB

Os planos pagos a partir de $39 aumentam esse limite para 150 MB.

Você pode combinar todas

Elas não são mutuamente exclusivas. Uma configuração comum usa as três: a API alimenta seu app de produção, a CLI roda jobs noturnos em lote no CI, e o servidor MCP deixa seu time criar flipbooks avulsos pedindo a um assistente de IA. Mesma conta, mesmos flipbooks, mesmos dados — só portas diferentes para momentos diferentes.

A mesma tarefa, de três formas

Aqui está exatamente o mesmo resultado — criar um flipbook a partir de um PDF — por cada porta.

CLI — um comando no seu terminal:

fliplink flipbook create ./q3-report.pdf --title "Q3 Report" --name q3

API — uma requisição HTTP que você faz a partir do código:

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@q3-report.pdf' \
  -F 'Name=q3' \
  -F 'Title=Q3 Report'

MCP — linguagem natural no seu cliente de IA:

“Crie um flipbook a partir do q3-report.pdf com o título ‘Q3 Report’.”

Nos bastidores, o assistente chama a ferramenta flipbook_create_by_file com os mesmos parâmetros da requisição curl acima. As três retornam o mesmo JSON — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — porque as três acessam o mesmo endpoint.

Guia rápido de “escolha uma”

• Escrevendo um script ou um pipeline de CI/CD? → CLI
• Integrando flipbooks no seu próprio app? → API
• Quer que um assistente de IA ou alguém que não programa faça isso? → MCP
• Está em dúvida? Comece pela CLI — é o jeito mais rápido de ver resultados, e o que você aprende se aplica diretamente à API.

Seja qual for a porta por onde você entrar, você está usando o mesmo motor do FlipLink. Escolha a que combina com o jeito que você trabalha hoje — sempre dá para adicionar outra depois.

Leituras relacionadas

• Como começar com a FlipLink CLI
• Conecte o FlipLink ao Claude com um servidor MCP
• O que é um servidor MCP?
• Como usar a API do FlipLink para integrações personalizadas
• Automação e integrações
• Acesso à API