1AIVault 문서

첫 MCP 연결

1AIVault MCP 서버를 AI client에 설치하고 client가 vault를 읽을 수 있는지 확인합니다.

MCP는 AI client가 vault memory를 읽고, 검색하고, 저장하고, 분류하고, 업데이트하는 방식입니다. Connection -> Install MCP 를 열어 번들 server를 지원 client에 설치합니다.

지원 MCP client

현재 installer 목록에는 Claude Desktop, Cursor, Claude Code, Cline, Codex, Gemini, Antigravity, ChatGPT, OpenCode가 포함됩니다.

설치

Connection 을 엽니다.
Install MCP 를 선택합니다.
연결하려는 client의 Install 을 클릭합니다.
해당 AI client를 다시 시작합니다.
vault를 검색하도록 요청합니다.

예시 prompt:

text

Search my vault for recent entries and summarize the most important decisions.

확인

client가 vault tool을 실행한 뒤 Connection -> Activity 또는 Connection -> Memory Reads 를 엽니다. 성공한 읽기는 vault_search, vault_brain_query, vault_recent 같은 tool call을 표시해야 합니다.

흔한 실패 유형

설치 후 client를 다시 시작하지 않았습니다.
client config는 있지만 그 client에서 MCP server가 비활성화되어 있습니다.
Diagnostics에 표시된 데이터베이스 경로가 없거나 오래된 vault를 가리킵니다.
AI가 아직 가져오지 않은 내용을 검색했기 때문에 읽기는 작동했지만 결과가 없습니다.