nora CLI 로도 사용 가능. MCP 는 코딩 에이전트 친화적 방법.
코딩 에이전트에서 할 수 있는 것
- Flow 생성이나 편집: “support flow 에 환불에 대해 #cx-alerts 핑하는 Slack Action 추가.”
- 데이터 소스 연결: “Drive 의 /policies 폴더를 support agent 에 붙임.”
- 디버그: “
support-flow의 최근 5개 실패 트레이스 뽑아서 요약.” - 배포: “draft 스냅샷하고 ‘refund tool cleanup’ 노트로 배포.”
- 탐색: “이 워크스페이스의 모든 Flow 나열하고 언퍼블리시 변경 있는 것 알려줘.”
셋업 — Claude Desktop
- Nora 에서 Settings → Security → API tokens 가서 New token 클릭. 복사.
- Claude Desktop 의 MCP 설정 파일 열기:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Nora 서버 추가:
- Claude Desktop 재시작. 새 채팅에서 사용 가능한 도구 아래 “nora” 가 나타남.
셋업 — Cursor
Cursor 가 같은 설정 표면으로 MCP 지원. Cursor Settings → MCP 에서 추가:셋업 — 다른 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 설정 페이지에서 언제든 로테이션; 이전 토큰이 즉시 동작 중단.
- Nora Settings 에서 새 토큰 발급.
- MCP 호스트 설정의
NORA_TOKENenv 업데이트. - MCP 호스트 재시작.
- 이전 토큰 취소.
여러 워크스페이스
워크스페이스당 하나의 MCP 서버를 별개 토큰으로 설정:트러블슈팅
“도구 목록에 nora 안 나타남” — Claude Desktop / Cursor 로그 확인. 보통npx 가 패키지 fetch 실패, 또는 NORA_TOKEN 미설정.
“401 unauthorized” — 토큰 취소되거나 만료. 재발급.
“Permission denied” — 역할이나 워크스페이스 정책 이슈. 접근 참고.
관련
noraCLI 레퍼런스 — 같은 작업, 코딩 에이전트 대신 터미널.- API 토큰 — 토큰 발급과 로테이션.
- 접근 — 토큰이 뭘 할 수 있고 못하는지.