연결 방식 Neuradex MCP 서버에 연결하는 방식은 3가지입니다. 사용하는 클라이언트에 맞게 선택하세요.
방식 인증 대상 클라이언트 OAuth 대시보드 로그인 Claude.ai, ChatGPT 등 OAuth 호환 클라이언트 Streamable HTTP 액세스 키 (Bearer 토큰) Claude Desktop, Cursor, Cline 등 STDIO 액세스 키 (환경 변수) Claude Desktop, Cline 등 로컬 실행
OAuth (추천)
Streamable HTTP
STDIO
OAuth를 지원하는 MCP 클라이언트에서는 MCP 서버 URL만 지정하면 연결할 수 있습니다. 인증은 대시보드 로그인으로 완료됩니다. 액세스 키 발급이 필요 없습니다. 호환 클라이언트 설정 절차
MCP 서버 추가
클라이언트의 MCP 설정 화면에서 다음 URL을 입력합니다.
대시보드에서 인증
연결 시 브라우저가 열리며 Neuradex 대시보드 로그인 페이지가 표시됩니다. 로그인하고 인가를 승인하면 자동으로 클라이언트로 돌아갑니다.
완료
도구 목록에 Neuradex 도구가 표시되면 연결 완료입니다.
OAuth 인증은 PKCE(S256)를 사용합니다. 토큰은 자동으로 갱신되므로 만료를 걱정할 필요가 없습니다.
MCP 서버 URL과 액세스 키를 설정하여 연결합니다. 대시보드 에서 액세스 키를 발급받으세요. Claude Desktop 설정 UI 또는 설정 파일에서 추가할 수 있습니다. Claude Desktop 설정 → MCP → 서버 추가에서 설정합니다. 항목 값 이름 Neuradex전송 방식 스트리밍 가능한 HTTP URL https://mcp.neuradex.aiBearer 토큰 환경 변수 MCP_BEARER_TOKEN
환경 변수 MCP_BEARER_TOKEN에 ndx_로 시작하는 액세스 키를 설정해 둡니다. 설정 파일을 직접 편집하는 경우: open ~/Library/Application \ Support/Claude/claude_desktop_config.json
notepad %APPDATA% \C laude \c laude_desktop_config.json
다음을 추가합니다. claude_desktop_config.json
{ "mcpServers" : { "neuradex" : { "url" : "https://mcp.neuradex.ai" , "headers" : { "Authorization" : "Bearer ndx_your_access_key_here" } } } }
Claude Desktop을 재시작하고 도구 아이콘에 “neuradex”가 표시되면 완료입니다. Cursor Cursor Settings → MCP → Add new MCP server에서 설정합니다. 항목 값 Type Streamable HTTP URL https://mcp.neuradex.aiHeaders Authorization: Bearer ndx_your_access_key_here
VS Code (Cline) Cline 확장의 MCP 설정에 추가합니다. { "cline.mcpServers" : { "neuradex" : { "url" : "https://mcp.neuradex.ai" , "headers" : { "Authorization" : "Bearer ndx_your_access_key_here" } } } }
ndx_로 시작하는 액세스 키는 대시보드 의 설정 페이지에서 발급받을 수 있습니다. 자세한 내용은 인증 설정 을 참조하세요.MCP 서버를 로컬에서 실행하고 표준 입출력(stdio)으로 연결합니다. 대시보드 에서 액세스 키를 발급받으세요. npm install -g @neuradex/mcp
pnpm add -g @neuradex/mcp
Claude Desktop claude_desktop_config.json
{ "mcpServers" : { "neuradex" : { "command" : "npx" , "args" : [ "@neuradex/mcp" ], "env" : { "NEURADEX_ACCESS_KEY" : "ndx_your_access_key_here" , "NEURADEX_API" : "https://api.neuradex.ai" } } } }
전역 설치한 경우 "command": "neuradex-mcp"로 변경하고 "args"를 빈 배열로 설정합니다.
VS Code (Cline) { "cline.mcpServers" : { "neuradex" : { "command" : "npx" , "args" : [ "@neuradex/mcp" ], "env" : { "NEURADEX_ACCESS_KEY" : "ndx_your_access_key_here" } } } }
환경 변수 변수 설명 기본값 NEURADEX_ACCESS_KEYAPI 액세스 키 (필수) NEURADEX_APIAPI 엔드포인트 https://api.neuradex.ai
셀프 호스팅 (HTTP 모드) 로컬 네트워크나 프라이빗 클라우드에서 HTTP 서버로 실행하는 경우: neuradex-mcp --mode http --port 9000
변수 설명 기본값 MCP_MODE전송 모드 (stdio / http) stdioPORTHTTP 서버 포트 9000NEURADEX_MCP_URLMCP 서버의 공개 URL (HTTP 모드) http://localhost:{PORT}
CLI 옵션 neuradex-mcp [options] 옵션: -k, --access-key < ke y > Neuradex API 액세스 키 -a, --api-url < ur l > API 엔드포인트 URL -m, --mode < mod e > 전송 모드 (stdio/http) -p, --port < por t > HTTP 서버 포트 (http 모드 전용 ) -h, --help 도움말 표시
문제 해결 MCP 서버가 인식되지 않음
Claude Desktop을 완전히 종료하고 재시작
설정 파일의 JSON 문법 확인
원격 연결의 경우 https://mcp.neuradex.ai/health에 접속하여 서버 상태 확인
인증 오류 발생
액세스 키가 ndx_ 접두사로 시작하는지 확인 (인증 참조)
대시보드 에서 키의 유효기간 및 권한 확인OAuth 사용 시 브라우저 캐시를 지우고 재인증 시도
타임아웃 발생
네트워크 연결 확인
방화벽 설정 확인
로컬 연결의 경우 NEURADEX_API 값이 올바른지 확인
세션 연결 끊김
Streamable HTTP 모드 세션은 30분간 활동이 없으면 자동으로 만료됩니다. 재연결하면 새 세션이 생성됩니다. switch_project로 설정한 활성 프로젝트는 동일한 인증 정보를 사용하는 세션 간에 공유됩니다.
다음 단계
사용 가능한 도구 MCP 서버가 제공하는 도구 상세
