---
title: "MCP 설정 참조"
description: "Alpacon MCP에서 사용할 수 있는 전송 방식과 인증 옵션을 비교하세요. 로컬 토큰 파일과 환경 변수의 우선순위, 도구 묶음 이름과 선택 방법을 확인합니다. 클라이언트를 연결하기 전에 필요한 설정을 선택하고 사용하지 않는 도구를 제외할 때 쉽게 참고할 수 있습니다."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# MCP 설정 참조

클라이언트를 연결하는 절차는 [MCP 연결 가이드](/integrate/mcp/)를 참고하세요. 여기에서 전송 방식, 토큰 설정, 도구 묶음 옵션을 확인할 수 있습니다.

## 토큰 설정

토큰은 리전, 워크스페이스 순으로 중첩된 JSON으로 저장됩니다.

```json
{
  "ap1": {
    "production": "alpat-xxxxxxxxxxxxxxxxxx",
    "staging": "alpat-xxxxxxxxxxxxxxxxxx"
  }
}
```

**기본 위치**: `~/.alpacon-mcp/token.json` (전역 파일이 없으면 `./config/token.json`으로 대체).

서버가 토큰을 찾는 **탐색 순서**는 다음과 같습니다.

1. `ALPACON_MCP_CONFIG_FILE` 환경 변수가 설정되어 있으면 해당 파일
2. 전역 설정 파일 (존재하는 경우)
3. 로컬 설정 파일 (`./config/token.json`)

  `ALPACON_MCP___TOKEN` 형태의 환경 변수(예: `ALPACON_MCP_AP1_PRODUCTION_TOKEN`)로 리전·워크스페이스별 토큰을 개별 지정할 수도 있습니다. 환경 변수가 토큰 파일보다 우선합니다.

## 전송 방식

`uvx alpacon-mcp`는 [MCP 연결 가이드](/integrate/mcp/)에서 로컬 클라이언트의 기본값으로 안내하는 **stdio** 전송 방식으로 동작합니다. 배포 형태가 다르면 다음 두 전송 방식도 선택할 수 있습니다.

- **SSE** (`alpacon-mcp-sse` 콘솔 스크립트): HTTP 기반 Server-Sent Events 방식으로, 프로세스를 직접 실행하는 대신 HTTP 엔드포인트가 필요한 로컬 네트워크 연동에 적합합니다.
- **Streamable HTTP** (`alpacon-mcp-http` 콘솔 스크립트): [MCP 연결 가이드](/integrate/mcp/)에서 설명하는 호스팅 서버가 사용하는 전송 방식입니다. 정적 토큰 파일 대신 Auth0(OAuth)로 호출자를 인증하므로, 클라이언트는 API 토큰을 로컬에 저장하는 대신 브라우저로 로그인합니다.

대부분의 개인 사용자는 [MCP 연결 가이드](/integrate/mcp/)의 기본 stdio 설정만으로 충분하며, 나머지 전송 방식은 조직이 공유 MCP 엔드포인트를 직접 운영할 때 주로 필요합니다.

## 도구 묶음 선택

로컬 서버는 기본적으로 모든 도구를 등록합니다. 클라이언트에 따라 노출할 수 있는 도구 수에 상한이 있고, 등록된 도구가 많을수록 요청마다 드는 비용도 커집니다. 실제로 쓰는 도구 묶음(toolset)만 등록하려면 `--toolsets`에 쉼표로 구분한 목록을 넘기세요.

```bash
uvx alpacon-mcp --toolsets servers,commands,webftp
```

클라이언트 설정에서는 `args`에 플래그를 추가합니다.

```json
{
  "mcpServers": {
    "alpacon": {
      "command": "uvx",
      "args": ["alpacon-mcp", "--toolsets", "servers,commands,webftp,metrics"]
    }
  }
}
```

`ALPACON_MCP_TOOLSETS` 환경 변수에도 같은 목록을 지정할 수 있으며, 둘 다 설정하면 `--toolsets`가 우선합니다. 둘 다 없으면 모든 도구를 등록합니다(`all`). SSE 전송 방식(`alpacon-mcp-sse`)도 같은 플래그를 받습니다. 호스팅 서버는 이 설정을 무시하고 항상 모든 도구를 등록합니다.

| 도구 묶음 | 등록되는 도구 |
|-----------|---------------|
| `servers` | [서버 관리](/reference/mcp/tools/servers/): 서버 목록, 노트, 에이전트 작업, 등록 토큰 |
| `commands` | [명령 실행](/reference/mcp/tools/execution/) |
| `webftp` | [파일 전송](/reference/mcp/tools/files/) |
| `system-info` | [시스템 정보·패키지](/reference/mcp/tools/system/) 페이지의 시스템 정보 도구 |
| `packages` | [시스템 정보·패키지](/reference/mcp/tools/system/) 페이지의 패키지 관리 도구 |
| `metrics` | [모니터링·알림](/reference/mcp/tools/monitoring/) 페이지의 메트릭 도구와 `get_alert_rules` |
| `alerts` | [모니터링·알림](/reference/mcp/tools/monitoring/) 페이지의 알림, 알림 규칙, 규칙 오버라이드 |
| `events` | [이벤트·웹훅](/reference/mcp/tools/events/) 페이지의 서버 이벤트 |
| `webhooks` | [이벤트·웹훅](/reference/mcp/tools/events/) 페이지의 이벤트 구독과 웹훅 |
| `audit` | [감사 로그](/reference/mcp/tools/audit/) |
| `security` | [접근 제어·승인](/reference/mcp/tools/security/) 페이지의 명령·서버·파일 ACL |
| `approvals` | [접근 제어·승인](/reference/mcp/tools/security/) 페이지의 승인 요청과 sudo 정책 |
| `iam` | [IAM·API 토큰](/reference/mcp/tools/iam/) 페이지의 IAM 사용자, 그룹, 멤버십, 애플리케이션 |
| `tokens` | [IAM·API 토큰](/reference/mcp/tools/iam/) 페이지의 API 토큰 |
| `certs` | [인증서](/reference/mcp/tools/certificates/) |

워크스페이스 도구(`list_workspaces`, `get_current_user`, [워크스페이스 설정](/reference/mcp/tools/workspace-settings/) 도구), `health_check`, [작업 세션](/reference/mcp/tools/work-sessions/) 도구, [프롬프트](/reference/mcp/prompts/)는 선택과 관계없이 항상 등록됩니다. 이들의 이름(`workspace`, `health`, `work-sessions`, `prompts`)은 목록에 넣어도 오류가 나지 않지만 아무것도 바꾸지 않습니다. 이름은 대소문자를 구분하지 않으며, 그 밖의 이름이 있으면 서버가 시작하지 않고 사용할 수 있는 이름을 담은 오류를 출력합니다.

  묶음을 좁게 고르면 그만큼 할 수 있는 일도 줄어듭니다. 프롬프트는 여전히 `execute_command`, `webftp_upload_file` 같은 도구를 쓰도록 안내하므로, `commands`나 `webftp`를 빼면 해당 단계가 "tool not found"로 실패합니다. 리소스도 해당 도구 묶음이 등록되어 있을 때만 쓸 수 있으며, `alpacon://servers/.../overview`는 `servers`가 아니라 `system-info`에 속합니다.

Source: https://docs.alpacax.com/ko/reference/mcp/configuration/