Neurium MCP 환경별 설정 가이드

Neurium MCP 서버(https://www.neurium.kr/api/mcp)를 각 Claude 환경에서 연결하는 방법을 정리합니다.

Neurium MCP는 HTTP Stateless 트랜스포트를 사용합니다. 이 방식을 네이티브로 지원하는 환경에서는 직접 연결이 가능하고, 그렇지 않은 환경에서는 mcp-remote 프록시가 필요합니다.

---

1. Claude Code CLI

직접 연결 (권장)

~/.claude.json에 아래 내용을 추가합니다:

{
  "mcpServers": {
    "neurium": {
      "type": "http",
      "url": "https://www.neurium.kr/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

또는 CLI 명령어로 한 번에 추가:

claude mcp add --transport http neurium https://www.neurium.kr/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

주의사항

설정 파일을 직접 수정할 경우 반드시 ~/.claude.json을 사용해야 합니다. ~/.claude/settings.json은 MCP 서버 설정이 아닌 권한·모델 등 UI 설정 파일이어서 여기에 넣으면 MCP 서버가 인식되지 않습니다.

• ~/.claude.json → MCP 서버, 런타임 설정 ✅
• ~/.claude/settings.json → 권한, 모델, 환경변수 등 UI 설정 ❌

설정 후 Claude Code 재시작 필요.

연결 확인:

claude mcp list
# neurium: https://www.neurium.kr/api/mcp (HTTP) - ✓ Connected

---

2. Claude Web (claude.ai)

HTTP Stateless 트랜스포트를 네이티브로 지원하므로 직접 연결 가능합니다.

1. claude.ai 접속
2. 좌측 하단 Settings → Integrations
3. Add integration 클릭
4. 아래 정보 입력:
   • URL: https://www.neurium.kr/api/mcp
   • Authentication: Authorization: Bearer YOUR_TOKEN
5. 저장 후 대화에서 Neurium 툴 사용 가능

---

3. Claude Desktop

Claude Desktop은 아직 HTTP 트랜스포트를 네이티브로 지원하지 않아 mcp-remote 프록시가 필요합니다.

설정 파일 위치

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

설정 내용:

{
  "mcpServers": {
    "neurium": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.neurium.kr/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}

사전 조건:

• Node.js 18+ 설치 필요
• mcp-remote 패키지는 npx가 자동으로 설치

설정 후 Claude Desktop 재시작.

---

환경별 비교

---

사용 가능한 툴

연결 후 아래 툴들을 Claude에서 바로 사용할 수 있습니다:

---

관련 노트

• MCP 연동 가이드
• Neurium이란?