> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 같은 코딩 에이전트에서 워크스페이스를 관리합니다. Flow 만들기, 블록 추가, 트레이스 실행·검사, 배포까지 모두 자연어로 지시하면 됩니다.

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

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

## 토큰 받기

CLI로 로그인합니다.

```bash theme={null}
nora auth login
```

토큰은 로컬 설정 파일에 저장됩니다(위치는 [`nora auth`](/ko/cli/auth) 참고). 그 값을 아래 MCP 설정의 `NORA_TOKEN`에 넣습니다.

## 셋업

<Tabs>
  <Tab title="Claude Desktop">
    1. Claude Desktop의 MCP 설정 파일을 엽니다.
       * macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
       * Windows: `%APPDATA%\Claude\claude_desktop_config.json`
    2. Nora 서버를 추가합니다.

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

    3. Claude Desktop을 다시 켭니다. 새 채팅의 사용 가능한 도구 목록에 "nora"가 나타납니다.
  </Tab>

  <Tab title="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 도구가 채팅 사이드바에 나타납니다.
  </Tab>

  <Tab title="다른 MCP 호스트">
    MCP를 지원하는 클라이언트라면 무엇이든 연결됩니다.

    실행 명령으로 `npx -y @nora-ai/mcp-server`를 지정하고, 환경 변수 `NORA_TOKEN`에 토큰을 설정합니다. 사용 가능한 전체 명령은 [CLI 레퍼런스](/ko/cli/reference)와 동일합니다.
  </Tab>
</Tabs>

## 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**라면 코딩 에이전트도 읽기만 할 수 있고, 역할상 권한이 없는 액션([권한](/ko/settings/workspace/permissions) 참고)은 MCP로도 실행할 수 없습니다.

승인이 필요한 액션은 MCP로 실행해도 승인 절차를 그대로 거칩니다.

## 토큰 로테이션

<Note>
  MCP 토큰은 비밀번호처럼 다루세요. 토큰이 샜다면 새로 발급해 설정을
  업데이트하고, `nora auth logout`으로 로컬 자격증명 파일을 지우세요.
</Note>

1. `nora auth login`으로 다시 로그인해 새 토큰을 받습니다.
2. MCP 호스트 설정의 `NORA_TOKEN` 환경 변수를 업데이트합니다.
3. MCP 호스트를 다시 켭니다.

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

워크스페이스마다 별도 토큰으로 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" }
    }
  }
}
```

코딩 에이전트에는 두 서버가 모두 보이고, 도구 이름 앞에 서버 이름이 붙어 어느 쪽이든 골라 쓸 수 있습니다.

## 문제 해결

* **도구 목록에 nora가 안 나옴**

  Claude Desktop / Cursor 로그를 확인하세요. 대부분 `npx`가 패키지를 받지 못했거나 `NORA_TOKEN`이 설정되지 않은 경우입니다.

* **401 unauthorized**

  토큰이 삭제되었거나 만료된 경우입니다. 다시 발급하세요.

* **Permission denied**

  역할이나 권한 문제입니다. [권한](/ko/settings/workspace/permissions)을 참고하세요.