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

# 연결하기

> 지원 클라이언트에 Remote 또는 Local MCP를 연결합니다.

## 개요

Claude, ChatGPT 데스크톱, Codex, Cursor, VS Code에 연결합니다. 보통 설치·키 관리가 없는 Remote를, 로컬 파일이나 헤드리스 환경에는 Local을 씁니다.

## 연결 선택하기

환경과 로컬 파일 필요 여부에 따라 선택합니다.

| 방법 | 용도 | 인증 | 설치 |
| - | - | - | - |
| Remote MCP | 일반 클라이언트 | 브라우저 OAuth | 불필요 |
| Local MCP | 헤드리스 또는 로컬 파일 | NoimosAI 키 | Node.js와 npm 패키지 |

> [!NOTE]
>
> Remote는 로컬 파일용 `upload_media`, `upload_website_source`, `download_creation`를 지원하지 않습니다. 필요하면 Local을 쓰세요.

## Remote 연결하기

NoimosAI 엔드포인트를 등록하고 브라우저로 접근을 허용합니다.

두 가지를 준비합니다.

* NoimosAI 계정
* Streamable HTTP와 OAuth를 지원하는 MCP 클라이언트

다음 URL을 씁니다.

```text theme={null}
https://mcp.noimosai.com/mcp
```

클라이언트별 절차를 따릅니다.

> [tab] Claude Code
>
> Claude Code에서는 다음 명령을 씁니다.
>
> ```bash theme={null}
> claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp
> ```
>
> 세션에서 `/mcp`를 실행하고 브라우저 인증 후 돌아옵니다.

> [tab] Claude.ai / Desktop
>
> Claude.ai나 Claude Desktop에서는 사용자 지정 커넥터로 등록합니다.
>
> **Settings → Connectors → Add custom connector**에서 `https://mcp.noimosai.com/mcp`를 넣고 저장한 뒤 브라우저로 로그인하고 허용합니다.

