remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows Claude to interact with Webflow's APIs to retrieve site information including site details, custom domains, localization settings, and data collection configurations.

웹플로우 MCP 서버

이 MCP 서버를 통해 Claude는 Webflow의 API와 상호 작용할 수 있습니다.

필수 조건

Node.js(v16 이상)
클로드 데스크톱 앱
웹플로우 계정
Webflow API 토큰(사이트 토큰 또는 OAuth 액세스 토큰)

설치 지침

1. Webflow API 토큰 생성

Webflow 계정에 로그인하세요
사이트 설정 > 앱 및 통합으로 이동합니다.
새로운 API 토큰 생성
토큰 값을 복사하세요(다시는 볼 수 없습니다)

혹은 OAuth 액세스 토큰을 생성할 수도 있습니다.

2. 초기 프로젝트 설정

종속성 설치:

지엑스피1

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 서버를 자동으로 설치하려면:

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 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Claude가 Webflow API와 상호 작용하여 자연어를 사용하여 사이트를 관리하고, 정보를 검색하고, 작업을 실행할 수 있도록 합니다.

Related Resources

Reddit Discussion about this server

Webflow MCP Server