Nexus MCP 서버에 연결하기

이 문서에서는 Claude Desktop, Cursor, VS Code와 같이 MCP를 지원하는 AI 클라이언트를 Autify Nexus의 MCP 서버에 연결하는 방법을 설명합니다. MCP 서버의 개요와 제공되는 도구는 Nexus MCP 서버를 참고하세요.

사전 준비

• Nexus 원격 워크스페이스를 사용 중이어야 합니다.

• API 클라이언트를 발급할 수 있는 권한을 가진 계정이 있어야 합니다(일반적으로 워크스페이스 관리자).

• MCP를 지원하는 AI 클라이언트(Claude Desktop, Cursor, VS Code 등)가 설치되어 있어야 합니다.

1단계: API 클라이언트 시크릿 발급

MCP 서버는 Nexus의 API 클라이언트 시크릿을 Bearer 토큰으로 사용합니다. 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를 차례로 클릭하면 설정 파일이 생성·열립니다. 아래 항목을 추가하세요.

{
  "mcpServers": {
    "nexus": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<your-org-id>.cloud.autify.com/nexus/mcp",
        "--header",
        "Authorization: Bearer <your-client-secret>"
      ]
    }
  }
}

참고:

• 설정 저장 후 앱을 재시작하세요.

Cursor

설정 파일:

• 프로젝트 단위: 프로젝트 루트의 .cursor/mcp.json

• 사용자 단위(모든 프로젝트 공통): ~/.cursor/mcp.json

또는 Cursor의 Cursor Settings → MCP → Add new MCP server에서 GUI로 추가할 수도 있습니다. 아래 항목을 추가하세요.

{
  "mcpServers": {
    "nexus": {
      "url": "https://<your-org-id>.cloud.autify.com/nexus/mcp",
      "headers": {
        "Authorization": "Bearer <your-client-secret>"
      }
    }
  }
}

VS Code

설정 파일:

• 워크스페이스 단위: 워크스페이스 루트의 .vscode/mcp.json

• 사용자 단위: 사용자 settings.json의 "mcp" 섹션

또는 명령 팔레트(Cmd/Ctrl + Shift + P)에서 MCP: Add Server를 실행해 추가할 수도 있습니다. 아래 항목을 추가하세요.

{
  "mcp": {
    "servers": {
      "nexus": {
        "type": "http",
        "url": "https://<your-org-id>.cloud.autify.com/nexus/mcp",
        "headers": {
          "Authorization": "Bearer <your-client-secret>"
        }
      }
    }
  }
}

참고:

• VS Code에서 MCP 서버를 사용하려면 GitHub Copilot Chat 확장 프로그램(또는 MCP를 지원하는 동등한 확장 프로그램)이 설치되어 있어야 합니다.

4단계: 연결 확인

연결이 성공하면 AI 클라이언트에서 Nexus의 MCP 도구를 사용할 수 있게 됩니다. 첫 동작 확인에는 읽기 전용 도구인 list_workspaces가 편리합니다. AI 클라이언트에 다음과 같이 요청해 보세요.

"Nexus의 list_workspaces 도구를 실행해서 접근 가능한 워크스페이스 목록을 보여줘."

워크스페이스 목록이 돌아오면 연결이 정상적으로 이루어진 것입니다.

제한 사항

• 속도 제한: IP 주소당 초당 10 요청까지로 제한됩니다. 이를 초과하면 HTTP 429가 반환됩니다.

• 모바일 앱 테스트 관련 도구는 해당 라이선스가 있는 경우에만 사용할 수 있습니다.

• 로컬 워크스페이스에 대한 MCP 연결은 지원되지 않습니다.

문제 해결

관련 문서

• Nexus MCP 서버