웹플로우 MCP 서버

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

필수 조건

• Node.js(v16 이상)

• 클로드 데스크톱 앱

• 웹플로우 계정

• Webflow API 토큰(사이트 토큰 또는 OAuth 액세스 토큰)

설치 지침

1. Webflow API 토큰 생성

• Webflow 계정에 로그인하세요

• 사이트 설정 > 앱 및 통합으로 이동합니다.

• 새로운 API 토큰 생성

• 토큰 값을 복사하세요(다시는 볼 수 없습니다)

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

2. 초기 프로젝트 설정

종속성 설치:

지엑스피1

3. 환경 변수 구성

로컬 개발을 위해 .env 파일을 만듭니다(이 파일을 커밋하지 마세요):

4. Claude Desktop 구성

Claude Desktop 구성 파일을 엽니다.

MacOS의 경우:

Windows의 경우:

구성을 추가하거나 업데이트합니다.

파일을 저장하고 Claude Desktop을 다시 시작하세요.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Webflow MCP 서버를 자동으로 설치하려면:

사용 가능한 도구

현재 서버는 다음과 같은 도구를 제공합니다.

get_sites

인증된 사용자가 액세스할 수 있는 모든 Webflow 사이트 목록을 검색합니다. 다음을 포함한 자세한 정보를 반환합니다.

• 사이트 표시 이름 및 약어

• 사이트 ID 및 작업 공간 ID

• 생성, 최종 업데이트 및 최종 게시 날짜

• 미리보기 URL

• 시간대 설정

• 사용자 정의 도메인 구성

• 지역화 설정(기본 및 보조 로케일)

• 데이터 수집 기본 설정

get_site

ID를 기준으로 특정 Webflow 사이트에 대한 자세한 정보를 검색합니다. siteId 매개변수가 필요하며, 단일 사이트에 대한 get_sites와 동일한 자세한 정보를 반환합니다.

유형 정의

오류 처리

서버는 다양한 오류 시나리오를 처리합니다.

환경 오류

• WEBFLOW_API_TOKEN이 없습니다

• 잘못된 API 토큰

문제 해결

일반적인 문제

Claude에 도구가 나타나지 않음

• Claude Desktop 로그 확인

• WEBFLOW_API_TOKEN이 올바르게 설정되었는지 확인하세요.

• index.js 경로가 절대적이고 올바른지 확인하세요.

인증 오류

• API 토큰이 유효한지 확인하세요

• 토큰에 필요한 권한이 있는지 확인하세요

• 토큰이 만료되지 않았는지 확인하세요

로그 보기

서버 로그를 보려면:

MacOS/Linux의 경우:

Windows의 경우:

환경 변수

환경 변수 오류가 발생하는 경우 다음을 확인하세요.

• WEBFLOW_API_TOKEN : 유효한 API 토큰이어야 합니다.

보안 고려 사항

• API 토큰을 안전하게 유지하세요

• 버전 제어에 자격 증명을 커밋하지 마세요

• 민감한 데이터에 환경 변수를 사용하세요

• API 토큰을 정기적으로 회전합니다

• Webflow에서 API 사용 모니터링

• API 토큰에 필요한 최소 권한 사용

지원하다

문제가 발생하면:

• 위의 문제 해결 섹션을 확인하세요

• Claude Desktop 로그 검토

• 서버의 오류 출력을 검사합니다.

• Webflow의 API 문서를 확인하세요

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.