> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP — 코딩 에이전트

> Claude Desktop, Cursor, MCP 지원 코딩 에이전트에서 Nora 조작.

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 서버 추가:

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

4. Claude Desktop 재시작. 새 채팅에서 사용 가능한 도구 아래 "nora" 가 나타남.

## 셋업 — Cursor

Cursor 가 같은 설정 표면으로 MCP 지원. Cursor Settings → MCP 에서 추가:

```json theme={null}
{
  "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 레퍼런스](/ko/cli/reference) 와 매치.

## 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** 면 에이전트가 읽기만 가능. 승인 게이트 액션은 여전히 승인 플로우 거침 — 코딩 에이전트가 우회 못함.

워크스페이스 정책 ([접근](/ko/settings/workspace/access) 참고) 도 적용. 배포가 CI 로 제한되면 인터랙티브 MCP 세션도 배포 못함.

## 토큰 로테이션

<Note>
  MCP 토큰을 패스워드처럼 다루세요. Nora 설정 페이지에서 언제든 로테이션; 이전 토큰이 즉시 동작 중단.
</Note>

로테이션:

1. Nora Settings 에서 새 토큰 발급.
2. MCP 호스트 설정의 `NORA_TOKEN` env 업데이트.
3. MCP 호스트 재시작.
4. 이전 토큰 취소.

## 여러 워크스페이스

워크스페이스당 하나의 MCP 서버를 별개 토큰으로 설정:

```json theme={null}
{
  "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" } }
  }
}
```

코딩 에이전트가 둘 다 봄, 서버로 도구 이름 prefix, 어느 것이든 작동 가능.

## 트러블슈팅

**"도구 목록에 nora 안 나타남"** — Claude Desktop / Cursor 로그 확인. 보통 `npx` 가 패키지 fetch 실패, 또는 `NORA_TOKEN` 미설정.

**"401 unauthorized"** — 토큰 취소되거나 만료. 재발급.

**"Permission denied"** — 역할이나 워크스페이스 정책 이슈. [접근](/ko/settings/workspace/access) 참고.

## 관련

* [`nora` CLI 레퍼런스](/ko/cli/reference) — 같은 작업, 코딩 에이전트 대신 터미널.
* [API 토큰](/ko/settings/security/api-tokens) — 토큰 발급과 로테이션.
* [접근](/ko/settings/workspace/access) — 토큰이 뭘 할 수 있고 못하는지.