AI 에이전트에 LlamaIndex 능력 부여하기

AI 에이전트에 LlamaIndex 능력 부여하기 (Using LlamaIndex with AI Agents)

LlamaIndex의 강력한 문서 처리 능력을 일반 AI 에이전트에도 그대로 얹고 싶다면 이 문서가 정답지 역할을 해줘요. 에이전트에게 능력을 주는 방법은 크게 네 가지 뿐이에요 — MCP 서버로 연결하거나, 에이전트 스킬·플러그인을 설치하거나, 워크플로우 노드를 노코드 파이프라인에 끼워 넣는 것. 어떤 상황에서 무엇을 골라야 할지 함께 살펴볼게요.

출처: 공식문서

어디에 무엇을 쓸까 — 경로 선택 가이드

MCP 서버

LlamaIndex는 Model Context Protocol 기반 서버를 두 개 호스팅하고 있어요.

LlamaParse 플랫폼 — https://mcp.llamaindex.ai/mcp 엔드포인트가 Parse·Classify·Extract·Split·Index 등 플랫폼의 문서 처리 기능을 MCP 클라이언트가 호출할 수 있는 도구 형태로 노출해요. 대화형 클라이언트는 OAuth 인증만으로 API 키 없이 쓸 수 있고, CI나 서버 쪽에서 돌아가는 헤드리스 호출자는 LlamaCloud API 키를 bearer 토큰으로 보내며 파일을 디스크가 아닌 URL로 업로드해요. 제품 범위 서버(예: https://mcp.llamaindex.ai/extract/{configId}/mcp)를 쓰면 도구 목록을 더 좁혀서 병렬성이나 범위를 더 세밀하게 제어할 수 있어요.

문서 검색 — https://developers.llamaindex.ai/mcp는 에이전트에게 search_docs, grep_docs, read_doc 기능을 제공해요. LlamaIndex 코드를 작성하는 에이전트가 추측 대신 문서를 직접 조회하게 만들 때 특히 유용하죠.

에이전트 스킬과 플러그인

스킬(Skills) 은 코딩 에이전트가 필요할 때나 슬래시 명령으로 로드하는 자족형 기능이에요. 두 가지가 제공되며 둘 다 run-llama/llamaparse-agent-skills 저장소에서 받아요.

플러그인(Plugins) 은 Claude Code와 Codex용으로 스킬을 묶어 에이전트 안에서 바로 설치할 수 있게 한 형태예요. liteparse, llamaparse, llamaparse-mcp 세 가지가 있는데, 마지막 것은 스킬과 LlamaParse 플랫폼 MCP를 함께 묶어줘요.

워크플로우 통합

n8n 커뮤니티 노드가 LlamaParse 플랫폼을 n8n 워크플로우 안으로 가져와서, 코드를 한 줄도 쓰지 않고 문서 파이프라인을 구성할 수 있어요.

프로그래밍 방식 문서 접근

이 문서 사이트는 사람뿐 아니라 에이전트가 읽도록 설계되어 있어요.

• llms.txt — 사이트 전체 개요 (developers.llamaindex.ai/llms.txt)
• Raw Markdown — 페이지 URL 끝에 index.md를 붙이면 원문 마크다운을 얻을 수 있어요
• REST API — /api/search(BM25 전문 검색), /api/grep(정규식), /api/read(페이지 조회), /api/list(트리 탐색) 등. 파라미터는 llms.txt에 정리되어 있어요

클라이언트가 MCP를 지원한다면 문서 MCP 서버가 같은 기능을 감싸므로 보통 그것을 더 선호해요.

더 알아보기

• MCP 문서 검색
• LiteParse 에이전트 스킬
• LlamaParse 스킬·플러그인
• LlamaParse 플랫폼 n8n 노드