> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pleri.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP (AI 클라이언트)

> Model Context Protocol을 사용해 Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed 등에 연결하세요.

이제 저는 [Model Context Protocol (MCP)](https://modelcontextprotocol.io)을 지원합니다. 팀이 이미 사용 중인 AI 도구에 저를 바로 연결하면, 탭을 전환하지 않고도 에디터나 AI 어시스턴트에서 클라우드 위험, 보안 결과, 보안 상태를 바로 확인할 수 있습니다.

## 필요한 것

AI 클라이언트를 연결하기 전에 두 가지가 필요합니다:

<Steps>
  <Step title="Plerion API 토큰">
    Plerion 대시보드의 \*\*[설정 → API 키](https://app.plerion.com/settings/api-keys)\*\*로 이동해 새 API 키를 생성하세요.

    토큰 형식: `plerion_tak_...`

    <Warning>API 키는 비밀번호처럼 다루세요. 소스 코드에 커밋하거나 채팅에서 공유하지 마세요.</Warning>
  </Step>

  <Step title="MCP 엔드포인트 URL">
    저의 MCP 서버 주소:

    ```
    https://{region}.api.plerion.com/pleri/mcp
    ```

    `{region}`을 계정 지역으로 교체하세요 — 보통 `au`, `us`, 또는 `eu`입니다. 잘 모르겠다면 Plerion 대시보드 접속 URL을 확인하세요.
  </Step>
</Steps>

***

## AI 클라이언트 연결하기

<Tabs>
  <Tab title="Claude Code">
    Claude Code는 원격 HTTP MCP 서버를 기본으로 지원합니다. CLI를 사용하는 것이 가장 빠릅니다:

    ```bash theme={"system"}
    claude mcp add --transport http pleri \
      https://{region}.api.plerion.com/pleri/mcp \
      --header "Authorization: Bearer plerion_tak_your_key_here"
    ```

    또는 프로젝트 루트의 `.mcp.json` 파일에 직접 추가하세요 (없으면 새로 만드세요):

    ```json theme={"system"}
    {
      "mcpServers": {
        "pleri": {
          "type": "http",
          "url": "https://{region}.api.plerion.com/pleri/mcp",
          "headers": {
            "Authorization": "Bearer plerion_tak_your_key_here"
          }
        }
      }
    }
    ```

    모든 프로젝트에서 사용하려면 `~/.claude.json`의 `mcpServers` 항목에 동일한 구조로 추가하세요.

    <Tip>`claude mcp list`로 Pleri가 연결됐는지 확인하고, `claude mcp get pleri`로 설정을 확인할 수 있습니다.</Tip>
  </Tab>

  <Tab title="Claude Desktop">
    Claude Desktop은 `mcp-remote`를 통해 원격 MCP 서버에 연결합니다 (Node.js 필요).

    **1. 설정 파일 열기:**

    * macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * Windows: `%APPDATA%\Claude\claude_desktop_config.json`

    **2. Pleri MCP 서버 추가:**

    ```json theme={"system"}
    {
      "mcpServers": {
        "pleri": {
          "command": "npx",
          "args": [
            "mcp-remote@latest",
            "https://{region}.api.plerion.com/pleri/mcp",
            "--header",
            "Authorization: Bearer ${PLERION_API_KEY}"
          ],
          "env": {
            "PLERION_API_KEY": "plerion_tak_your_key_here"
          }
        }
      }
    }
    ```

    **3. Claude Desktop 재시작** — 설정 변경을 적용하려면 완전히 종료 후 다시 열어야 합니다.

    연결되면 Claude Desktop에서 MCP 도구 아이콘 아래에 Pleri가 표시됩니다.
  </Tab>

  <Tab title="Cursor">
    Cursor는 HTTP MCP를 기본 지원합니다 — 별도 래퍼가 필요 없습니다.

    **1. MCP 설정 파일 열기:**

    * 전체: `~/.cursor/mcp.json`
    * 프로젝트별: 저장소 루트의 `.cursor/mcp.json`

    또는 **설정 → Tools & Integrations → Add Custom MCP**로 이동하세요.

    **2. Pleri MCP 서버 추가:**

    ```json theme={"system"}
    {
      "mcpServers": {
        "pleri": {
          "url": "https://{region}.api.plerion.com/pleri/mcp",
          "headers": {
            "Authorization": "Bearer ${PLERION_API_KEY}"
          },
          "env": {
            "PLERION_API_KEY": "plerion_tak_your_key_here"
          }
        }
      }
    }
    ```

    Cursor는 설정 변경을 자동으로 반영합니다 — 재시작 불필요합니다.
  </Tab>

  <Tab title="VS Code">
    **GitHub Copilot** (기본 HTTP) 또는 **Cline** 확장으로 사용할 수 있습니다.

    **GitHub Copilot** — 워크스페이스의 `.vscode/mcp.json`을 열거나 새로 만드세요:

    ```json theme={"system"}
    {
      "servers": {
        "pleri": {
          "type": "http",
          "url": "https://{region}.api.plerion.com/pleri/mcp",
          "headers": {
            "Authorization": "Bearer plerion_tak_your_key_here"
          }
        }
      }
    }
    ```

    **Cline 확장** — Cline 설정의 MCP Servers에 추가:

    ```json theme={"system"}
    {
      "mcpServers": {
        "pleri": {
          "type": "streamableHttp",
          "url": "https://{region}.api.plerion.com/pleri/mcp",
          "headers": {
            "Authorization": "Bearer plerion_tak_your_key_here"
          }
        }
      }
    }
    ```

    <Tip>Claude Desktop에서 이미 설정했다면 VS Code에서 자동으로 감지할 수 있습니다. VS Code 설정에서 \*\*`chat.mcp.discovery.enabled`\*\*를 활성화하세요.</Tip>
  </Tab>

  <Tab title="Windsurf">
    **1. MCP 설정 파일 열기:**

    * macOS: `~/.codeium/windsurf/mcp_config.json`
    * Windows: `%USERPROFILE%\.codeium\windsurf\mcp_config.json`

    **2. Pleri MCP 서버 추가:**

    ```json theme={"system"}
    {
      "mcpServers": {
        "pleri": {
          "serverUrl": "https://{region}.api.plerion.com/pleri/mcp",
          "headers": {
            "Authorization": "Bearer ${env:PLERION_API_KEY}"
          }
        }
      }
    }
    ```

    `PLERION_API_KEY`를 셸 환경 변수로 설정하거나, `${env:PLERION_API_KEY}` 대신 토큰을 직접 입력하세요.

    Windsurf는 설정 변경 후 컨텍스트 서버를 자동으로 재시작합니다 — 에디터 재시작이 필요 없습니다.
  </Tab>

  <Tab title="Zed">
    Zed는 HTTP 서버 연결을 위해 `mcp-remote`를 브리지로 사용합니다 (Node.js 필요).

    **1. Zed 설정 열기** (`Cmd+,`) 후 `settings.json`에 추가:

    ```json theme={"system"}
    {
      "context_servers": {
        "pleri": {
          "source": "custom",
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://{region}.api.plerion.com/pleri/mcp",
            "--header",
            "Authorization: Bearer ${PLERION_API_KEY}"
          ],
          "env": {
            "PLERION_API_KEY": "plerion_tak_your_key_here"
          }
        }
      }
    }
    ```

    Zed는 설정을 자동으로 다시 로드합니다 — 재시작이 필요 없습니다.
  </Tab>
</Tabs>

***

## 무엇을 물어볼 수 있나요

연결되면 AI 클라이언트에서 자연스럽게 대화하세요. 이런 것들을 도와드릴 수 있습니다:

* **"지금 우리 클라우드의 주요 보안 위험이 뭐야?"**\
  Plerion 환경의 실시간 결과를 가져와 가장 중요한 것이 무엇인지 설명해 드립니다.

* **"AWS 계정에 치명적인 결과가 있어?"**\
  심각도 높은 이슈를 파악하고, 위험을 설명하며, 다음 단계를 제안합니다.

* **"최근 보안 상태 변화를 보여줘."**\
  개선된 점, 새로운 점, 팀이 확인해야 할 사항을 요약합니다.

* **"잘못 설정된 S3 버킷 수정 코드 작성 도와줘."**\
  클라우드 환경 컨텍스트와 에디터의 코드를 결합해 도움을 드립니다.

* **"SOC 2 컴플라이언스 갭이 뭐야?"**\
  현재 결과를 컴플라이언스 프레임워크에 매핑하고 누락된 항목을 표시합니다.

***

<Tip>티켓 생성, 자율적 작업 등 가장 풍부한 경험을 원하신다면 \*\*[Slack](/tools/slack)\*\*이나 \*\*[Chrome 확장](/tools/chrome)\*\*을 통해 사용하세요. MCP는 AI 워크플로에 클라우드 보안 컨텍스트를 바로 가져오는 데 최적입니다.</Tip>