Connect Profound CMS to your AI client

Profound CMS는 호환되는 AI 클라이언트가 CMS 콘텐츠를 검색하고, 생성하고, 업데이트하고, 게시하고, 관리할 수 있도록 원격 MCP 서버를 제공합니다.

MCP 엔드포인트:

http://107.21.107.99:8081/mcp

프로덕션 환경에서는 가능한 경우 구성된 MCP URL의 HTTPS 버전을 사용하세요.

인증

Profound CMS MCP는 WorkOS OAuth를 사용합니다.

연결 방법:

1. Profound CMS 계정을 생성합니다.
2. 계정이 올바른 조직에 속해 있는지 확인합니다.
3. AI 클라이언트에 MCP 서버를 추가합니다.
4. 메시지가 표시되면 브라우저 기반 로그인을 완료합니다.

AI 클라이언트에 API 키를 복사해 입력할 필요가 없습니다. 로그인 후 클라이언트는 단기 액세스 토큰을 받고 이를 자동으로 갱신합니다.

CMS 역할에 따라 액세스 권한이 결정됩니다.

• Members는 CMS 콘텐츠를 읽을 수 있습니다.
• Editors와 administrators는 콘텐츠를 생성하고, 업데이트하고, 게시할 수 있습니다.

Claude Code

다음을 실행합니다.

claude mcp add --transport http Profound http://107.21.107.99:8081/mcp

그런 다음 Claude Code를 시작하고 브라우저 인증 절차를 완료합니다.

연결을 확인합니다.

claude mcp list

Codex CLI

다음을 실행합니다.

codex mcp add Profound --url http://107.21.107.99:8081/mcp

Codex는 서버를 처음 사용할 때 인증을 요청합니다.

다음 명령으로 연결을 확인할 수 있습니다.

codex mcp list

OpenCode

다음 파일에 아래 내용을 추가합니다.

~/.config/opencode/opencode.json

{
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "http://107.21.107.99:8081/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

그런 다음 인증합니다.

opencode mcp auth profound

연결을 확인합니다.

opencode mcp list

서버가 OAuth를 통해 연결된 상태로 표시되어야 합니다.

Cursor, Windsurf 및 기타 MCP 클라이언트

대부분의 MCP 호환 클라이언트는 표준 원격 HTTP 구성을 지원합니다.

{
  "mcpServers": {
    "profound": {
      "url": "http://107.21.107.99:8081/mcp"
    }
  }
}

Cursor, Windsurf, Claude Desktop 또는 다른 MCP 클라이언트에서 다음을 수행합니다.

1. MCP 또는 통합 설정을 엽니다.
2. 원격 HTTP MCP 서버를 추가합니다.
3. Profound MCP URL을 사용합니다.
4. 클라이언트에 OAuth 옵션이 있으면 OAuth 인증을 활성화합니다.
5. 브라우저에서 Profound CMS 로그인을 완료합니다.

클라이언트는 Streamable HTTP MCP와 OAuth를 지원해야 합니다. 로컬 서버 또는 정적 API 키만 지원하는 클라이언트는 이 서버에 직접 인증할 수 없습니다.

모든 세션을 검색으로 시작하기

연결한 후 AI 클라이언트에 사용 가능한 조직과 웹사이트를 검색하도록 요청하세요.

Profound MCP 서버만 사용하세요.

먼저 list_my_organizations를 호출하세요.
그런 다음 list_organizations를 호출하세요.
list_organizations에서 반환된 조직 ID를 사용하여 list_websites를 호출하세요.

조직 이름, 웹사이트 이름 및 웹사이트 ID를 표로 표시하세요.

모든 CMS 작업에는 website_id가 필요합니다.

사용 가능한 도구

현재 MCP 서버는 35개의 CMS 도구를 제공합니다.

조직 및 웹사이트

• list_my_organizations
• list_organizations
• list_websites

페이지

• create_page
• update_page
• delete_page
• get_page
• list_pages

라우트 바인딩

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

라우트 바인딩은 템플릿 페이지를 특정 콘텐츠 또는 매개변수 값에 연결합니다.

컴포넌트

• create_component
• update_component
• delete_component
• list_components

컴포넌트는 재사용 가능한 콘텐츠 유형과 해당 필드를 정의합니다.

블록

• create_block
• update_block
• delete_block
• get_block
• list_blocks
• publish_block

블록은 페이지에 배치되는 콘텐츠 인스턴스입니다.

동적 필드 및 Template Builder 표현식

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

이 도구들은 렌더링 시 필드 값을 계산하는 동적 fx 표현식을 관리합니다.

문서 및 변형

• create_document
• update_document
• delete_document
• get_document
• list_documents

문서는 재사용 가능한 콘텐츠 항목이며, 변형(variant)이라고도 합니다. list_documents는 메타데이터를 반환하므로 전체 콘텐츠를 가져오려면 get_document를 사용하세요.

번역

• list_document_translations
• upsert_document_translation
• delete_document_translation

각 언어마다 별도의 문서를 만드는 대신, 번역은 하나의 문서 안에 로케일 행으로 저장해야 합니다.

일반적인 CMS 워크플로

완전한 콘텐츠 워크플로는 일반적으로 다음과 같습니다.

1. 조직과 웹사이트를 검색합니다.
2. 기존 컴포넌트, 페이지, 블록 및 문서를 검토합니다.
3. 필요한 콘텐츠를 생성하거나 업데이트합니다.
4. 블록, 컴포넌트 또는 문서를 업데이트할 때 expected_version을 사용합니다.
5. 블록 또는 문서를 게시합니다.
6. 페이지 상태를 Live로 설정합니다.
7. 게시된 콘텐츠를 확인합니다.

페이지가 공개적으로 표시되려면 페이지가 라이브 상태이고 해당 콘텐츠가 게시되어 있어야 합니다.

프롬프트 예시

페이지 생성:

Profound CMS를 사용하여 웹사이트 <website_id>에 /pricing 경로의 페이지를 생성하세요.
필요한 블록을 생성하고 게시한 다음 페이지를 Live로 설정하세요.

기존 콘텐츠 업데이트:

웹사이트 <website_id>의 홈페이지를 찾으세요.
현재 블록을 읽고 히어로 헤드라인을 업데이트한 다음 변경 사항을 게시하세요.

지역화된 콘텐츠 생성:

문서 <document_id>에 프랑스어와 독일어 번역을 추가하세요.
기존 문서를 사용하고 중복 문서를 생성하는 대신 번역 행을 생성하세요.

동적 콘텐츠 사용:

템플릿 페이지의 히어로 블록에서 헤드라인이 라우트에 바인딩된 문서의 내용을 가져오도록 설정하세요.
draft_content에 수식을 넣는 대신 블록 필드 표현식을 사용하세요.

엔드투엔드 콘텐츠 워크플로

Profound CMS MCP는 다른 MCP 서버와 결합하여 완전한 워크플로를 지원할 수 있습니다.

예를 들어 다음과 같습니다.

Figma MCP + Profound CMS MCP

이를 통해 디자인 탐색, 콘텐츠 생성, CMS 작성, 지역화 및 게시를 하나의 AI 지원 워크플로로 연결할 수 있습니다.