중급 · 4/4강
SGB MCP로 에이전트에 보관함 연결하기
읽기 전용 도구로 개념을 찾고 출처 노트까지 조회합니다.
MCP는 에이전트가 도구를 호출하는 연결입니다
MCP(Model Context Protocol)는 에이전트가 외부 도구의 이름과 입력 형식을 확인하고 호출하는 규약입니다. 모델 자체가 보관함을 기억하게 만드는 기능은 아닙니다. SGB가 도구를 제공하고 에이전트가 필요한 조회를 요청합니다.
SGB의 서버는 데스크톱 Obsidian 안에서 작동합니다. Agent access를 켜야 하며 Obsidian을 종료하거나 플러그인을 끄면 서버도 종료됩니다. 기본 주소는 http://127.0.0.1:27180/mcp이고 설정에서 바꿀 수 있습니다.
| SGB 도구 | 확인할 내용 |
|---|---|
search | 노트·개체와 검색 결과의 이유 |
get_entity | 개체 이름·별칭·관계와 출처 |
get_note | 노트의 링크·백링크와 요청한 본문 |
neighbors, find_path | 주변 개체와 연결 경로 |
graph_overview | 보관함 그래프의 규모와 구성 |
이 도구들은 읽기 전용입니다. 연결된 에이전트가 다른 파일 편집 도구를 갖고 있다면 그 별도 권한까지 읽기 전용이 되는 것은 아닙니다. 이번 실습 요청은 조회와 근거 확인으로 제한합니다.
설정 화면이 제공하는 연결을 적용합니다
수업 후 Obsidian의 SGB 설정에서 Agent access를 켜고 서버 상태를 확인합니다. 사용하는 클라이언트에 맞게 제공된 설정을 복사합니다. Codex에는 설정 블록, Claude Code에는 등록 명령, Claude Desktop에는 로컬 브리지 설정이 제공됩니다. Claude Desktop 브리지는 Node.js가 필요합니다. 실제 토큰이 들어간 설정을 공개 기록에 붙여 넣지 않습니다.
클라이언트를 새로 열어 도구가 보이는지 확인한 뒤 요청합니다.
SGB로 대규모 언어 모델 개체를 찾아 주세요. 연결된 조사 메모를 열고, 면담자와 응답자의 역할을 어떤 근거로 구분했는지 보여 주세요. 읽은 노트 경로와 구절을 함께 제시해 주세요.
도구 호출과 설명을 함께 확인합니다
그럴듯한 답변만으로 연결 성공을 판단하지 않습니다. 실제로 SGB 도구가 호출되었는지, 반환된 노트 경로가 있는지, 해당 파일에서 같은 구절을 찾을 수 있는지 확인합니다.
med-lit에서 가져온 관계의 모든 근거 구절이 get_entity의 관계 응답에 직접 들어오는 것은 아닙니다. 개체의 위키 노트를 get_note로 읽고 출처 문헌으로 이동해야 전체 근거를 확인할 수 있습니다. 이 경로를 마지막 모듈에서 연습합니다.
직접 해 보기약 10분
실제 연결을 했다면 도구 이름과 노트 경로를 기록합니다. 설치 전에는 위 요청을 자신의 질문에 맞게 고치고 필요한 노트 경로를 적어 조회 계획을 남기십시오. 아직 실행하지 않은 계획을 연결 성공으로 표시하지 않습니다.
| 요청과 사용 도구 | 반환된 노트 경로 | 구절 대조·연결 상태 |
|---|---|---|
1행
2행
3행
표를 채운 뒤 Markdown 파일로 내려받으십시오. 다음 조사에서 같은 기록을 다시 열어 확인합니다.
연구에 적용하면
SGB MCP는 현재 보관함과 그래프를 조회하는 연결입니다. 연결 확인은 도구 호출, 노트 경로, 실제 구절의 대조로 수행합니다. 새 문헌 검색은 별도 med-lit 서버가 담당합니다.
확인한 자료
SGB 0.7.2 README를 기준으로 작성했습니다. 예시 요청과 판단 표는 교육용이며 실제 검색 결과를 뜻하지 않습니다.
연구에 적용할 차례
보관함을 조회할 수 있게 되었습니다. 새 문헌을 모으는 med-lit의 단계와 연결을 배웁니다.