Webflow

Servidor MCP Webflow

Este servidor MCP permite que o Claude interaja com as APIs do Webflow.

Pré-requisitos

• Node.js (v16 ou superior)
• Aplicativo Claude Desktop
• Conta Webflow
• Token de API Webflow (token do site ou token de acesso OAuth)

Instruções de Configuração

1. Criar um Token de API Webflow

• Faça login na sua conta Webflow
• Navegue até Configurações do Site > Apps e Integrações
• Gere um novo token de API
• Copie o valor do token (você não poderá vê-lo novamente)

Alternativamente, você também pode gerar um Token de Acesso OAuth.

2. Configuração Inicial do Projeto

Instale as dependências:

npm install

3. Configurar Variáveis de Ambiente

Crie um arquivo .env para desenvolvimento local (não envie este arquivo para o controle de versão):

WEBFLOW_API_TOKEN=your-api-token

4. Configurar o Claude Desktop

Abra o arquivo de configuração do Claude Desktop:

Para MacOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Para Windows:

code %AppData%\Claude\claude_desktop_config.json

Adicione ou atualize a configuração:

{
    "mcpServers": {
        "webflow": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/YOUR/build/index.js"
            ],
            "env": {
                "WEBFLOW_API_TOKEN": "your-api-token"
            }
        }
    }
}

Salve o arquivo e reinicie o Claude Desktop.

Instalação via Smithery

Para instalar o Servidor MCP Webflow para o Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @kapilduraphe/webflow-mcp-server --client claude

Ferramentas Disponíveis

O servidor atualmente fornece as seguintes ferramentas:

get_sites

Recupera uma lista de todos os sites Webflow acessíveis ao usuário autenticado. Retorna informações detalhadas, incluindo:

• Nome de exibição e nome curto do site
• ID do site e ID do workspace
• Datas de criação, última atualização e última publicação
• URL de pré-visualização
• Configurações de fuso horário
• Configuração de domínios personalizados
• Configurações de localização (idiomas primário e secundário)
• Preferências de coleta de dados

get_site

Recupera informações detalhadas sobre um site Webflow específico por ID. Requer um parâmetro siteId e retorna as mesmas informações detalhadas que get_sites para um único site.

Definições de Tipos

interface WebflowApiError {
    status?: number;
    message: string;
    code?: string;
}

interface WebflowCustomDomain {
    id: string;
    url: string;
    lastPublished: string;
}

interface WebflowLocale {
    id: string;
    cmsLocaleId: string;
    enabled: boolean;
    displayName: string;
    redirect: boolean;
    subdirectory: string;
    tag: string;
}

interface WebflowSite {
    id: string;
    workspaceId: string;
    createdOn: string;
    displayName: string;
    shortName: string;
    lastPublished: string;
    lastUpdated: string;
    previewUrl: string;
    timeZone: string;
    parentFolderId?: string;
    customDomains: WebflowCustomDomain[];
    locales: {
        primary: WebflowLocale;
        secondary: WebflowLocale[];
    };
    dataCollectionEnabled: boolean;
    dataCollectionType: string;
}

Tratamento de Erros

O servidor lida com vários cenários de erro:

Erros de Ambiente

• WEBFLOW_API_TOKEN ausente
• Token de API inválido

Solução de Problemas

Problemas Comuns

Ferramentas não aparecendo no Claude

• Verifique os logs do Claude Desktop
• Verifique se WEBFLOW_API_TOKEN está configurado corretamente
• Garanta que o caminho para index.js seja absoluto e correto

Erros de Autenticação

• Verifique se o seu token de API é válido
• Verifique se o token possui as permissões necessárias
• Garanta que o token não expirou

Visualizando Logs

Para visualizar os logs do servidor:

Para MacOS/Linux:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Para Windows:

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

Variáveis de Ambiente

Se você estiver recebendo erros de variáveis de ambiente, verifique:

• WEBFLOW_API_TOKEN: Deve ser um token de API válido

Considerações de Segurança

• Mantenha seu token de API seguro
• Não envie credenciais para o controle de versão
• Use variáveis de ambiente para dados sensíveis
• Rotacione os tokens de API regularmente
• Monitore o uso da API no Webflow
• Use as permissões mínimas necessárias para o token de API

Suporte

Se você encontrar algum problema:

• Verifique a seção de solução de problemas acima
• Revise os logs do Claude Desktop
• Examine a saída de erros do servidor
• Consulte a documentação da API do Webflow

Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes.