Servidor MCP do FlipLink
Opere o FlipLink pelo seu assistente de IA. Deixe o Claude, o Cursor ou qualquer cliente compatível com MCP criar, configurar, publicar e gerenciar seus flipbooks em linguagem natural — com proteções integradas para qualquer ação destrutiva.
Conecte com um copiar e colar
Copie o prompt inicial no Claude Code — ele adiciona o servidor MCP do FlipLink e faz a verificação.
Substitua YOUR_API_KEY pela sua chave de API real do FlipLink.
Set up and verify the FlipLink MCP server for me.
1. Add the server to this Claude Code session by running this in the terminal:
claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -e FLIPLINK_MCP_MODE=safe -- npx -y fliplink-mcp
2. Confirm it was added: run `claude mcp list` and check that "fliplink" appears and shows as connected.
3. Verify the config: confirm the "fliplink" server has FLIPLINK_API_KEY set in its env (it must be my real
key, not the YOUR_API_KEY placeholder, and must not be empty). Reading config: `claude mcp get fliplink`.
4. Test the connection: call the FlipLink "whoami" tool. If it returns my account, the MCP is live.
5. If "fliplink" is missing or won't connect, troubleshoot:
- Ensure Node.js 18+ and npx are installed (`node -v`).
- Re-run the add command and confirm FLIPLINK_API_KEY is present and correct (not the placeholder).
- Remove and re-add: `claude mcp remove fliplink` then re-run step 1; restart the session.
- Re-run `claude mcp list` to confirm it now shows connected.
Once "whoami" succeeds, list the FlipLink tools now available to you.Funciona com suas ferramentas de IA
Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf
Instala via npx fliplink-mcp · usa sua própria chave de API · 87 tools
Como funciona
O servidor MCP do FlipLink é um pequeno programa que seu cliente de IA executa na sua máquina. Ele expõe a mesma API REST do FlipLink como tools de MCP, então o assistente pode chamá-las em linguagem natural. É uma terceira porta de entrada para a mesma API — irmã da CLI. Nada muda na API; este servidor é só mais um cliente, e todas as proteções rodam localmente antes de qualquer requisição sair da sua máquina.
Instalação
Você não instala nada à mão — seu cliente de IA inicia o servidor com o npx. Você só precisa da sua própria chave de API do FlipLink (veja abaixo).
Claude Code
claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcpClaude Desktop · Cursor · Codex
Adicione isto à configuração de MCP do cliente (um bloco mcpServers):
{
"mcpServers": {
"fliplink": {
"command": "npx",
"args": ["-y", "fliplink-mcp"],
"env": {
"FLIPLINK_API_KEY": "<YOUR_KEY_FROM_SUBSCRIPTION_PAGE>",
"FLIPLINK_MCP_MODE": "safe"
}
}
}
}Pegue sua chave de API
Cada usuário usa a própria chave — a gente nunca preenche uma por você. Faça login e copie sua chave na página de assinatura, depois cole na configuração acima como FLIPLINK_API_KEY.
Se a chave estiver faltando, toda tool retorna instruções claras de como adicioná-la — assim o assistente pode te guiar na configuração antes mesmo de você ler qualquer documentação.
Prompt inicial
Cole isto em uma nova sessão de IA para começar com um fluxo seguro:
You now have the FlipLink MCP server connected (tools like whoami,
flipbook_create_by_file, leads_list). First, call whoami to confirm my account is reachable.
If it returns an auth error, ask me to paste my FlipLink API key (I get it from
https://go.fliplink.me/Subscription) and remind me to put it in the MCP server config as
FLIPLINK_API_KEY, then stop until I confirm.
Once connected you can create, list, and configure my flipbooks. For any delete, sale/pricing,
or access-control change, show me a one-line preview and wait for my explicit "yes" before doing it.
Here's what I want to do: <describe your task>Modos
As tools são organizadas por risco, e um modo decide quais níveis ficam expostos. Defina FLIPLINK_MCP_MODE na configuração (o padrão é safe).
| Modo | Expõe | Observações |
|---|---|---|
| readonly | Apenas leitura (19 tools) | whoami, listagens, consultas |
| safe (padrão) | Leituras + escritas reversíveis + controle de acesso (79 tools) | Sem tools de exclusão ou comerciais |
| full | Tudo (87 tools) | Tools de exclusão e comerciais exigem confirmação |
Novo nesses termos? Veja o que é uma API e automação.
Modelo de segurança
No modo full, as tools destrutivas (exclusão) e financeiras (venda / preços) nunca rodam na primeira chamada. O servidor retorna uma prévia de uma linha e um confirm_token de curta duração; o assistente precisa te mostrar a prévia e chamar de novo com esse token. O token fica vinculado aos argumentos exatos e expira em 5 minutos. Essa trava fica no servidor — a API do FlipLink nunca a vê.
Toda tool também carrega anotações de MCP (readOnlyHint, destructiveHint, idempotentHint), então os clientes podem exibir as próprias telas de aprovação.
Tools
As tools são geradas a partir da spec da API e nomeadas como <noun>_<verb> — por exemplo flipbook_publish, flipbook_set_skin, leads_list, cname_add. A única tool de verificação de nível superior é whoami. Para a referência completa de parâmetros de cada endpoint subjacente, consulte a documentação da API REST.
Perguntas frequentes
- O que é um servidor MCP?
Um servidor MCP (Model Context Protocol) é um pequeno programa que seu cliente de IA roda localmente e que expõe ferramentas para o assistente. O servidor do FlipLink expõe a mesma API REST do FlipLink como ferramentas, então o Claude, o Cursor ou qualquer cliente MCP pode criar, configurar e publicar flipbooks em linguagem natural.
- Quais clientes de IA são compatíveis?
Qualquer cliente compatível com MCP — incluindo Claude Code, Claude Desktop, Cursor e Codex. Você adiciona o FlipLink à configuração
mcpServersdo cliente, e ele inicia o servidor sob demanda comnpx fliplink-mcp.- O que são os modos readonly, safe e full?
Os modos definem quais ferramentas ficam expostas. O
readonlyexpõe 19 ferramentas somente leitura; osafe(o padrão) adiciona gravações reversíveis e controle de acesso, totalizando 79 ferramentas; ofullexpõe todas as 87, com as ferramentas de exclusão e de comércio protegidas por uma etapa de confirmação. Defina o modo comFLIPLINK_MCP_MODE.- É seguro deixar uma IA gerenciar meus flipbooks?
Sim. No modo full, ações destrutivas (exclusão) e de dinheiro (venda / preços) nunca são executadas na primeira chamada — o servidor retorna uma prévia de uma linha e um token de confirmação de curta duração vinculado aos argumentos exatos, e o assistente precisa confirmar antes que qualquer coisa aconteça. As proteções rodam localmente; a API do FlipLink permanece inalterada.
- Eu preciso da minha própria chave de API?
Sim — cada usuário fornece a própria chave a partir da página de assinatura do FlipLink, definida como
FLIPLINK_API_KEYna configuração. Se a chave estiver faltando, toda ferramenta retorna instruções claras de configuração para que o assistente possa orientar você passo a passo.