Respira for WordPress

이 저장소가 무엇인지, 무엇이 아닌지

이 저장소는 Respira WordPress MCP 서버의 공개 목록입니다. 서버 소스는 npm에서 @respira/wordpress-mcp-server로 배포됩니다. 해당 래퍼 코드는 MIT 라이선스이며, 읽거나 포크하거나 벤더링해도 됩니다.

서버는 Respira WordPress 플러그인의 클라이언트이며, 독립 실행형 제품이 아닙니다. 실제 작업을 하려면 다음이 필요합니다:

• 사이트에 설치된 Respira for WordPress 플러그인

• 라이선스에 연결된 유효한 Respira API 키

플러그인은 오픈 소스가 아닙니다. 상업용 라이선스로 배포됩니다. respira.press에서 무료 평가판을 제공하며, 카드가 필요 없습니다. 유료 요금제는 월 9 EUR부터 시작합니다.

요약하자면: npx -y로 실행하는 래퍼는 공개되어 있습니다. 그 뒤에 있는 제품은 공개되어 있지 않으며, 이는 의도적인 것입니다. 상업적 의존성 없이 자체적으로 "AI가 WordPress를 편집"하는 스택을 원한다면, 이것은 그런 것이 아닙니다. 플러그인은 한 사람이 풀타임으로 개발하고 유지 관리하며, 라이선스 비용이 그렇게 가능하게 합니다.

보안 보고는 SECURITY.md를 참조하세요.

Related MCP server: elementor-mcp-agent

Respira가 다른 점

대부분의 WordPress MCP 서버는 REST API를 래핑합니다. 게시물과 페이지를 만들 수 있지만, 실제 사이트가 존재하는 페이지 빌더 콘텐츠에는 접근할 수 없습니다.

Respira는 AI 에이전트가 빌더 자체 데이터 구조에 네이티브로 접근할 수 있게 해주는 WordPress 플러그인을 제공하며, 라이브 사이트에 쓰는 것을 안전하게 만드는 안전 장치도 함께 제공합니다.

빠른 시작

1. WordPress 플러그인 설치

respira.press/plugin에서 다운로드하여 WordPress에 업로드하고 활성화한 다음, Respira > API 키로 이동하여 키를 생성하세요.

2. AI 도구 연결

가장 빠른 방법은 respira.press/dashboard/mcp에서 생성된 명령을 사용하는 것입니다. 이 명령은 사이트와 키를 자동으로 채워줍니다. 수동 구성은 아래와 같습니다.

claude mcp add respira-wordpress -- npx -y @respira/wordpress-mcp-server

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

프로젝트에 .cursor/mcp.json을 생성하세요:

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

위와 동일한 형태입니다. Codex는 ~/.codex/config.toml에서 TOML을 사용합니다:

[mcp_servers.respira-wordpress]
command = "npx"
args = ["-y", "@respira/wordpress-mcp-server"]

또는 add-mcp가 도구를 감지하도록 하세요:

npx add-mcp "npx -y @respira/wordpress-mcp-server"

Respira는 OAuth를 사용하는 호스팅 원격 MCP 서버로도 실행되므로 로컬 Node 프로세스가 필요하지 않습니다. 클라이언트별 설정 지침은 respira.press/mcp에 있습니다.

3. 사이트 추가

마법사를 실행하세요:

npx @respira/wordpress-mcp-server --setup

또는 ~/.respira/config.json을 직접 작성하세요:

{
  "sites": [
    {
      "id": "my-site",
      "name": "My WordPress Site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true
    }
  ]
}

AI 도구를 다시 시작하고 편집을 시작하세요.

클라이언트 도구 제한에 부딪혔나요?

일부 MCP 클라이언트는 활성 도구 수를 제한하며, 종종 100개로 제한합니다. Respira는 그보다 훨씬 많은 도구를 광고하므로, 구성에 enabledTools를 추가하면 해당 도구만 목록에 표시됩니다:

