연결하기

개요

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

연결 선택하기

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

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

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

Remote 연결하기

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

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

다음 URL을 씁니다.

https://mcp.noimosai.com/mcp

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

Claude Code에서는 다음 명령을 씁니다.

claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp

세션에서 /mcp를 실행하고 브라우저 인증 후 돌아옵니다.

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

ChatGPT 데스크톱에서는 MCP 서버를 등록합니다.

Settings → MCP servers에서 Add server를 선택합니다.
이름 NoimosAI, 방식 Streamable HTTP, URL https://mcp.noimosai.com/mcp를 지정합니다.
저장하고 Restart를 선택합니다.
Authenticate를 선택하고 브라우저에서 허용합니다.

/mcp로 서버를 봅니다. OpenAI 현행 가이드에 따르면 ChatGPT Web은 로컬 설정 대신 설치된 플러그인의 Remote 도구를 씁니다. 이 직접 연결은 데스크톱용입니다.

Codex CLI에서는 이 명령으로 등록하고 OAuth를 시작합니다.

codex mcp add noimosai --url https://mcp.noimosai.com/mcp
codex mcp login noimosai

codex mcp list로 등록을 봅니다. ChatGPT 데스크톱, Codex CLI, IDE 확장은 같은 Codex 호스트의 MCP 설정을 공유합니다.

Cursor는 프로젝트의 .cursor/mcp.json에 추가합니다.

{
  "mcpServers": {
    "noimosai": {
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

MCP 설정에서 NoimosAI를 켜고 브라우저 인증을 마칩니다.

VS Code는 워크스페이스의 .vscode/mcp.json에 추가합니다.

{
  "servers": {
    "noimosai": {
      "type": "http",
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

서버를 시작하면 브라우저 OAuth가 열립니다.

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

Local 연결하기

Local은 npm의 @noimosai/mcp를 클라이언트 하위 프로세스로 실행합니다. 세 가지를 준비합니다.

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

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

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

Claude Code
Claude Desktop
Codex
Cursor
VS Code

Claude Code에서는 다음 명령으로 추가합니다.

claude mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env MCP_TOOL_TIMEOUT=900000 \
  -- npx -y @noimosai/mcp

Claude Desktop은 claude_desktop_config.json에 추가합니다.

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

Codex CLI에서는 다음 명령으로 추가합니다.

codex mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
  -- npx -y @noimosai/mcp

명령 실행 폴더만 업로드·다운로드하도록 허용합니다.

Cursor는 .cursor/mcp.json에 추가합니다.

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code는 .vscode/mcp.json에 추가합니다.

{
  "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분으로 설정합니다.

첫 도구 시험하기

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

“NoimosAI의 사용 가능한 워크스페이스를 나열해 줘.”
“대상 워크스페이스의 브랜드와 연결 계정을 확인해 줘.”
“이 정보로 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가 허용한 폴더인지 봅니다.

시작하기

API

CLI

MCP 서버

개요

연결 선택하기

Remote 연결하기

Local 연결하기

첫 도구 시험하기

연결 문제 해결하기

관련 페이지

​개요

​연결 선택하기

​Remote 연결하기

​Local 연결하기

​첫 도구 시험하기

​연결 문제 해결하기

​관련 페이지

개요

연결 선택하기

Remote 연결하기

Local 연결하기

첫 도구 시험하기

연결 문제 해결하기

관련 페이지