메인 콘텐츠로 건너뛰기

개요

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 (생략 시 활성 프로젝트 사용)
titlestringO제목
contentstringO내용
tagsstring[]-태그 배열
사용 예:
사용자: 앞으로 회의에서는 안건을 사전에 공유하기로 하자. 이걸 기억해둬.

Claude: [create_knowledge 호출]
        title: "회의 규칙: 안건 사전 공유"
        content: "회의를 진행할 때는 사전에 참가자에게 안건을 공유할 것."
        tags: ["회의", "규칙"]

        알겠습니다. 회의 규칙으로 지식에 저장했습니다.

search_knowledge

시맨틱 검색을 실행하여 관련 지식을 검색합니다. 경량 결과 (ID, 제목, 태그, 점수)를 반환합니다. 파라미터:
이름타입필수설명
projectIdstring-프로젝트 ID (생략 시 활성 프로젝트 사용)
querystringO검색 쿼리
limitnumber-최대 결과 수 (기본값: 10)
전체 콘텐츠는 포함되지 않습니다. 상세 정보가 필요하면 view_knowledge를 사용하세요.
사용 예:
사용자: 반품 정책에 대해 알려줘

Claude: [search_knowledge 호출]
        query: "반품 정책"

        반품 정책 관련 지식 3건을 찾았습니다:
        1. 반품 정책 (점수: 0.92)
        2. 환불 절차 (점수: 0.78)
        3. 교환에 대해 (점수: 0.65)

search_agentic

여러 지식 레이어를 가로질러 검색하고, 하나의 혼합 결과 배열을 반환합니다. 필요에 따라 타입별로 필터링해 사용하세요. 파라미터:
이름타입필수설명
projectIdstring-프로젝트 ID (생략 시 활성 프로젝트 사용)
querystringO검색 쿼리
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 (생략 시 활성 프로젝트 사용)
knowledgeIdstringO지식 ID
사용 예:
Claude: [view_knowledge 호출]
        knowledgeId: "knowledge-123"

        === 반품 정책 ===
        상품 도착 후 30일 이내에 반품 가능합니다.

        반품 조건:
        - 미사용·미개봉 상태여야 합니다
        - 태그가 부착된 상태여야 합니다
        ...

        관련 지식:
        - 환불 절차
        - 배송 안내

list_knowledge

프로젝트 내 지식 목록을 조회합니다. 브라우징 및 지식 베이스 관리에 유용합니다. 파라미터:
이름타입필수설명
projectIdstring-프로젝트 ID (생략 시 활성 프로젝트 사용)
사용 예:
사용자: 이 프로젝트의 지식을 전부 보여줘

Claude: [list_knowledge 호출]
        프로젝트 내 지식 목록:
        1. 반품 정책
        2. 배송 가이드
        3. FAQ 모음
        ...(전체 150건)

update_knowledge

기존 지식의 제목이나 내용을 수정합니다. 파라미터:
이름타입필수설명
projectIdstring-프로젝트 ID (생략 시 활성 프로젝트 사용)
knowledgeIdstringO지식 ID
titlestring-새 제목 (생략 시 변경 없음)
contentstring-새 내용 (생략 시 변경 없음)
사용 예:
사용자: 반품 정책 기한을 60일로 변경해줘

Claude: [update_knowledge 호출]
        knowledgeId: "knowledge-123"
        content: "상품 도착 후 60일 이내에 반품 가능합니다..."

        반품 정책 지식을 수정했습니다.

delete_knowledge

프로젝트에서 지식을 삭제합니다. 파라미터:
이름타입필수설명
projectIdstring-프로젝트 ID (생략 시 활성 프로젝트 사용)
knowledgeIdstringO지식 ID
사용 예:
사용자: 오래된 반품 정책 지식을 삭제해줘

Claude: [delete_knowledge 호출]
        knowledgeId: "knowledge-456"

        지식을 삭제했습니다.

컨텍스트 조회

이 도구들은 Memory SDK 메서드에 대응합니다.

get_context

쿼리에 대해 최적화된 컨텍스트를 조회합니다. 시맨틱 검색, 그래프 탐색, 에피소드 이력을 조합하여 LLM에 전달할 정보를 구축합니다. 파라미터:
이름타입필수설명
projectIdstring-프로젝트 ID (생략 시 활성 프로젝트 사용)
querystringO검색 쿼리
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 (생략 시 활성 프로젝트 사용)
knowledgeIdstringO시작점 지식 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 (생략 시 활성 프로젝트 사용)
querystringO검색 쿼리
limitnumber-최대 결과 수 (기본값: 10)
사용 예:
사용자: 배포 플로우에 대해 논의한 토픽을 찾아줘

Claude: [search_topics 호출]
        query: "배포 플로우"

        관련 토픽 2건을 찾았습니다:
        1. 배포 플로우 개선 논의 (점수: 0.89)
        2. CI/CD 파이프라인 재검토 (점수: 0.72)

search_episodes

에피소드를 시맨틱 검색합니다. “비밀번호 재설정”, “지난주 에러” 등 과거 사건을 의미 검색으로 찾을 수 있습니다. 파라미터:
이름타입필수설명
projectIdstring-프로젝트 ID (생략 시 활성 프로젝트 사용)
querystringO검색 쿼리
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 (생략 시 활성 프로젝트 사용)
sessionIdstringO세션 ID
formatstring-'json' / 'yaml' (기본값: yaml)

베스트 프랙티스

세션 관리 활용

1

먼저 switch_project로 프로젝트 선택

활성 프로젝트를 설정하면 이후 작업이 간단해짐
2

각 도구에서 projectId 생략

활성 프로젝트가 자동으로 사용됨
3

필요시 명시적으로 projectId 지정

다른 프로젝트의 데이터에 액세스하고 싶은 경우

검색 사용 구분

1

먼저 search_knowledge로 검색

경량 결과를 얻고 관련 지식 파악
2

필요시 view_knowledge로 상세 조회

특정 지식의 전체 콘텐츠가 필요한 경우
3

복잡한 질문에는 get_context

여러 소스에서 정보를 수집해야 하는 경우

컨텍스트 최적화

# 작은 모델용
get_context(query, tokenBudget: 2000)

# 큰 모델용
get_context(query, tokenBudget: 8000, maxDepth: 3)

다음 단계

SDK Knowledge API

프로그래밍으로 지식 관리

SDK Memory API

프로그래밍으로 컨텍스트 조회