{
  "sites": [{ "...": "..." }],
  "preferences": {
    "enabledTools": [
      "respira_read_page",
      "respira_update_page",
      "respira_list_pages",
      "respira_find_element",
      "respira_update_element",
      "respira_build_page",
      "respira_get_site_context",
      "respira_get_builder_info"
    ]
  }
}

사이트 관리 도구(respira_list_sites, respira_switch_site, respira_get_active_site)는 항상 포함됩니다. 목록에 없는 도구도 직접 호출하면 여전히 작동합니다. 필터는 광고되는 내용만 제어합니다.

그 위에 서버는 사이트가 실제로 실행하는 항목에 따라 도구 목록을 필터링합니다. WooCommerce가 없는 Divi 사이트는 상거래 도구를 볼 수 없습니다. 감지가 실패하면 열린 상태로 처리됩니다: 알 수 없는 경우 전체 목록을 받게 됩니다.

지원되는 17개 페이지 빌더

level은 빌더의 품질이 아니라 Respira의 쓰기 깊이입니다.

혼합 빌더 사이트는 사이트 단위가 아니라 페이지 단위로 처리됩니다.

도구가 다루는 범위

전체 참조는 문서에 있습니다. 도구 계열:

모든 도구는 respira_* 이름을 사용합니다. 레거시 wordpress_* 별칭은 더 이상 사용되지 않으며 제거될 예정입니다.

숫자의 의미

이 페이지의 수치는 완전히 활성화된 사이트의 카탈로그를 설명하며, 클라이언트가 나열할 내용이 아닙니다.

실제 tools/list는 319개보다 적게 반환하며, 이는 누락된 기능이 아니라 올바른 동작입니다. 서버가 사이트별로 카탈로그를 컨텍스트 필터링하므로 Bricks 도구는 Elementor 사이트에 도달하지 않고 상거래 도구는 WooCommerce 없이 숨겨집니다. 페이지 빌더가 없는 블록 테마 사이트는 핵심 도구가 약 28개 적게 표시됩니다.

Abilities 레지스트리는 컨텍스트 필터링되지 않으므로 동일한 사이트에서 능력 총계가 도구 총계를 초과하는 것이 정상입니다. 둘은 직접 비교할 수 없습니다.

번들 스킬

패키지에는 Respira의 Claude Code 스킬이 포함되어 있으며, 이는 도구를 함께 유용하게 만드는 레시피입니다: 페이지 빌더 마이그레이션(Divi에서 Bricks, Elementor에서 Gutenberg, WPBakery에서 Bricks 등), Figma-to-builder 변환, 사이트 감사, SEO 및 AEO 패스, WooCommerce 워크플로우.

npx @respira/wordpress-mcp-server install-skills

respira.press/skills에서 카탈로그를 둘러보세요.

안전

라이브 프로덕션 사이트에 쓰는 것이 핵심 문제입니다. 안전장치:

1. 모든 변경 전 스냅샷. respira_restore_snapshot으로 복원하고 respira_diff_snapshots로 비교합니다.

2. 편집 전 복제. 에이전트가 복사본에서 작업하는 동안 원본은 그대로 유지됩니다.

3. 도구별 거버넌스. 관리자는 wp-admin에서 개별 도구를 활성화하거나 비활성화할 수 있습니다. 거버넌스는 REST 경로, Abilities API 경로, WebMCP에 동일하게 적용됩니다.

4. 읽기 전용 모드. 에이전트를 사이트에 연결하고 쓰기 없이 보기만 허용합니다.

5. 활동 로그. 모든 호출이 기록되며 wp-admin과 respira_list_activity에서 읽을 수 있습니다.

WordPress AI 생태계

Respira는 공식 WordPress AI 스택과 함께 작동하며, 우회하지 않습니다.

Inhale은 Respira 계정 없이 소규모 Abilities 세트를 등록하는 무료 동반 플러그인입니다. 다른 것보다 먼저 Abilities 경로를 시도해보고 싶다면 사용해보세요.

설치 옵션

npx

npx -y @respira/wordpress-mcp-server

