JinDaGe - webflow-mcp-server MCP Details

article

README

🚀 Webflow MCP 服务器

此 MCP 服务器让 Claude 能够与 Webflow 的 API 进行交互，实现两者间的数据通信与功能调用。

🚀 快速开始

在使用 Webflow MCP 服务器前，需要满足一定的先决条件，并按照特定的步骤进行安装配置。

✨ 主要特性

当前服务器提供了以下实用工具：

get_sites

可检索与认证用户关联的所有 Webflow 站点列表，返回的详细信息涵盖站点显示名称和短名称、站点 ID 和工作区 ID、创建、最后更新和最后发布日期、预览 URL、时区设置、自定义域名配置、国际化设置（主要和次要区域）以及数据收集偏好等。

get_site

能通过 ID 检索特定 Webflow 站点的详细信息，需要提供 siteId 参数并返回相关信息。

📦 安装指南

先决条件

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

安装步骤

1. 创建 Webflow API 令牌

登录到您的 Webflow 账户。
导航到站点设置 > 应用与集成。
生成新的 API 令牌。
复制令牌值（您将无法再次看到它）。

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

2. 初始项目设置

安装依赖项：

npm install

3. 配置环境变量

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

WEBFLOW_API_TOKEN=your-api-token

4. 配置 Claude 桌面

打开您的 Claude 桌面配置文件：对于 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 桌面。

通过 Smithery 安装

要通过 Smithery 自动安装 Webflow MCP 服务器：

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

🔧 技术细节

Endpoint: /api/sites
Method: GET
Headers:
  Authorization: Bearer {token}

📚 详细文档

错误处理

HTTP 错误状态码

| 状态码 | 描述 | |--------|------| | 401 | 未授权 | | 404 | 资源未找到 | | 500 | 内部服务器错误 |

示例错误响应

{
  "error": {
    "code": "Unauthorized",
    "message": "Invalid API token"
  }
}

安全注意事项

保持您的 API 令牌安全。
不要将凭据提交到版本控制。
使用环境变量存储敏感数据。
定期轮换 API 令牌。
监控 Webflow 的 API 使用情况。
使用最小权限为 API 令牌。

支持

如果遇到问题：

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

📄 许可证

本项目采用 MIT License，有关详细信息，请参阅 LICENSE 文件。

webflow-mcp-server