Skip to main content
Nora 가 MCP 서버 를 제공해 코딩 에이전트 (Claude Desktop, Cursor, Codex, 다른 MCP 호스트) 가 워크스페이스 관리 가능: Flow 생성, 블록 추가, 트레이스 실행·검사, 배포 — 모두 자연어 지시로. 같은 명령이 nora CLI 로도 사용 가능. MCP 는 코딩 에이전트 친화적 방법.

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

  • Flow 생성이나 편집: “support flow 에 환불에 대해 #cx-alerts 핑하는 Slack Action 추가.”
  • 데이터 소스 연결: “Drive 의 /policies 폴더를 support agent 에 붙임.”
  • 디버그: support-flow 의 최근 5개 실패 트레이스 뽑아서 요약.”
  • 배포: “draft 스냅샷하고 ‘refund tool cleanup’ 노트로 배포.”
  • 탐색: “이 워크스페이스의 모든 Flow 나열하고 언퍼블리시 변경 있는 것 알려줘.”

셋업 — Claude Desktop

  1. Nora 에서 Settings → Security → API tokens 가서 New token 클릭. 복사.
  2. Claude Desktop 의 MCP 설정 파일 열기:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. Nora 서버 추가:
  1. Claude Desktop 재시작. 새 채팅에서 사용 가능한 도구 아래 “nora” 가 나타남.

셋업 — Cursor

Cursor 가 같은 설정 표면으로 MCP 지원. Cursor Settings → MCP 에서 추가:
Cursor 재로드. Nora 도구가 채팅 사이드바에 나타남.

셋업 — 다른 MCP 호스트

어느 MCP 가능 클라이언트든 동작. npx@nora-ai/mcp-server 를 가리키고 환경에 NORA_TOKEN 전달. 전체 명령 목록이 CLI 레퍼런스 와 매치.

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).
각 도구가 코딩 에이전트가 자동 발견하는 타입 있는 입력.

토큰 스코프

개인 API 토큰 에서 발급된 토큰은 계정 스코프 — 여러분이 속한 어느 워크스페이스든 작동 가능. 자동화에는 워크스페이스 스코프 토큰 선호: Settings → Security → API tokens → Workspace tokens. 워크스페이스 토큰은 특정 작업 (읽기 전용, 배포 안 됨 등) 으로 스코프 제한 가능. 토큰 생성 시 설정.

코딩 에이전트가 하는 것

MCP 가 여러분 권한 미러. 워크스페이스에서 Viewer 면 에이전트가 읽기만 가능. 승인 게이트 액션은 여전히 승인 플로우 거침 — 코딩 에이전트가 우회 못함. 워크스페이스 정책 (접근 참고) 도 적용. 배포가 CI 로 제한되면 인터랙티브 MCP 세션도 배포 못함.

토큰 로테이션

MCP 토큰을 패스워드처럼 다루세요. Nora 설정 페이지에서 언제든 로테이션; 이전 토큰이 즉시 동작 중단.
로테이션:
  1. Nora Settings 에서 새 토큰 발급.
  2. MCP 호스트 설정의 NORA_TOKEN env 업데이트.
  3. MCP 호스트 재시작.
  4. 이전 토큰 취소.

여러 워크스페이스

워크스페이스당 하나의 MCP 서버를 별개 토큰으로 설정:
코딩 에이전트가 둘 다 봄, 서버로 도구 이름 prefix, 어느 것이든 작동 가능.

트러블슈팅

“도구 목록에 nora 안 나타남” — Claude Desktop / Cursor 로그 확인. 보통 npx 가 패키지 fetch 실패, 또는 NORA_TOKEN 미설정. “401 unauthorized” — 토큰 취소되거나 만료. 재발급. “Permission denied” — 역할이나 워크스페이스 정책 이슈. 접근 참고.

관련