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

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

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

​
토큰 받기

CLI로 로그인합니다.
토큰은 로컬 설정 파일에 저장됩니다(위치는 nora auth 참고). 그 값을 아래 MCP 설정의 NORA_TOKEN에 넣습니다.

​
셋업

  1. Claude Desktop의 MCP 설정 파일을 엽니다.
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Nora 서버를 추가합니다.
  1. Claude Desktop을 다시 켭니다. 새 채팅의 사용 가능한 도구 목록에 “nora”가 나타납니다.

​
MCP가 제공하는 도구

MCP 서버는 CLI와 거의 같은 작업을 제공하고, MCP 전용 편의 도구 몇 가지를 더 지원합니다.
  • 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로 실행해도 승인 절차를 그대로 거칩니다.

​
토큰 로테이션

MCP 토큰은 비밀번호처럼 다루세요. 토큰이 샜다면 새로 발급해 설정을 업데이트하고, nora auth logout으로 로컬 자격증명 파일을 지우세요.
  1. nora auth login으로 다시 로그인해 새 토큰을 받습니다.
  2. MCP 호스트 설정의 NORA_TOKEN 환경 변수를 업데이트합니다.
  3. MCP 호스트를 다시 켭니다.

​
여러 워크스페이스 연결하기

워크스페이스마다 별도 토큰으로 MCP 서버를 하나씩 등록합니다.
코딩 에이전트에는 두 서버가 모두 보이고, 도구 이름 앞에 서버 이름이 붙어 어느 쪽이든 골라 쓸 수 있습니다.

​
문제 해결

  • 도구 목록에 nora가 안 나옴 Claude Desktop / Cursor 로그를 확인하세요. 대부분 npx가 패키지를 받지 못했거나 NORA_TOKEN이 설정되지 않은 경우입니다.
  • 401 unauthorized 토큰이 삭제되었거나 만료된 경우입니다. 다시 발급하세요.
  • Permission denied 역할이나 권한 문제입니다. 권한을 참고하세요.