> [tab] ChatGPT Desktop
>
> ChatGPT 데스크톱에서는 MCP 서버를 등록합니다.
>
> 1. **Settings → MCP servers**에서 **Add server**를 선택합니다.
> 2. 이름 `NoimosAI`, 방식 **Streamable HTTP**, URL `https://mcp.noimosai.com/mcp`를 지정합니다.
> 3. 저장하고 **Restart**를 선택합니다.
> 4. **Authenticate**를 선택하고 브라우저에서 허용합니다.
>
> `/mcp`로 서버를 봅니다. [OpenAI 현행 가이드](https://learn.chatgpt.com/docs/extend/mcp)에 따르면 ChatGPT Web은 로컬 설정 대신 설치된 플러그인의 Remote 도구를 씁니다. 이 직접 연결은 데스크톱용입니다.

> [tab] Codex
>
> Codex CLI에서는 이 명령으로 등록하고 OAuth를 시작합니다.
>
> ```bash theme={null}
> codex mcp add noimosai --url https://mcp.noimosai.com/mcp
> codex mcp login noimosai
> ```
>
> `codex mcp list`로 등록을 봅니다. ChatGPT 데스크톱, Codex CLI, IDE 확장은 같은 Codex 호스트의 MCP 설정을 공유합니다.

> [tab] Cursor
>
> Cursor는 프로젝트의 `.cursor/mcp.json`에 추가합니다.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> MCP 설정에서 NoimosAI를 켜고 브라우저 인증을 마칩니다.

> [tab] VS Code
>
> VS Code는 워크스페이스의 `.vscode/mcp.json`에 추가합니다.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "http",
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> 서버를 시작하면 브라우저 OAuth가 열립니다.

동의 화면에서 계정과 `mcp:tools` 권한을 봅니다. 재연결하고 도구를 확인합니다.

## Local 연결하기

Local은 npm의 [`@noimosai/mcp`](https://www.npmjs.com/package/@noimosai/mcp)를 클라이언트 하위 프로세스로 실행합니다.

세 가지를 준비합니다.

* Node.js 20 이상
* STDIO 지원 클라이언트
* 팀 설정 API 탭의 키

`your-api-key`를 키로 바꿉니다. 기본 워크스페이스를 고정할 때만 `NOIMOS_WORKSPACE_ID`를 추가합니다.

> [!WARNING]
>
> 키가 있는 설정을 Git에 올리거나 공유하지 마세요. 일반 키를 쓰며 Developer Platform `nmp_` 키는 사용할 수 없습니다.

> [tab] Claude Code
>
> Claude Code에서는 다음 명령으로 추가합니다.
>
> ```bash theme={null}
> claude mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env MCP_TOOL_TIMEOUT=900000 \
>   -- npx -y @noimosai/mcp
> ```

> [tab] Claude Desktop
>
> Claude Desktop은 `claude_desktop_config.json`에 추가합니다.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] Codex
>
> Codex CLI에서는 다음 명령으로 추가합니다.
>
> ```bash theme={null}
> codex mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
>   -- npx -y @noimosai/mcp
> ```
>
> 명령 실행 폴더만 업로드·다운로드하도록 허용합니다.

> [tab] Cursor
>
> Cursor는 `.cursor/mcp.json`에 추가합니다.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> VS Code는 `.vscode/mcp.json`에 추가합니다.
>
> ```json theme={null}
> {
>   "servers": {
>     "noimosai": {
>       "type": "stdio",
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

환경 변수는 다음과 같습니다.

| 변수 | 필수 | 설명 |
| - | - | - |
| `NOIMOS_API_KEY` | 예 | 팀 API 탭에서 발급한 키입니다. |
| `NOIMOS_WORKSPACE_ID` | 아니요 | `workspaceId`을 생략했을 때 기본 워크스페이스입니다. |
| `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS` | 아니요 | 허용할 로컬 폴더이며 여러 경로는 OS 구분자로 나눕니다. |

필요한 폴더만 허용하세요. 현재 폴더만 허용하려면 실행 설정의 `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`에 절대 경로를 넣습니다.

클라이언트를 재시작하고 도구를 봅니다. `chat`, `create_workspace_and_onboard`는 수분이 걸리므로 가능하면 제한을 약 15분으로 설정합니다.

## 첫 도구 시험하기

읽기 전용 작업으로 워크스페이스와 정보를 안전하게 조회합니다.

다음 순서로 요청합니다.

1. “NoimosAI의 사용 가능한 워크스페이스를 나열해 줘.”
2. “대상 워크스페이스의 브랜드와 연결 계정을 확인해 줘.”
3. “이 정보로 LinkedIn 초안 하나를 써 줘. 게시하지 말고 본문만 보여 줘.”

처음 두 요청은 `list_workspaces`, `get_workspace_context` 같은 읽기 도구를 씁니다. 세 번째도 게시를 요청하지 않으므로 검토 후 다음 행동을 정합니다.

## 연결 문제 해결하기

연결 방식에 따라 점검합니다.

* **Remote 동의 화면 없음** — 연결을 삭제하고 다시 등록합니다.
* **Remote 도구 없음** — `mcp:tools` 권한과 워크스페이스를 봅니다.
* **Remote 토큰 만료** — 다시 허용합니다.
* **Local 시작 실패** — Node.js 20 이상, `npx`, 패키지, 키를 봅니다.
* **Local 워크스페이스 선택 실패** — `NOIMOS_WORKSPACE_ID`나 호출의 `workspaceId`을 봅니다.
* **Local 파일 접근 실패** — `NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`가 허용한 폴더인지 봅니다.

## 관련 페이지

도구와 다른 접속 방법은 다음 페이지에 있습니다.

* [도구 사용하기](https://docs.noimosai.com/ko/developers/mcp/tools.md)
* [기본 이해하기](https://docs.noimosai.com/ko/developers/cli/overview.md)
* [표준 MCP 연결 가이드](https://modelcontextprotocol.io/docs/develop/connect-local-servers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.