--- title: "Nexus MCP 서버에 연결하기" slug: "connect-to-nexus-mcp-server" updated: 2026-05-28T01:52:56Z published: 2026-05-28T01:52:56Z canonical: "helpcenter.autify.com/connect-to-nexus-mcp-server" --- > ## Documentation Index > Fetch the complete documentation index at: https://helpcenter.autify.com/llms.txt > Use this file to discover all available pages before exploring further. # Nexus MCP 서버에 연결하기 이 문서에서는 Claude Desktop, Cursor, VS Code와 같이 MCP를 지원하는 AI 클라이언트를 Autify Nexus의 MCP 서버에 연결하는 방법을 설명합니다. MCP 서버의 개요와 제공되는 도구는 [Nexus MCP 서버](/v1/docs/ko/nexus-mcp-server)를 참고하세요. ## 사전 준비 - Nexus 원격 워크스페이스를 사용 중이어야 합니다. - API 클라이언트를 발급할 수 있는 권한을 가진 계정이 있어야 합니다(일반적으로 워크스페이스 관리자). - MCP를 지원하는 AI 클라이언트(Claude Desktop, Cursor, VS Code 등)가 설치되어 있어야 합니다. ## 1단계: API 클라이언트 시크릿 발급 MCP 서버는 Nexus의 API 클라이언트 시크릿을 Bearer 토큰으로 사용합니다. API 클라이언트 생성과 시크릿 확인 절차는 [Obtain the client secret](https://helpcenter.autify.com/apidocs/en/getting-started-with-the-autify-nexus-api#obtain-the-client-secret)를 참고하세요. ## 2단계: MCP 엔드포인트 URL 확인 MCP 서버의 접속 URL은 워크스페이스의 서버 URL 끝에 `/nexus/mcp` 경로를 붙인 형태입니다. 1. 데스크톱 앱 좌측 하단의 톱니바퀴 아이콘을 클릭해 **설정**을 엽니다. 2. **계정** 섹션에 표시된 **서버 URL**을 복사합니다. 3. 복사한 URL 끝에 `/nexus/mcp`를 붙이면 MCP 서버의 접속 주소가 됩니다. 예: `https://<organization-id>.cloud.autify.com/nexus/mcp` 이후 단계에서는 서버 URL의 서브도메인을 `<your-org-id>`, 1단계에서 발급한 API 클라이언트 시크릿을 `<your-client-secret>`로 표기합니다. 실제 설정 시에는 본인의 값으로 바꿔 넣으세요. ## 3단계: AI 클라이언트 설정 사용 중인 AI 클라이언트의 설정 파일에 MCP 서버 URL과 인증 정보를 등록합니다. ### Claude Desktop **설정 파일:** - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` Claude Desktop 메뉴에서 **Settings** → **Developer** → **Edit Config**를 차례로 클릭하면 설정 파일이 생성·열립니다. 아래 항목을 추가하세요. ```plaintext {  "mcpServers": {    "nexus": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://.cloud.autify.com/nexus/mcp",        "--header",        "Authorization: Bearer "      ]    }  } } ``` **참고:** - 설정 저장 후 앱을 재시작하세요. ### Cursor **설정 파일:** - 프로젝트 단위: 프로젝트 루트의 `.cursor/mcp.json` - 사용자 단위(모든 프로젝트 공통): `~/.cursor/mcp.json` 또는 Cursor의 **Cursor Settings** → **MCP** → **Add new MCP server**에서 GUI로 추가할 수도 있습니다. 아래 항목을 추가하세요. ```plaintext {  "mcpServers": {    "nexus": {      "url": "https://.cloud.autify.com/nexus/mcp",      "headers": {        "Authorization": "Bearer "      }    }  } } ``` ### VS Code **설정 파일:** - 워크스페이스 단위: 워크스페이스 루트의 `.vscode/mcp.json` - 사용자 단위: 사용자 `settings.json`의 `"mcp"` 섹션 또는 명령 팔레트(Cmd/Ctrl + Shift + P)에서 **MCP: Add Server**를 실행해 추가할 수도 있습니다. 아래 항목을 추가하세요. ```plaintext {  "mcp": {    "servers": {      "nexus": {        "type": "http",        "url": "https://.cloud.autify.com/nexus/mcp",        "headers": {          "Authorization": "Bearer "        }      }    }  } } ``` **참고:** - VS Code에서 MCP 서버를 사용하려면 GitHub Copilot Chat 확장 프로그램(또는 MCP를 지원하는 동등한 확장 프로그램)이 설치되어 있어야 합니다. ## 4단계: 연결 확인 연결이 성공하면 AI 클라이언트에서 Nexus의 MCP 도구를 사용할 수 있게 됩니다. 첫 동작 확인에는 읽기 전용 도구인 `list_workspaces`가 편리합니다. AI 클라이언트에 다음과 같이 요청해 보세요. > "Nexus의 `list_workspaces` 도구를 실행해서 접근 가능한 워크스페이스 목록을 보여줘." 워크스페이스 목록이 돌아오면 연결이 정상적으로 이루어진 것입니다. ## 제한 사항 - **속도 제한**: IP 주소당 초당 10 요청까지로 제한됩니다. 이를 초과하면 HTTP 429가 반환됩니다. - 모바일 앱 테스트 관련 도구는 해당 라이선스가 있는 경우에만 사용할 수 있습니다. - 로컬 워크스페이스에 대한 MCP 연결은 지원되지 않습니다. ## 문제 해결 | 증상 | 예상 원인 | 대응 방법 | | --- | --- | --- | | HTTP 403 "Invalid Request"가 반환됨 | 접속 URL의 호스트명이 API 클라이언트가 속한 조직의 서브도메인과 일치하지 않음 | URL의 `<your-org-id>` 부분이 2단계에서 확인한 서버 URL의 서브도메인과 동일한지 확인하세요. | | HTTP 429가 반환됨 | 속도 제한(IP당 초당 10 요청)을 초과함 | AI 클라이언트에서 보내는 요청 빈도를 낮추세요. | | 인증 오류(401 등)가 반환됨 | 시크릿 값이 잘못되었거나 API 클라이언트가 삭제됨 | 「API 클라이언트 관리」 화면에서 클라이언트가 존재하는지 확인하고, 필요하면 시크릿을 재발급하세요. | | Claude Desktop에서 서버가 시작되지 않음 | `npx` 명령을 찾을 수 없음(Node.js가 설치되어 있지 않음) | Node.js(권장: 최신 LTS 버전)를 설치하고, 터미널에서 `npx --version`이 정상적으로 실행되는지 확인하세요. | ## 관련 문서 - [Nexus MCP 서버](/v1/docs/ko/nexus-mcp-server)