Webflow MCP Server

MIT License
  • Apple

Integrations

  • Enables interaction with Webflow's APIs, providing tools to retrieve site information (get_sites, get_site) and collection details (get_collections) from a Webflow account.

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)

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.

ID: 5bfxvc3byk