설치 없음, 시도해보기에 좋습니다. 단점은 npx 캐시가 중단된 설치, 분리된 외장 드라이브 또는 바이러스 백신 격리 후 자체적으로 손상될 수 있고 결과적인 ENOENT 오류가 혼란스럽다는 것입니다. 문제 해결 섹션을 참조하세요.

전역 설치(가장 안정적)

npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp

npx 캐시를 완전히 피합니다. 일상적인 사용에 더 나은 선택입니다.

CLI 옵션

환경 변수

export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"

RESPIRA_CONFIG_FILE 및 RESPIRA_CONFIG_B64는 멀티사이트 대안입니다.

상태 확인

npx @respira/wordpress-mcp-server --doctor

Node 버전, 구성 파일, 사이트 연결, 플러그인 버전, API 호환성 및 사용 가능한 업데이트를 확인하고 각 확인에 대해 실행 가능한 정보와 함께 통과 또는 실패를 보고합니다. CI 파이프라인을 위해 --json을 추가하세요.

문제 해결

전체 경로를 사용하세요:

{ "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "@respira/wordpress-mcp-server"] }

또는 npm install -g @respira/wordpress-mcp-server로 전역 설치하고 { "command": "respira-wordpress-mcp" }를 사용하세요.

1. WordPress > Respira > API Keys에서 API 키 확인

2. URL에 https://가 포함되어야 함

3. 플러그인이 활성화되어 있어야 함

4. 호스트가 REST API를 차단하는지 확인

respira_diagnose_connection은 네 가지를 모두 한 번의 호출로 보고합니다.

일부 사이트에는 /wp-json/[anything]을 가로채서 ?rest_route= 쿼리 변수 없이 index.php로 경로를 재작성하는 플러그인 또는 테마 재작성 규칙이 있습니다. 그러면 WordPress가 홈페이지로 301 리디렉션하고(체인에서 x-redirect-by: WordPress가 표시됨) MCP 서버는 JSON을 기대한 곳에서 HTML을 받게 됩니다.

서버는 이를 자동 감지하여 사이트 루트에 대해 ?rest_route=...로 호출을 재시도하고, JSON이 반환되면 세션의 나머지 기간 동안 모든 후속 호출을 동일한 방식으로 라우팅하며 첫 활성화 시 stderr 경고를 한 번 표시합니다.

재작성 섀도잉이 작동 중임을 이미 알고 있다면 forceRestRoute로 프로브를 건너뛰세요:

{
  "sites": [
    {
      "id": "my-site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true,
      "forceRestRoute": true
    }
  ]
}

respira_diagnose_connection은 두 형식을 모두 프로브하고 rest_route_fallback_worked, rest_route_fallback_active, force_rest_route_configured를 보고합니다.

1. 창만이 아니라 AI 도구를 완전히 다시 시작

2. 구성 파일의 JSON 구문 검증

3. 클라이언트의 구성 파일 위치 확인

4. npx @respira/wordpress-mcp-server --test 실행

클라이언트가 활성 도구를 제한하는 경우 위의 enabledTools를 참조하세요.

npx 캐시가 손상되었습니다. 일반적인 원인: 중단된 설치, 설치 중 분리된 외장 드라이브, 바이러스 백신 격리 또는 npx가 활성화된 동안 실행된 npm cache clean.

# 1. Switch to a global install, most stable
npm install -g @respira/wordpress-mcp-server
# then use "command": "respira-wordpress-mcp" with no npx wrapper

# 2. Or clear the npx cache and let it rebuild
npx clear-npx-cache
npx -y @respira/wordpress-mcp-server

# 3. Or clear the whole npm cache
npm cache clean --force

보안

API 키 검증은 WordPress 플러그인에서 서버 측에서 이루어집니다. MCP 서버는 자격 증명을 전달만 하며 저장하거나 검증하지 않습니다.

취약점은 security@respira.press로 보고하세요. 전체 정책은 SECURITY.md에 있습니다.

링크

• 웹사이트

• 문서

• 플러그인 다운로드

• MCP 설정

• 스킬 카탈로그

• Abilities

• WooCommerce 애드온

• 접근성 스캐너 애드온

• 지원

Respira를 찾을 수 있는 곳

라이선스

MIT © Respira