Como conectar o FlipLink ao Claude com o servidor MCP

E se você pudesse simplesmente pedir ao Claude para — “transformar este PDF em um flipbook e publicá-lo” — e ele realmente fizesse isso? É exatamente isso que o servidor MCP do FlipLink para o Claude torna possível. Depois de conectado, o Claude pode criar, listar, publicar e gerenciar seus flipbooks por meio de uma conversa natural, sem precisar clicar pelo painel.

Este guia mostra todo o processo de configuração — menos de cinco minutos do começo até a primeira tarefa.

O que você vai precisar

Antes de conectar qualquer coisa, garanta que você tem:

• Node.js 18 ou mais recente — o servidor roda pelo npx, então o Node é a única dependência de runtime. (Você não instala o servidor na mão; o seu cliente de IA o inicia sob demanda.)
• Uma chave de API do FlipLink — entre em go.fliplink.me e pegue sua chave na página Subscription. Essa chave autentica cada ação que o Claude executa, então trate-a como uma senha.

É isso. Se você nunca usou um servidor model context protocol antes, vale uma leitura de dois minutos: o que é um servidor MCP.

Conecte o FlipLink ao Claude Code (um comando)

Se você usa o Claude Code, toda a configuração é um único comando. Coloque sua chave e execute:

claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcp

Isso registra o FlipLink como um servidor MCP, passa sua chave de API como variável de ambiente e diz ao Claude para iniciar o servidor pelo npx sempre que ele precisar. A flag -y deixa o npx baixar o pacote sem um prompt interativo. Reinicie sua sessão do Claude Code e as ferramentas do FlipLink ficam disponíveis.

Conecte o Claude Desktop (bloco de configuração)

O Claude Desktop (e outros clientes como o Cursor ou o Codex) usam uma configuração em JSON. Adicione uma entrada mcpServers assim:

{
  "mcpServers": {
    "fliplink": {
      "command": "npx",
      "args": ["-y", "fliplink-mcp"],
      "env": { "FLIPLINK_API_KEY": "<YOUR_KEY>", "FLIPLINK_MCP_MODE": "safe" }
    }
  }
}

Troque <YOUR_KEY> pela sua chave real, salve a configuração e reinicie o cliente. Na próxima inicialização, as ferramentas do FlipLink carregam automaticamente. O valor FLIPLINK_MCP_MODE define quais ações são permitidas — mais sobre isso abaixo.

Verifique a conexão

Antes de pedir ao Claude para fazer um trabalho de verdade, confirme que está tudo conectado. A checagem mais simples é a ferramenta de saúde de nível superior, whoami. Basta pedir ao Claude:

“Execute a ferramenta whoami do FlipLink.”

O Claude chama a ferramenta e retorna a identidade da sua conta e o tamanho máximo de upload. Se a sua chave estiver faltando ou errada, o servidor responde com instruções claras de configuração — assim, um erro confuso vira um erro que você consegue corrigir.

🚀

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.

Como é uma chamada de ferramenta

Você nunca digita o nome de uma ferramenta. Você descreve o que quer em linguagem natural, e o Claude escolhe a ferramenta certa, preenche os argumentos e a executa. As ferramentas do FlipLink são geradas direto da especificação da API e nomeadas como <noun>_<verb> — então você verá passar chamadas como flipbook_create_by_file, flipbook_publish, flipbook_set_skin ou leads_list enquanto o Claude trabalha.

Nos bastidores, cada ferramenta mapeia para um endpoint real da API do FlipLink. Se você quiser ver os formatos das requisições subjacentes, os parâmetros e um console Try-It ao vivo, a referência da API completa documenta cada uma delas — e é também de lá que vem a sua chave de API.

Sua primeira tarefa

Agora a parte divertida. Entregue um PDF ao Claude e peça:

“Crie um flipbook a partir deste PDF e chame-o de Relatório do Q3.”

O Claude chama flipbook_create_by_file, faz o upload do arquivo e devolve o ID do novo flipbook e a URL de compartilhamento. A partir daí, você pode continuar na mesma conversa:

“Agora publique e me dê o link de compartilhamento.”

O Claude encadeia flipbook_publish e flipbook_get_share_link e retorna um link que você pode enviar na hora. Sem trocar de aba, sem passos manuais — só uma conversa que produz flipbooks reais e publicados. Para a visão mais ampla do que isso desbloqueia, veja automação de flipbooks em linguagem natural.

Uma palavra sobre os modos (seguro por padrão)

O servidor MCP vem com uma proteção que você deve entender: a configuração FLIPLINK_MCP_MODE controla quais ferramentas o Claude consegue alcançar.

• readonly — 19 ferramentas, apenas leitura. O Claude pode listar e inspecionar, mas nunca alterar nada.
• safe — 79 ferramentas e o padrão. Leituras mais escritas reversíveis e controle de acesso; sem exclusões, sem ações de pagamento. Esse é o ponto de partida certo para quase todo mundo.
• full — todas as 87 ferramentas, incluindo ações destrutivas e relacionadas a dinheiro.

Mesmo no modo full, há uma segunda rede de segurança: as ferramentas de exclusão e de venda/preço nunca disparam na primeira chamada. O servidor retorna uma prévia de uma linha mais um token de confirmação de curta duração (vinculado àqueles argumentos exatos, que expira em cinco minutos), e o Claude precisa mostrar a prévia a você e chamar de novo com o token antes que qualquer coisa irreversível aconteça. Se você quiser o detalhamento completo de como essas proteções funcionam, leia as proteções de segurança do servidor MCP.

Comece a conversar com seus flipbooks

Conectar o FlipLink ao Claude transforma o gerenciamento de flipbooks em uma conversa. Um comando (ou um bloco de configuração), uma checagem rápida do whoami e você já está pedindo ao Claude para criar e publicar flipbooks por você — com segurança, com o modo safe protegendo você desde o início.

Pronto para começar? Pegue sua chave na página Subscription, execute o comando de configuração e peça ao Claude para criar seu primeiro flipbook.

Leituras relacionadas

• Visão geral do servidor MCP do FlipLink
• O que é um servidor MCP?
• Proteções de segurança do servidor MCP (readonly / safe / full)
• Automação de flipbooks em linguagem natural
• Recurso de acesso à API
• Referência da CLI do FlipLink