Foliyo

npx add-mcp 'https://foliyo.io/mcp'

Hospedado pela Foliyo. Faça login uma vez em cada cliente. Seus projetos salvos, remetentes, guias e públicos permanecem na sua conta. Aprove mcp workspace:write para editar páginas criadas em outros clientes; uma concessão restrita de mcp mantém seus limites existentes.

Escolha seu agente

Codex

Execute estes comandos e conclua o login no navegador:

codex mcp add foliyo --url https://foliyo.io/mcp
codex mcp login foliyo --scopes 'mcp,workspace:write'

Ou use Configurações → Servidores MCP → Adicionar servidor → HTTP Streamable. Salve, reinicie e autentique. O aplicativo de desktop, a CLI e a extensão do IDE compartilham a configuração do host.

Documentação oficial de configuração

Cursor

Adicione a .cursor/mcp.json ou ~/.cursor/mcp.json, depois habilite a Foliyo e faça login:

{
  "mcpServers": {
    "foliyo": { "url": "https://foliyo.io/mcp" }
  }
}

A CLI do Cursor compartilha esta configuração:

agent mcp login foliyo
agent mcp enable foliyo
agent mcp list-tools foliyo

Documentação do editor · Documentação da CLI

Claude Code

claude mcp add --transport http --scope user foliyo https://foliyo.io/mcp
claude mcp login foliyo

Use /mcp dentro do Claude Code para autenticar em versões mais antigas. A configuração compartilhada do projeto precisa de um tipo HTTP explícito:

{
  "mcpServers": {
    "foliyo": {
      "type": "http",
      "url": "https://foliyo.io/mcp"
    }
  }
}

Documentação oficial de configuração

Replit Agent

Adicione o servidor hospedado e aprove o login no navegador. Nenhum processo local ou chave de API é necessário.

Adicionar Foliyo ao Replit

Configuração manual: Integrações → Servidores MCP para Replit Agent → + Adicionar servidor MCP. Nomeie como Foliyo, insira https://foliyo.io/mcp e escolha Testar e salvar.

O Replit oferece suporte a OAuth para servidores personalizados e cabeçalhos personalizados nas configurações avançadas. Revise a permissão do workspace durante o consentimento.

Guia de conexão · Referência do link de instalação

Ensine ao seu agente o fluxo de trabalho da Foliyo

Instale a habilidade Foliyo e pergunte: “Crie uma proposta Foliyo para a Acme usando nosso projeto salvo.” A habilidade fornece o fluxo de trabalho; a conexão MCP fornece as ferramentas da conta.

Agente	Salve a habilidade como
Codex	.agents/skills/foliyo/SKILL.md
Cursor	.cursor/skills/foliyo/SKILL.md
Replit Agent	.agents/skills/foliyo/SKILL.md
Claude Code	.claude/skills/foliyo/SKILL.md

Estes são caminhos de projeto. Dê ao seu agente a URL da habilidade e peça para instalar o documento no diretório correspondente, ou copie o diretório completo de skills/foliyo do repositório de origem quando essa revisão estiver disponível.

01 · PREPARE

Comece com seu contexto

Seu agente carrega o projeto, remetente, guia, público e política de compartilhamento correspondentes antes de compor.

02 · CREATE

Torne o trabalho legível

Ele cria HTML estático responsivo, inclui ativos suportados e verifica o documento antes de publicar.

03 · SHARE

Obtenha um link que dura

Obtenha a URL ao vivo e o PIN quando aplicável. Recupere e atualize a origem de outro cliente autorizado, mantendo o mesmo link.

Um documento finalizado, pronto para entrega

A Foliyo publica HTML estático. CSS, imagens raster e fontes podem ser enviados como ativos base64 e incorporados. Gráficos baseados em script e telas de aplicativos precisam de uma versão estática primeiro; a Foliyo não executa aplicativos arbitrários ou serviços de backend.

Sua política de compartilhamento explícita ou salva prevalece. Sem uma, o agente pode usar um PIN gerado e informar você, ou fazer uma pergunta essencial. Um gate de e-mail não verificado registra um endereço reivindicado; ele não prova identidade. Publicar nunca implica permissão para enviar e-mails de anúncio ou atualização.

Use comandos de shell ou publique um arquivo local

Baixe a CLI autônoma da Foliyo. Ela precisa do Node 20+ e se conecta ao serviço hospedado:

curl -fsSL https://foliyo.io/cli.mjs -o foliyo.mjs
node foliyo.mjs login
node foliyo.mjs tools
node foliyo.mjs publish ./report/index.html --options publish-options.json
node foliyo.mjs doctor

Nenhuma instalação npm é necessária. Use node /absolute/path/foliyo.mjs como um comando MCP stdio, ou chame POST /api/integration/call com uma credencial Bearer e {"name":"prepare_foliyo","arguments":{}} de um shell.

A CLI de origem 0.4.0 faz a ponte para o mesmo servidor hospedado. Até que a publicação npm seja confirmada, construa-a a partir de um checkout com Node 20+:

npm --prefix mcp install
npm --prefix mcp run build
node mcp/dist/server.js login
node mcp/dist/server.js tools
node mcp/dist/server.js call brand_guide --json context.json
node mcp/dist/server.js publish ./report/index.html --options publish-options.json
node mcp/dist/server.js doctor

context.json pode conter {}. As opções de publicação podem conter {"title":"Client update","gate":"pin"}. call TOOL --json - lê stdin. Sem argumentos, a CLI inicia uma ponte stdio. Após instalar a versão 0.4.0, use foliyo no lugar de node mcp/dist/server.js.

Use PUBLISH_API_KEY para uma chave explícita e PUBLISH_API_URL para escolher um backend. Mantenha as credenciais no ambiente ou em um armazenamento de segredos.

Conecte um cliente somente stdio

Uma ponte genérica de terceiros encaminha as chamadas MCP do seu cliente para a Foliyo hospedada:

{
  "mcpServers": {
    "foliyo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://foliyo.io/mcp",
        "--transport", "http-only",
        "--static-oauth-client-metadata",
        "{\"scope\":\"mcp workspace:write\"}"]
    }
  }
}

O fluxo OAuth padrão precisa de um navegador e callback de loopback. Documentação da ponte.

Verifique a conexão

Inspecione a lista de ferramentas e peça ao seu agente para carregar o contexto da Foliyo com prepare_foliyo ou brand_guide. Faça o pré-voo de um documento pequeno, publique-o com um PIN e recupere-o com get_page. Uma atualização negada em um segundo cliente pode exigir reconexão com workspace:write.

A configuração nativa segue a documentação oficial verificada em 5 de setembro de 2026. A compatibilidade do protocolo é separada da verificação ao vivo do cliente; estas instruções não afirmam testes de ponta a ponta da UI atual do Cursor ou Replit contra esta implantação.