{
  "id": "cace5cd3-41c6-4a34-85f5-4d3aec474316",
  "slug": "ref/manual/content-launcher-콘텐츠-런처-mcp-연결",
  "doc_type": "ref",
  "title": "MCP 연결 — Content Launcher (콘텐츠 런처)",
  "title_en": null,
  "one_liner": " MCP 연결 MCP 연결 은 Content Launcher를 MCP 서버 로 노출해, Claude 등 MCP 클라이언트가 콘텐츠를 조회·생성하게 해 줍니다. 계정 단위 키(v0.4.0\\~) : 키는 본인 계정에 귀속되며, 본인이 멤버인 모든 워크스페이스 를 다룹니다. 워크스페이스를 고",
  "summary_bullets": [
    "Content Launcher를 MCP 서버로 노출해 Claude 등 MCP 클라이언트가 콘텐츠를 조회·생성할 수 있게 합니다",
    "v0.4.0부터 키는 워크스페이스가 아닌 계정 단위로 발급되며 본인이 멤버인 모든 워크스페이스를 다룹니다",
    "도구 실행에는 키 scope(read/write)와 해당 워크스페이스에서의 본인 역할이 모두 충족되어야 합니다",
    "사용 흐름은 키 발급 후 클라이언트에 등록하고 list_workspaces로 조회한 workspace_id를 다른 도구 호출에 전달하는 방식입니다",
    "옛 워크스페이스 귀속 키는 legacy로 계속 동작하며, 키는 발급 직후 한 번만 표시됩니다"
  ],
  "body_md": "# MCP 연결\n\n**MCP 연결** 은 Content Launcher를 **MCP 서버**로 노출해, Claude 등 MCP 클라이언트가 콘텐츠를 조회·생성하게 해 줍니다.\n\n* **계정 단위 키(v0.4.0\\~)**: 키는 본인 계정에 귀속되며, 본인이 멤버인 **모든 워크스페이스**를 다룹니다. 워크스페이스를 고르지 않고 발급합니다.\n* **권한 2-팩터**: 키 scope(read/write) + 그 워크스페이스에서 본인 역할이 **둘 다** 충족해야 도구가 실행됩니다.\n* **사용 흐름**: 키 발급 → 클라이언트(예: Claude Desktop)에 엔드포인트·키 등록 → `list_workspaces`로 접근 가능한 워크스페이스 조회 → 해당 `workspace_id`를 다른 도구 호출 인자로 전달.\n* 옛 키(워크스페이스 귀속)는 **legacy**로 계속 동작합니다. 키는 발급 직후 한 번만 표시(서버엔 해시만 저장).\n\n표준 HTTP(REST)로 같은 기능을 쓰려면 **API 연결**을 이용하세요.\n",
  "related_slugs": [],
  "faq": [
    {
      "a": "Content Launcher를 MCP 서버로 노출해 Claude 같은 MCP 클라이언트가 콘텐츠를 조회하고 생성할 수 있게 해줍니다.",
      "q": "MCP 연결이 정확히 무엇을 해주나요?"
    },
    {
      "a": "아니요, v0.4.0부터 키는 계정 단위로 발급되며 워크스페이스를 고르지 않고 발급합니다. 대신 본인이 멤버인 모든 워크스페이스를 다룰 수 있습니다.",
      "q": "키를 발급할 때 워크스페이스를 선택해야 하나요?"
    },
    {
      "a": "키의 scope(read/write)와 해당 워크스페이스에서 본인의 역할이 둘 다 충족되어야 도구가 실행됩니다. 즉 권한 확인은 2단계로 이루어집니다.",
      "q": "도구가 실행되려면 어떤 권한이 필요한가요?"
    },
    {
      "a": "먼저 키를 발급받아 클라이언트(예: Claude Desktop)에 엔드포인트와 키를 등록합니다. 이후 list_workspaces로 접근 가능한 워크스페이스를 조회하고, 해당 workspace_id를 다른 도구 호출 인자로 전달하면 됩니다.",
      "q": "실제 사용 흐름은 어떻게 되나요?"
    },
    {
      "a": "옛 워크스페이스 귀속 키는 legacy로 계속 동작하니 그대로 사용할 수 있습니다. 다만 키는 발급 직후 한 번만 표시되고 서버에는 해시만 저장된다는 점을 참고하세요.",
      "q": "예전에 발급받은 키는 이제 못 쓰나요?"
    }
  ],
  "jsonld": null,
  "keywords": [],
  "source_id": "gitbook:UzjWwGASsQFDcNaCAGUu:jRlmdwlnukH68d4ba1E2",
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "image_url": null,
  "caption": null,
  "solution_slug": null,
  "captured_at": null,
  "width": null,
  "height": null,
  "created_at": "2026-08-23T14:32:39.611542+00:00",
  "updated_at": "2026-08-28T09:47:19.775+00:00",
  "visibility": "public",
  "source_stage": "1",
  "anonymized": true,
  "source_key": "gitbook-manuals",
  "origin": "ingest",
  "locked": false,
  "locked_by": null,
  "locked_at": null,
  "gate_state": {
    "g1": {
      "hits": [],
      "pass": true
    },
    "g2": {
      "pass": false,
      "total": 15,
      "issues": [
        "본문이 짧습니다 (800자 미만)",
        "숫자·규격 같은 검증 가능한 구체가 부족합니다",
        "다른 문서와 겹치는 말이 대부분입니다",
        "핵심 요약 불릿이 3개 미만입니다",
        "Q&A 쌍이 3개 미만입니다",
        "소제목이 3개 미만이라 발췌 단위가 없습니다"
      ],
      "applies": true
    },
    "g3": {
      "pass": true,
      "required": false
    },
    "stage": "1",
    "decided_at": "2026-08-23T14:32:37.773Z"
  },
  "raw_id": "85c7085c-0785-4e17-8ee5-f02c34c692b2",
  "search_text": "MCP 연결 — Content Launcher (콘텐츠 런처)   MCP 연결 MCP 연결 은 Content Launcher를 MCP 서버 로 노출해, Claude 등 MCP 클라이언트가 콘텐츠를 조회·생성하게 해 줍니다. 계정 단위 키(v0.4.0\\~) : 키는 본인 계정에 귀속되며, 본인이 멤버인 모든 워크스페이스 를 다룹니다. 워크스페이스를 고  # MCP 연결\n\n**MCP 연결** 은 Content Launcher를 **MCP 서버**로 노출해, Claude 등 MCP 클라이언트가 콘텐츠를 조회·생성하게 해 줍니다.\n\n* **계정 단위 키(v0.4.0\\~)**: 키는 본인 계정에 귀속되며, 본인이 멤버인 **모든 워크스페이스**를 다룹니다. 워크스페이스를 고르지 않고 발급합니다.\n* **권한 2-팩터**: 키 scope(read/write) + 그 워크스페이스에서 본인 역할이 **둘 다** 충족해야 도구가 실행됩니다.\n* **사용 흐름**: 키 발급 → 클라이언트(예: Claude Desktop)에 엔드포인트·키 등록 → `list_workspaces`로 접근 가능한 워크스페이스 조회 → 해당 `workspace_id`를 다른 도구 호출 인자로 전달.\n* 옛 키(워크스페이스 귀속)는 **legacy**로 계속 동작합니다. 키는 발급 직후 한 번만 표시(서버엔 해시만 저장).\n\n표준 HTTP(REST)로 같은 기능을 쓰려면 **API 연결**을 이용하세요.\n",
  "embedding": null,
  "embedded_at": null,
  "embedding_hash": null,
  "map_x": null,
  "map_y": null,
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-mcp-연결",
  "markdown_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-mcp-연결.md"
}