MCP: 코딩 에이전트

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

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
Nora 서버를 더합니다.

{
  "mcpServers": {
    "nora": {
      "command": "npx",
      "args": ["-y", "@nora-ai/mcp-server"],
      "env": {
        "NORA_TOKEN": "your-token-here"
      }
    }
  }
}

Claude Desktop을 다시 켭니다. 새 채팅에서 쓸 수 있는 도구 아래에 “nora” 가 나옵니다.

셋업: Cursor

Cursor도 같은 설정 방식으로 MCP를 지원합니다. Cursor Settings → MCP에서 더합니다.

{
  "nora": {
    "command": "npx",
    "args": ["-y", "@nora-ai/mcp-server"],
    "env": {
      "NORA_TOKEN": "your-token-here"
    }
  }
}

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 설정 페이지에서 언제든 돌릴 수 있고, 이전 토큰은 바로 멈춥니다.

이렇게 돌립니다.

Nora Settings에서 새 토큰을 발급합니다.
MCP 호스트 설정의 NORA_TOKEN env를 업데이트합니다.
MCP 호스트를 다시 켭니다.
이전 토큰을 거둡니다.

워크스페이스 여러 개

워크스페이스마다 MCP 서버 하나를 별개 토큰으로 세웁니다.

{
  "mcpServers": {
    "nora-prod":    { "command": "npx", "args": ["-y", "@nora-ai/mcp-server"], "env": { "NORA_TOKEN": "prod-token" } },
    "nora-staging": { "command": "npx", "args": ["-y", "@nora-ai/mcp-server"], "env": { "NORA_TOKEN": "staging-token" } }
  }
}

코딩 에이전트가 둘 다 보고, 서버로 도구 이름 앞을 붙여, 어느 쪽이든 씁니다.

문제 해결

“도구 목록에 nora가 안 나옴” Claude Desktop / Cursor 로그를 보세요. 보통 npx가 패키지를 못 받았거나 NORA_TOKEN이 안 설정된 것입니다. “401 unauthorized” 토큰이 거둬졌거나 만료됐습니다. 다시 발급하세요. “Permission denied” 역할이나 워크스페이스 정책 문제입니다. 접근을 참고하세요.

시작하기

빌드

운영

설정

MCP: 코딩 에이전트

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

셋업: Claude Desktop

셋업: Cursor

셋업: 다른 MCP 호스트

MCP가 여는 도구

토큰 스코프

코딩 에이전트가 못 하는 것

토큰 로테이션

워크스페이스 여러 개

문제 해결

관련

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

​셋업: Claude Desktop

​셋업: Cursor

​셋업: 다른 MCP 호스트

​MCP가 여는 도구

​토큰 스코프

​코딩 에이전트가 못 하는 것

​토큰 로테이션

​워크스페이스 여러 개

​문제 해결

​관련

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

셋업: Claude Desktop

셋업: Cursor

셋업: 다른 MCP 호스트

MCP가 여는 도구

토큰 스코프

코딩 에이전트가 못 하는 것

토큰 로테이션

워크스페이스 여러 개

문제 해결

관련