Skip to main content
Nora는 MCP 서버를 제공합니다. Claude Code, Cursor 같은 코딩 에이전트에서 워크스페이스를 관리합니다. Flow 만들기, 블록 추가, 트레이스 실행·검사, 배포까지 모두 자연어로 지시하면 됩니다.

코딩 에이전트에서 할 수 있는 것

  • Flow 만들기·고치기: “환불 문의가 들어오면 Slack의 #고객지원-알림 채널로 알림이 가게 support flow에 추가해 줘.”
  • 데이터 소스 연결: “Drive에 있는 /policies 폴더를 support agent가 참고할 수 있게 연결해 줘.”
  • 디버그: “support-flow에서 최근에 실패한 실행 5개만 뽑아서 요약해 줘.”
  • 배포: “지금 Draft를 ‘refund tool cleanup’ 메모를 달아서 배포해 줘.”
  • 탐색: “이 워크스페이스에 있는 Flow를 전부 보여주고, 아직 배포 안 한 변경이 있는 것도 알려줘.”

연결하기

Nora의 MCP 서버는 원격 HTTP 서버입니다. 설치할 패키지가 없고, 호스트가 URL만 가리키면 됩니다.
claude mcp add 로 서버를 등록합니다. --transport http 플래그가 있어야 stdio 서브프로세스가 아닌 원격 MCP 엔드포인트로 취급됩니다.
  • --scope user 는 항목을 ~/.claude.json 에 씁니다. 모든 프로젝트에서 Nora 가 보입니다. 팀원과 git 으로 공유하고 싶다면 --scope project 를 쓰세요 (레포 안 ./.mcp.json 에 기록). --scope 를 생략하면 현재 프로젝트에만 등록됩니다.
  • 첫 툴 호출에서 브라우저로 OAuth 로그인 창이 뜹니다. Nora 계정으로 로그인해 read · build · run 에 동의합니다.
등록 확인:
나중에 지우려면 claude mcp remove nora.
CLI 방식 (Claude Code · Codex) 도 결국 수동 편집과 같은 JSON 항목을 씁니다. mcp add 명령이 더 친절한 표면일 뿐, 두 경로 사이에 동작 차이는 없습니다.

리전마다 서버를 따로

리전은 로그인할 때 정해집니다. 어느 리전 호스트로 로그인하느냐가 곧 리전 선택입니다. MCP 서버도 리전별로 호스트가 다르고 각자 따로 로그인합니다. 한 호스트는 자기 리전의 워크스페이스만 보여줍니다. 한국 워크스페이스는 미국 호스트에서 안 보이고, 그 반대도 마찬가지입니다. 리전을 넘나들려면 두 서버를 모두 등록합니다.
또는 JSON 으로:
코딩 에이전트에는 두 서버가 모두 보이고, 도구 이름 앞에 서버 이름이 붙어 어느 쪽이든 선택해 씁니다. 각 서버는 처음 쓸 때 각자 OAuth 로그인을 요구합니다.

MCP가 제공하는 도구

MCP 서버는 CLI와 거의 같은 작업을 제공합니다.
  • Flow 관리(list, get, apply, publish, rollback)
  • 블록 CRUD(agents, tools, actions, triggers, edges)
  • 데이터(documents, memory, retrieval, causal, pipelines)
  • 신뢰성(traces, feedback, approvals)
  • 워크스페이스(providers, connectors, billing)
도구마다 입력 타입이 정의되어 있어 코딩 에이전트가 알아서 찾아 씁니다.

권한

MCP는 사용자 권한을 그대로 따릅니다. Guest라면 코딩 에이전트도 읽기만 하고, 역할상 권한이 없는 액션(권한 참고)은 MCP로도 실행할 수 없습니다. 승인이 필요한 액션은 MCP로 실행해도 승인 절차를 그대로 거칩니다.

문제 해결

  • 도구 목록에 nora가 안 나옴 호스트가 서버를 못 붙인 경우입니다. URL을 확인하고, 브라우저 OAuth 로그인을 마쳤는지 보세요.
  • 로그인 창이 안 뜸 호스트 로그를 확인하세요. 원격 MCP를 지원하는 호스트인지, URL이 https://로 시작하는지 봅니다.
  • 리전 워크스페이스가 안 보임 그 리전 호스트로 서버를 따로 등록하고, 그 서버에 로그인했는지 확인하세요.

더 알아보기

nora CLI 레퍼런스

같은 작업을, 코딩 에이전트 대신 터미널에서

nora auth

CLI 로그인과 워크스페이스 전환

Nora Local 의 MCP

코딩 에이전트를 platform.nora.my 대신 자가 호스팅 Nora 에 연결합니다.