Cursor

Cursor에서 코딩할 때 스펙을 컨텍스트로.

Atrix는 Cursor용 MCP 서버입니다. .cursor/mcp.json에 URL 하나를 추가하고 로그인하면, Cursor 에이전트가 이슈의 근거가 된 스펙과 요구사항 페이지를 읽고, 이슈가 실제로 무엇을 요구하는지 확인하고, 작업이 끝나면 이슈를 다음 단계로 옮깁니다. 승인한 권한 범위 안에서만요.

7일 체험 시작요금 보기

7일 체험 · 카드 필요 · 언제든 해지 가능

.cursor/mcp.json

연결 후 할 수 있는 일

Cursor 에이전트가 Atrix에서 할 수 있는 일

2026년 10월 기준 Cursor는 관련 있을 때 MCP 도구를 사용하며, 기본적으로 호출마다 승인을 요청합니다.

  • 스펙과 요구사항을 컨텍스트로

    search, pages_list, pages_get으로 스펙, 요구사항 페이지, 결정 메모를 전부 가져옵니다. 에이전트는 바꿔 말한 내용이 아니라 합의된 내용을 기준으로 코딩합니다.

  • 브랜치의 근거가 된 이슈

    work_get_issue는 상세 내용, 최근 댓글, 상태 이력을 돌려줍니다. work_list_issues와 project_status로 제품에 남은 작업을 확인합니다.

  • 작업 마무리

    쓰기 권한이 있으면 work_set_issue_status로 이슈를 IN_REVIEW로 옮기고, work_comment_issue로 변경 사항을 남기고, work_create_issue로 에이전트가 찾은 버그를 등록합니다.

작업 관리와 문서를 서버 하나로

이슈와 그 이슈를 정의하는 페이지가 같은 Atrix 워크스페이스에 있으므로, MCP 항목 하나로 Cursor가 둘 다 볼 수 있습니다.

데이터

범위 제한, 감사 기록, 언제든 해제

Atrix는 Cursor의 도구 호출만 받으며, 코드베이스나 에이전트와의 대화는 받지 않습니다. 각 호출은 도구, 결과, 대상으로 기록되며 내용은 기록하지 않습니다.

Atrix가 읽는 데이터

  • 부여한 읽기 권한이 허용하는 것만: 작업, 프로젝트, 페이지, 아이디어, CRM, 캘린더 등
  • 거래 금액, 채용, 인사 기록은 권한 범위와 내 권한이 모두 있을 때만
  • 급여와 보상은 어떤 권한으로도 읽을 수 없습니다

Atrix가 쓰는 데이터

  • 첫 연결에서는 아무것도 쓰지 않습니다(읽기만 요청)
  • 승인한 쓰기 권한에 따라: 이슈, 댓글, 상태, 페이지 등
  • 피드 게시는 별도로 지정하는 feed.post 권한이 있을 때만

연결 방법

세 단계로 연결

로그인 대신 개인 Atrix 토큰을 쓰려면 url 옆에 "headers": { "Authorization": "Bearer ${env:ATRIX_TOKEN}" } 를 추가하세요. Cursor는 ${env:변수명}을 환경에서 읽으므로 토큰을 파일에 적지 않아도 됩니다.

  • 서버 추가 — 프로젝트에 .cursor/mcp.json(모든 프로젝트에 쓰려면 ~/.cursor/mcp.json)을 만들고 { "mcpServers": { "atrix": { "url": "https://atrix.dev/api/mcp" } } } 를 넣습니다.
  • Atrix에 로그인 — Cursor는 원격 서버의 OAuth를 지원합니다. 로그인을 요청하면 브라우저에서 워크스페이스를 고르고 읽기 권한을 승인하세요.
  • 에이전트에게 요청 — Cursor 사이드바의 Customize에서 atrix가 켜져 있는지 확인한 뒤 "이 이슈의 스펙을 읽고 구현해 줘"라고 요청하세요.
.cursor/mcp.json

플랜

Cursor는 모든 플랜에서 사용할 수 있습니다

Atrix 쪽 연결 비용은 없으며, Cursor의 도구 호출은 Atrix AI 실행 횟수를 쓰지 않습니다.

  • Builder$39/월

    역할이 허용하는 권한 범위로 Cursor를 연결하세요.

  • Studio$149/월

    15개 좌석마다 각자의 Cursor를 연결할 수 있습니다.

FAQ

자주 묻는 질문

프로젝트 설정과 전역 설정 중 무엇을 써야 하나요?

.cursor/mcp.json은 저장소와 함께 공유되므로, 저장소를 연 사람마다 자기 계정으로 로그인합니다. ~/.cursor/mcp.json은 내 컴퓨터의 모든 프로젝트에 적용됩니다.

.cursor/mcp.json을 커밋해도 안전한가요?

url만 있다면 안전합니다. OAuth 로그인 정보는 각자의 Cursor에 남습니다. 토큰을 쓴다면 ${env:ATRIX_TOKEN}으로 참조하고 파일에 직접 붙여 넣지 마세요.

에이전트가 묻지 않고 Atrix를 호출하나요?

기본적으로 Cursor는 MCP 도구를 호출하기 전마다 묻고, 인수를 확인할 수 있게 해 줍니다. 그와 별개로 Atrix는 모든 호출을 승인한 권한과 내 권한 범위로 제한합니다.

Cursor는 쓰기 권한을 어떻게 얻나요?

첫 연결은 읽기만 요청합니다. 에이전트가 쓰기 도구를 호출하면 Atrix가 필요한 권한 이름과 함께 403 insufficient_scope를 응답하고, 그 권한만 승인하면 됩니다.

호출 한도가 있나요?

네. 토큰마다 분당 호출 120회, 쓰기 30회입니다. 한도를 넘으면 Atrix가 429와 초 단위 Retry-After 헤더를 응답합니다.

더 둘러보기

이제 스펙을 채팅에 붙여 넣지 마세요.

7일 체험 중에 Cursor를 연결할 수 있습니다. 다른 클라이언트용 같은 설정은 개발자 페이지에 있습니다.

7일 체험 시작요금 보기

7일 체험 · 카드 필요 · 언제든 해지 가능