MCP 설정 참조

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

토큰 설정#

토큰은 리전, 워크스페이스 순으로 중첩된 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)

전송 방식#

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

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

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

도구 묶음 선택#

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

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

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

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

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

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