Servidor MCP Webflow | Awesome MCP Servers

Webflow MCP Server

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 do Webflow (token do site ou token de acesso OAuth)

Instruções de Configuração

1. Crie um Token de API do Webflow

Faça login na sua conta Webflow
Navegue até Site Settings > Apps & Integrations
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. Configure as Variáveis de Ambiente

Crie um arquivo .env para desenvolvimento local (não faça commit deste arquivo):

WEBFLOW_API_TOKEN=your-api-token

4. Configure 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 Webflow MCP Server para 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 do site e nome curto
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 (locais 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.

get_collections

Recupera uma lista de todas as coleções de um site Webflow específico. Requer um parâmetro siteId e retorna informações detalhadas sobre cada coleção, incluindo:

Nome e ID da coleção
Datas de criação e última atualização
Contagem de itens
Slug da coleção
Configurações e definições da coleção

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;
}

interface WebflowCollection {
    _id: string;
    lastUpdated: string;
    createdOn: string;
    name: string;
    slug: string;
    singularName: string;
    itemCount: number;
}

interface WebflowCollectionsResponse {
    collections: WebflowCollection[];
}

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
Certifique-se de 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 tem as permissões necessárias
Certifique-se de 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