Webflow MCP Server

Webflow MCP Server

此 MCP 服务可让 Claude 与 Webflow 的 API 交互。

前置条件

• Node.js（v16 或更高版本）
• Claude 桌面应用
• Webflow 账户
• Webflow API 令牌（站点令牌或 OAuth 访问令牌）

设置说明

1. 创建 Webflow API 令牌

• 登录 Webflow 账户
• 前往 Site Settings > Apps & Integrations
• 生成新的 API 令牌
• 复制令牌值（之后将无法再次查看）

或者，你也可以生成 OAuth 访问令牌。

2. 初始项目设置

安装依赖项：

npm install

3. 配置环境变量

为本地开发创建 .env 文件（不要提交此文件）：

WEBFLOW_API_TOKEN=your-api-token

4. 配置 Claude Desktop

打开 Claude Desktop 配置文件：

对于 MacOS：

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

对于 Windows：

code %AppData%\Claude\claude_desktop_config.json

添加或更新配置：

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

保存文件并重启 Claude Desktop。

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Webflow MCP Server：

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

可用工具

该服务目前提供以下工具：

get_sites

获取已通过身份验证的用户有权访问的所有 Webflow 站点列表。返回详细信息，包括：

• 站点显示名称和简称
• 站点 ID 和工作区 ID
• 创建日期、上次更新日期和上次发布日期
• 预览 URL
• 时区设置
• 自定义域名配置
• 本地化设置（主要和次要区域设置）
• 数据收集偏好设置

get_site

根据 ID 获取特定 Webflow 站点的详细信息。需要 siteId 参数；返回该单个站点与 get_sites 相同的详细信息。

类型定义

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

错误处理

该服务会处理各种错误情况：

环境错误

• 缺少 WEBFLOW_API_TOKEN
• API 令牌无效

故障排除

常见问题

工具未显示在 Claude 中

• 检查 Claude Desktop 日志
• 确认 WEBFLOW_API_TOKEN 设置正确
• 确保 index.js 的路径是绝对路径且正确

身份验证错误

• 确认 API 令牌有效
• 检查令牌是否具有必要权限
• 确保令牌尚未过期

查看日志

查看服务日志：

对于 MacOS/Linux：

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

对于 Windows：

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

环境变量

如果遇到环境变量错误，请确认：

• WEBFLOW_API_TOKEN：应为有效的 API 令牌

安全注意事项

• 妥善保管 API 令牌
• 不要将凭据提交到版本控制系统
• 使用环境变量存储敏感数据
• 定期轮换 API 令牌
• 在 Webflow 中监控 API 使用情况
• 为 API 令牌设置最低限度的必要权限

支持

如果遇到任何问题：

• 查看上方的故障排除部分
• 查看 Claude Desktop 日志
• 检查服务的错误输出
• 查看 Webflow 的 API 文档

许可证

MIT 许可证——详情请参阅 LICENSE 文件。