AI导哈

Webflow API交互服务器

该MCP服务器使Claude能够与Webflow的API进行交互，适用于网站内容管理和数据收集。

  • by TimKJones
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 timkjones/mcp-webflow

使用说明

Webflow MCP服务器

此MCP服务器使Claude能够与Webflow的API进行交互。

先决条件

  • Node.js（v16或更高版本）
  • 克劳德桌面应用程序
  • Webflow帐户
  • Webflow API令牌（站点令牌或OAuth访问令牌）

安装说明

1.创建Webflow API令牌

  • 登录您的Webflow帐户
  • 导航到“网站设置”>“应用程序和集成”
  • 生成新的API令牌
  • 复制令牌值（您将无法再次看到它）

或者，您还可以生成OAuth访问令牌。

2.初始项目设置

安装依赖项：

npm install

3.配置环境变量

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

WEBFLOW_API_TOKEN=your-api-token

4.配置克劳德桌面

打开您的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安装

通过以下方式自动安装克劳德桌面版Webflow MCP服务器 史密瑟里:

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

可用工具

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

get_sites

检索经过身份验证的用户可访问的所有Webflow站点的列表。返回详细信息，包括：

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

get_site

按ID检索特定Webflow站点的详细信息。需要siteId参数，并返回与单个站点的get_sites相同的详细信息。

集合

检索特定Webflow站点的所有集合的列表。需要一个siteId参数，并返回每个集合的详细信息，包括：

  • 集合名称和ID
  • 创建和最后更新日期
  • 项目计数
  • 收藏蛞蝓
  • 收集设置和配置

类型定义

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

错误处理

服务器处理各种错误情况：

环境错误

  • 缺少WEBFLOW_API_TOKEN
  • API令牌无效

故障排除

常见问题

工具未出现在Claude中

  • 检查克劳德桌面日志
  • 验证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令牌所需的最低权限

支持

如果您遇到任何问题：

  • 检查上面的故障排除部分
  • 查看克劳德桌面日志
  • 检查服务器的错误输出
  • 查看Webflow的API文档

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

相关 MCP