Servidor MCP de Webflow

Este servidor MCP permite a Claude interactuar con las API de Webflow.

Prerrequisitos

• Node.js (v16 o superior)

• Aplicación de escritorio Claude

• Cuenta de Webflow

• Token de API de Webflow (token de sitio o token de acceso OAuth)

Related MCP server: Webflow

Instrucciones de configuración

1. Crear un token de API de Webflow

• Inicie sesión en su cuenta de Webflow

• Vaya a Configuración del sitio > Aplicaciones e integraciones

• Generar un nuevo token de API

• Copia el valor del token (no podrás volver a verlo)

Alternativamente, también puede generar un token de acceso OAuth.

2. Configuración inicial del proyecto

Instalar dependencias:

npm install

3. Configurar variables de entorno

Cree un archivo .env para el desarrollo local (no confirme este archivo):

WEBFLOW_API_TOKEN=your-api-token

4. Configurar Claude Desktop

Abra el archivo de configuración de Claude Desktop:

Para MacOS:

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

Para Windows:

code %AppData%\Claude\claude_desktop_config.json

Agregar o actualizar la configuración:

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

Guarde el archivo y reinicie Claude Desktop.

Instalación mediante herrería

Para instalar Webflow MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Herramientas disponibles

El servidor actualmente proporciona las siguientes herramientas:

obtener_sitios

Recupera una lista de todos los sitios de Webflow accesibles para el usuario autenticado. Devuelve información detallada, incluyendo:

• Nombre para mostrar del sitio y nombre corto

• ID del sitio e ID del espacio de trabajo

• Fechas de creación, última actualización y última publicación

• URL de vista previa

• Configuración de zona horaria

• Configuración de dominios personalizados

• Configuración de localización (configuraciones regionales primarias y secundarias)

• Preferencias de recopilación de datos

obtener_sitio

Obtiene información detallada sobre un sitio Webflow específico por ID. Requiere un parámetro siteId y devuelve la misma información detallada que get_sites para un solo sitio.

obtener_colecciones

Recupera una lista de todas las colecciones de un sitio Webflow específico. Requiere un parámetro siteId y devuelve información detallada sobre cada colección, incluyendo:

• Nombre e ID de la colección

• Fechas de creación y última actualización

• Recuento de artículos

• Babosa de colección

• Configuración y ajustes de la colección

Definiciones 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[];
}

Manejo de errores

El servidor gestiona varios escenarios de error:

Errores ambientales

• Falta WEBFLOW_API_TOKEN

• Token de API no válido

Solución de problemas

Problemas comunes

Herramientas que no aparecen en Claude

• Consultar los registros de Claude Desktop

• Verifique que WEBFLOW_API_TOKEN esté configurado correctamente

• Asegúrese de que la ruta a index.js sea absoluta y correcta

Errores de autenticación

• Verifique que su token API sea válido

• Comprueba si el token tiene los permisos necesarios

• Asegúrese de que el token no haya expirado

Visualización de registros

Para ver los registros del 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

Variables de entorno

Si recibe errores de variables de entorno, verifique:

• WEBFLOW_API_TOKEN : Debe ser un token de API válido

Consideraciones de seguridad

• Mantenga su token API seguro

• No envíe credenciales al control de versiones

• Utilice variables de entorno para datos confidenciales

• Rotar regularmente los tokens API

• Supervisar el uso de la API en Webflow

• Utilice los permisos mínimos requeridos para el token API

Apoyo

Si encuentra algún problema:

• Consulte la sección de solución de problemas más arriba

• Revisar los registros de Claude Desktop

• Examinar la salida de error del servidor

• Consulte la documentación de la API de Webflow

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.