Neuradex MCP 서버는 LLM이 Neuradex 메모리 기능에 액세스하기 위한 17개의 도구를 제공합니다. MCP 통합의 개요는 MCP 개요 를 참조하세요.
switch_project로 활성 프로젝트를 설정하면 각 도구에서 projectId를 생략할 수 있습니다.
프로젝트 관리
list_projects
액세스 가능한 프로젝트 목록을 조회합니다.
파라미터 : 없음
반환값 :
{
"projects" : [
{
"id" : "project-abc" ,
"name" : "고객 지원" ,
"note" : "지원 지식 베이스" ,
"knowledgeCount" : 150 ,
"edgeCount" : 320
}
]
}
사용 예 :
사용자: 어떤 프로젝트에 액세스할 수 있어?
Claude: [list_projects 호출]
다음 프로젝트에 액세스할 수 있습니다:
- 고객 지원 (지식: 150건)
- 사내 Wiki (지식: 80건)
세션 관리
switch_project
세션의 활성 프로젝트를 설정합니다. 전환 후에는 다른 도구에서 projectId를 생략할 수 있습니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID projectNamestring - 프로젝트 이름 (대소문자 구분 없음)
projectId 또는 projectName 중 하나를 지정하세요.
사용 예 :
사용자: 고객 지원 프로젝트로 전환해줘
Claude: [switch_project 호출]
projectName: "고객 지원"
활성 프로젝트를 "고객 지원"으로 전환했습니다.
이후 projectId 지정 없이 도구를 사용할 수 있습니다.
current_project
현재 활성 프로젝트를 표시합니다.
파라미터 : 없음
사용 예 :
사용자: 지금 어떤 프로젝트를 쓰고 있어?
Claude: [current_project 호출]
현재 활성 프로젝트: 고객 지원 (project-abc)
지식 관리
이 도구들은 Knowledge SDK 메서드에 대응합니다.
create_knowledge
새로운 지식을 생성합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) titlestring O 제목 contentstring O 내용 tagsstring[] - 태그 배열
사용 예 :
사용자: 앞으로 회의에서는 안건을 사전에 공유하기로 하자. 이걸 기억해둬.
Claude: [create_knowledge 호출]
title: "회의 규칙: 안건 사전 공유"
content: "회의를 진행할 때는 사전에 참가자에게 안건을 공유할 것."
tags: ["회의", "규칙"]
알겠습니다. 회의 규칙으로 지식에 저장했습니다.
search_knowledge
시맨틱 검색을 실행하여 관련 지식을 검색합니다. 경량 결과 (ID, 제목, 태그, 점수)를 반환합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) querystring O 검색 쿼리 limitnumber - 최대 결과 수 (기본값: 10)
전체 콘텐츠는 포함되지 않습니다. 상세 정보가 필요하면 view_knowledge를 사용하세요.
사용 예 :
사용자: 반품 정책에 대해 알려줘
Claude: [search_knowledge 호출]
query: "반품 정책"
반품 정책 관련 지식 3건을 찾았습니다:
1. 반품 정책 (점수: 0.92)
2. 환불 절차 (점수: 0.78)
3. 교환에 대해 (점수: 0.65)
search_agentic
여러 지식 레이어를 가로질러 검색하고, 하나의 혼합 결과 배열을 반환합니다. 필요에 따라 타입별로 필터링해 사용하세요.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) querystring O 검색 쿼리 limitnumber - 전체 결과 최대 수 perTypeLimitnumber - 타입별 최대 수 includeTypesstring[] - 포함할 타입 (knowledge / episode / topic / entity / relation) expandGraphboolean - 관련 맥락 확장 여부 maxHopsnumber - 관련 맥락 깊이 expandLimitnumber - 확장 기준 개수 relationLimitnumber - 관계 최대 수
사용 예 :
사용자: 지난주 인증 논의와 관련 자료를 함께 찾아줘
Claude: [search_agentic 호출]
query: "지난주 인증 논의"
includeTypes: ["episode", "knowledge", "relation"]
limit: 12
관련 에피소드, 지식, 관계를 하나의 목록으로 찾았습니다.
view_knowledge
지식의 상세 정보(전체 콘텐츠)와 연결된 지식을 조회합니다. search_knowledge 이후 상세 확인에 사용합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) knowledgeIdstring O 지식 ID
사용 예 :
Claude: [view_knowledge 호출]
knowledgeId: "knowledge-123"
=== 반품 정책 ===
상품 도착 후 30일 이내에 반품 가능합니다.
반품 조건:
- 미사용·미개봉 상태여야 합니다
- 태그가 부착된 상태여야 합니다
...
관련 지식:
- 환불 절차
- 배송 안내
list_knowledge
프로젝트 내 지식 목록을 조회합니다. 브라우징 및 지식 베이스 관리에 유용합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용)
사용 예 :
사용자: 이 프로젝트의 지식을 전부 보여줘
Claude: [list_knowledge 호출]
프로젝트 내 지식 목록:
1. 반품 정책
2. 배송 가이드
3. FAQ 모음
...(전체 150건)
update_knowledge
기존 지식의 제목이나 내용을 수정합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) knowledgeIdstring O 지식 ID titlestring - 새 제목 (생략 시 변경 없음) contentstring - 새 내용 (생략 시 변경 없음)
사용 예 :
사용자: 반품 정책 기한을 60일로 변경해줘
Claude: [update_knowledge 호출]
knowledgeId: "knowledge-123"
content: "상품 도착 후 60일 이내에 반품 가능합니다..."
반품 정책 지식을 수정했습니다.
delete_knowledge
프로젝트에서 지식을 삭제합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) knowledgeIdstring O 지식 ID
사용 예 :
사용자: 오래된 반품 정책 지식을 삭제해줘
Claude: [delete_knowledge 호출]
knowledgeId: "knowledge-456"
지식을 삭제했습니다.
컨텍스트 조회
이 도구들은 Memory SDK 메서드에 대응합니다.
get_context
쿼리에 대해 최적화된 컨텍스트를 조회합니다. 시맨틱 검색, 그래프 탐색, 에피소드 이력을 조합하여 LLM에 전달할 정보를 구축합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) querystring O 검색 쿼리 tokenBudgetnumber - 토큰 상한 (기본값: 4000) includeEpisodesboolean - Q&A 이력 포함 (기본값: true) maxDepthnumber - 탐색 깊이 (기본값: 2, 최대: 3)
get_context는 여러 소스에서 정보를 수집하고 토큰 예산 내에서 최적화합니다. 복잡한 질문에 적합합니다.
사용 예 :
사용자: 지난주 회의에서 결정된 새로운 배포 플로우에 대해 알려줘
Claude: [get_context 호출]
query: "새로운 배포 플로우 회의"
includeEpisodes: true
[관련 지식 + Q&A 이력에서 정보 수집]
지난주 회의에서 결정된 새로운 배포 플로우를 정리합니다:
1. PR이 머지되면 스테이징에 자동 배포
2. 스테이징에서 1시간 카나리 테스트
3. 문제없으면 프로덕션에 프로모트
...
지정된 지식에서 관련 지식을 탐색합니다. Multi-hop 탐색으로 직접 연결되지 않은 지식도 발견할 수 있습니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) knowledgeIdstring O 시작점 지식 ID maxDepthnumber - 탐색 깊이 (기본값: 2, 최대: 3)
사용 예 :
Claude: [explore_related 호출]
knowledgeId: "returns-policy"
maxDepth: 2
"반품 정책"에서 관련 지식을 탐색했습니다:
1홉 (직접 관련):
- 환불 절차
- 배송 안내
2홉 (간접 관련):
- 결제 수단
- 고객 지원 연락처
에피소드 (이력)
이 도구들은 Episodes SDK 메서드에 대응합니다.
list_episodes
과거 Q&A 이력과 이벤트를 검색합니다. “이번 주에 무슨 질문이 있었어?”, “외부 사용자 질문 보여줘” 같은 질문에 답합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) timeRangestring - 'today' / 'yesterday' / 'this_week' / 'this_month'channelstring - 'web' / 'widget' / 'api' / 'mcp' / 'external'episodeTypestring - 'question' / 'answer'limitnumber - 최대 결과 수 (기본값: 20)
채널 필터: web=관리 화면, widget=외부 사용자, api=API, mcp=MCP, external=외부 서비스(Slack 등)
사용 예 :
사용자: 이번 주에 어떤 질문이 있었어?
Claude: [list_episodes 호출]
timeRange: "this_week"
episodeType: "question"
이번 주 질문 목록 (전체 10건):
- "상품을 반품하고 싶어요" (3건)
- "배송 상태를 확인하고 싶어요" (5건)
- "결제 수단을 변경하고 싶어요" (2건)
search_topics
토픽을 시맨틱 검색합니다. “그 논의”, “프로젝트 진행 이야기” 등 모호한 쿼리로도 관련 토픽을 찾을 수 있습니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) querystring O 검색 쿼리 limitnumber - 최대 결과 수 (기본값: 10)
사용 예 :
사용자: 배포 플로우에 대해 논의한 토픽을 찾아줘
Claude: [search_topics 호출]
query: "배포 플로우"
관련 토픽 2건을 찾았습니다:
1. 배포 플로우 개선 논의 (점수: 0.89)
2. CI/CD 파이프라인 재검토 (점수: 0.72)
search_episodes
에피소드를 시맨틱 검색합니다. “비밀번호 재설정”, “지난주 에러” 등 과거 사건을 의미 검색으로 찾을 수 있습니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) querystring O 검색 쿼리 limitnumber - 최대 결과 수 (기본값: 10)
사용 예 :
사용자: 비밀번호 재설정에 관한 과거 대화를 찾아줘
Claude: [search_episodes 호출]
query: "비밀번호 재설정"
관련 에피소드 3건을 찾았습니다:
1. "비밀번호를 재설정하려면 어떻게 하나요?" (점수: 0.95)
2. "비밀번호 변경 절차에 대해" (점수: 0.82)
3. "로그인할 수 없는 경우 대처법" (점수: 0.71)
Librarian (AI 어시스턴트)
이 도구들은 Librarian SDK 메서드에 대응합니다.
list_librarian_sessions
Librarian 세션 목록을 조회합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용)
get_librarian_session
Librarian 세션 상세(메시지 이력)를 조회합니다.
파라미터 :
이름 타입 필수 설명 projectIdstring - 프로젝트 ID (생략 시 활성 프로젝트 사용) sessionIdstring O 세션 ID formatstring - 'json' / 'yaml' (기본값: yaml)
베스트 프랙티스
세션 관리 활용
먼저 switch_project로 프로젝트 선택
활성 프로젝트를 설정하면 이후 작업이 간단해짐
각 도구에서 projectId 생략
활성 프로젝트가 자동으로 사용됨
필요시 명시적으로 projectId 지정
다른 프로젝트의 데이터에 액세스하고 싶은 경우
검색 사용 구분
먼저 search_knowledge로 검색
경량 결과를 얻고 관련 지식 파악
필요시 view_knowledge로 상세 조회
특정 지식의 전체 콘텐츠가 필요한 경우
복잡한 질문에는 get_context
여러 소스에서 정보를 수집해야 하는 경우
컨텍스트 최적화
# 작은 모델용
get_context(query, tokenBudget: 2000)
# 큰 모델용
get_context(query, tokenBudget: 8000, maxDepth: 3)
다음 단계
SDK Knowledge API 프로그래밍으로 지식 관리
SDK Memory API 프로그래밍으로 컨텍스트 조회