🔗 다른 AI와 함께 쓰기 — Claude·Cursor·ChatGPT 연동 (MCP)

내가 매일 쓰는 AI가 Neurium의 내 노트를 직접 읽고 쓸 수 있습니다. 어느 AI와 얘기했든, 지식은 한곳에 모입니다.

Claude와 아이디어를 나누고, Cursor로 코딩하고, ChatGPT에게 질문하더라도 — 그 결과가 흩어지지 않습니다. 각 AI가 Neurium에 연결되면, 대화가 곧 내 노트가 되고, 내가 쌓아온 지식이 어느 AI에서든 배경이 됩니다.

MCP가 뭔가요?

MCP(Model Context Protocol) 는 AI를 외부 도구·데이터에 연결하는 표준 규격입니다. Neurium은 이 표준을 따르는 서버를 열어두었기 때문에, MCP를 지원하는 AI라면 어디서든 같은 방식으로 내 지식 베이스에 연결할 수 있습니다.

준비물: API 키 발급 (모든 클라이언트 공통)

설정(Settings) → API Key 로 이동
새 API Key 발급 → nrm_... 형태의 키가 딱 한 번만 표시됩니다. 바로 복사해 안전한 곳에 보관하세요.
아래 모든 예시에서 <YOUR_KEY> 자리에 이 키를 넣습니다. 인증은 언제나 헤더 한 줄입니다:

Authorization: Bearer <YOUR_KEY>

서버 주소(모두 동일): https://www.neurium.kr/api/mcp
전송 방식: Streamable HTTP (로컬 설치 불필요, 클라우드 서버 직접 연결)

클라이언트별 설정

Claude Code (CLI)

터미널에 한 줄이면 끝납니다.

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

연결 확인:

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

Cursor

~/.cursor/mcp.json(전역) 또는 프로젝트 .cursor/mcp.json에 아래 블록을 넣습니다.

{
  "mcpServers": {
    "neurium": {
      "url": "https://www.neurium.kr/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

키를 파일에 직접 두기 싫다면 "Bearer ${env:NEURIUM_API_KEY}" 처럼 환경변수로 참조할 수 있습니다.
Cursor는 "Add to Cursor" 원클릭 설치 딥링크(설치 배지)도 지원합니다 — 배지를 누르면 위 설정이 자동으로 추가됩니다.

Claude Desktop / claude.ai (웹)

앱 UI에서 연결합니다.

Settings → Connectors → Add custom connector
URL: https://www.neurium.kr/api/mcp
Request headers 에서 헤더 추가 — Name: authorization, Value: Bearer <YOUR_KEY>
- ⚠️ "Bearer " (뒤 공백 포함) 접두사까지 값에 직접 입력하세요. 자동으로 붙지 않습니다.
추가 후, 채팅에서 커넥터를 활성화하면 사용 가능합니다.

참고 — 헤더 인증 방식은 현재 점진 출시(베타) 중이라 계정에 아직 안 보일 수 있습니다. Claude Desktop은 이 경우 mcp-remote 프록시로 우회할 수 있고(Neurium MCP 환경별 설정 가이드 참고), claude.ai 웹은 로컬 프록시를 못 띄우므로 헤더 옵션이 노출될 때까지 기다리거나 향후 OAuth 지원을 이용해야 합니다.

그 밖의 도구 — 한 줄 요약

VS Code (GitHub Copilot, Agent 모드): .vscode/mcp.json에 "type": "http" + url + Authorization 헤더. 키를 ${input:...}로 받으면 평문 없이 안전하게 저장됩니다.
Windsurf: ~/.codeium/windsurf/mcp_config.json에 등록. 필드명이 url이 아니라 serverUrl 인 점만 주의.
Gemini CLI: ~/.gemini/settings.json의 mcpServers에 등록. URL 필드명이 httpUrl 입니다(url은 다른 용도).
Codex CLI: ~/.codex/config.toml에 [mcp_servers.neurium] + url + bearer_token_env_var = "NEURIUM_API_KEY". 환경변수 이름을 넣습니다(키 값이 아니라).
ChatGPT (웹/데스크톱): Developer mode를 켠 뒤 Connectors(Apps)에서 서버 추가 → 인증 방식으로 API key를 고르고 키 입력. 채팅마다 커넥터를 다시 켜야 하는 점만 유의.

전체 클라이언트 대조표:

클라이언트	설정 위치	핵심 포인트
Claude Code (CLI)	`~/.claude.json`	`claude mcp add` 한 줄
Cursor	`~/.cursor/mcp.json`	`url` + `headers`, 설치 딥링크 지원
Claude Desktop	Settings → Connectors	Request headers(베타), `mcp-remote` 폴백 가능
claude.ai (웹)	Settings → Connectors	Request headers(베타), 로컬 폴백 불가
VS Code (Copilot)	`.vscode/mcp.json`	`"type": "http"` 명시 필수
Windsurf	`mcp_config.json`	필드명 `serverUrl`
Gemini CLI	`~/.gemini/settings.json`	필드명 `httpUrl`
Codex CLI	`~/.codex/config.toml`	`bearer_token_env_var`에 변수명
ChatGPT	Settings → Connectors(Apps)	Developer mode + API key 인증

흔한 함정 — 401이 뜬다면

거의 모든 연결 실패는 인증 헤더 문제입니다.

헤더 이름 오타 (authorization / Authorization)
Bearer 접두사 누락 — 키만 넣고 Bearer 를 빠뜨림
키를 잘못 복사

등록 전에 아래 curl로 먼저 검증하면 확실합니다. 도구 목록이 JSON으로 돌아오면 성공입니다.

curl -s https://www.neurium.kr/api/mcp -X POST \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

연결하면 할 수 있는 것

대화를 지식으로 수확 — 방금 나눈 대화에서 핵심을 뽑아 씨앗 노트로 심습니다(harvest_conversation). 좋은 대화가 그냥 사라지지 않습니다.
내 지식 회상 — 의미 기반 검색(semantic_search)으로, 그 AI가 답하기 전에 내가 쌓아둔 노트를 먼저 참고하게 합니다.
노트 생성·연결 — 새 노트를 만들고(create_note), [[위키링크]]로 기존 노트와 이어 붙여 그래프를 키웁니다.

💬 "Cursor로 정리한 설계 메모가, Claude와의 다음 대화에서 배경으로 딸려 나온다."

다른 AI와 함께 쓰기 — Claude·Cursor·ChatGPT 연동 (MCP)