Como usar o FlipLink no Cursor e em outros clientes MCP

Se você já vive dentro do Cursor, não precisa sair do seu editor para trabalhar com o FlipLink. Ao adicionar o servidor MCP do FlipLink, a IA integrada do Cursor consegue criar flipbooks, publicá-los, puxar leads e muito mais — bastando pedir em linguagem natural. A mesma config funciona no Claude Desktop, no Codex e em qualquer outra ferramenta que fale o Model Context Protocol.

Este guia mostra a configuração no Cursor e, em seguida, apresenta a config genérica que funciona em todo cliente MCP.

O que é um cliente MCP

Um cliente MCP é qualquer aplicativo que consegue se conectar a servidores MCP e deixar a IA dele usar as ferramentas que esses servidores expõem. Cursor, Claude Desktop e Codex são todos clientes MCP. O Model Context Protocol é o padrão aberto que permite que eles conversem com um servidor como o fliplink-mcp sem nenhum código de integração personalizado.

Quando você conecta o servidor MCP do FlipLink, o cliente o inicia em segundo plano e a IA ganha um conjunto de ferramentas do FlipLink — coisas como flipbook_create_by_file, flipbook_publish e leads_list. Novo no conceito? Comece com o que é um servidor MCP e depois volte aqui.

Onde fica a config MCP do Cursor

O Cursor gerencia os servidores MCP nas configurações dele. Abra as configurações do Cursor, encontre a seção MCP / Model Context Protocol e escolha adicionar um novo servidor MCP. O Cursor permite que você cole uma definição de servidor como JSON — o mesmo formato mcpServers que todo cliente MCP usa.

Você não instala nada manualmente. O cliente executa o servidor com npx sob demanda, então os únicos pré-requisitos são o Node.js 18+ e uma chave de API do FlipLink. Pegue uma chave fazendo login em go.fliplink.me e abrindo a página Subscription.

O bloco do servidor FlipLink

Nas configurações MCP do Cursor, adicione um servidor MCP usando esta entrada mcpServers. Substitua <YOUR_KEY> pela sua chave de API do FlipLink:

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

Algumas observações sobre esse bloco:

• command + args dizem ao cliente para iniciar o servidor com npx — sem precisar de instalação global.
• FLIPLINK_API_KEY autentica cada chamada. Trate-a como uma senha; mantenha-a fora de repositórios compartilhados.
• FLIPLINK_MCP_MODE controla quantas ferramentas ficam expostas. O safe (o padrão) dá leituras mais escritas reversíveis e controles de acesso — sem exclusões nem ações de comércio. Use readonly para uma configuração de só olhar, sem mexer, ou full para tudo. Veja os modos de segurança do MCP para a explicação completa.

Depois de salvar, reinicie o Cursor (ou recarregue o servidor MCP nas configurações) para que ele capte a nova entrada.

Teste: peça ao Cursor para chamar o whoami

A forma mais rápida de confirmar que a conexão funciona é a ferramenta de verificação de saúde. No chat do Cursor, peça:

Use o MCP do FlipLink e chame o whoami.

A ferramenta whoami é a verificação de conta de nível superior. Se a sua chave for válida, você receberá de volta a identidade da sua conta e o seu tamanho máximo de upload. Se a chave estiver faltando ou estiver errada, a ferramenta retorna instruções claras de configuração em vez de um erro enigmático — essa é a sua deixa para corrigir o valor de FLIPLINK_API_KEY e reiniciar.

Assim que o whoami funcionar, experimente algo de verdade:

Crie um flipbook a partir de ./deck.pdf com o título "Q3 Report" e depois me dê o link de compartilhamento.

A IA do Cursor vai chamar flipbook_create_by_file e flipbook_get_share_link por você, sem nenhuma chamada de API manual.

🚀

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.

Outros clientes usam a mesma config

A beleza do MCP é que a config é genérica. O bloco mcpServers exato acima funciona no Claude Desktop, no Codex e em qualquer outro cliente MCP — só muda o menu onde você o cola. Em cada cliente, procure as configurações de MCP ou Model Context Protocol e adicione um servidor usando esse mesmo formato JSON.

Se o seu cliente oferecer uma opção de transporte stdio, é essa que você deve escolher: o fliplink-mcp se comunica via stdio, que é exatamente o que command + args configuram. Não há nada específico do FlipLink no transporte — é a config stdio padrão que todo servidor MCP usa.

Para o Claude Code especificamente, você pode pular o JSON por completo e rodar um comando:

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

Um passo a passo dedicado a esse cliente está em conectar o FlipLink ao Claude com MCP.

FAQ de solução de problemas

P: O servidor do FlipLink não aparece no Cursor. E agora? R: Primeiro confirme que o Node.js 18+ está instalado (node --version), já que o npx precisa dele. Depois confira de novo se o JSON é válido — uma vírgula ou um colchete faltando descarta o servidor silenciosamente. Por fim, reinicie o cliente por completo para que ele releia a config.

P: As ferramentas aparecem, mas cada chamada falha com uma mensagem de configuração. R: Isso significa que a chave de API não está chegando ao servidor. Verifique se FLIPLINK_API_KEY está definida no bloco env e se o valor é a sua chave real da página Subscription. Salve e reinicie depois de editar.

P: Por que a IA não consegue excluir um flipbook ou rodar uma ação de venda? R: Você está no modo safe, que oculta ferramentas destrutivas e de comércio por padrão. Mude o FLIPLINK_MCP_MODE para full para habilitá-las — mas observe que ações de exclusão e de dinheiro ainda exigem uma etapa de confirmação antes de rodar. Veja os modos de segurança do MCP.

Para finalizar

Adicionar o FlipLink ao Cursor leva um bloco JSON e um reinício. Depois que estiver tudo conectado, a IA do seu editor cuida da criação, da publicação e da exportação de leads dos flipbooks por linguagem natural — e a mesma config se encaixa direto em qualquer outro cliente MCP que você use.

Leituras relacionadas

• O servidor MCP do FlipLink — lista completa de ferramentas, modos e detalhes de segurança
• O que é um servidor MCP?
• Conecte o FlipLink ao Claude com MCP
• Modos de segurança do MCP (readonly / safe / full)
• Documentação do FlipLink CLI
• Referência da API