MCP (Model Context Protocol) 연동 가이드
Agent 8은 전역 표준 프로토콜인 MCP를 지원하여, 귀하의 데이터베이스나 외부 서비스(SaaS)를 손쉽게 AI 파트너에게 연동할 수 있습니다.
MCP란 무엇인가요?
Model Context Protocol (MCP)은 Anthropic이 주도하는 오픈 소스 표준으로, AI 모델이 데이터 소스 및 도구와 안전하게 상호 작용할 수 있도록 보장합니다. 기존의 플러그인 생태계와 달리, MCP 서버 하나만 개발하면 Agent 8뿐만 아니라 Claude Desktop 등 다양한 MCP 호환 클라이언트에서 즉시 사용할 수 있습니다.
주요 활용 사례
프라이빗 데이터 연동 (Database)
사내 PostgreSQL, MySQL 등의 데이터베이스를 연동하여, "이번 달 가장 매출이 높은 B2B 고객사 리스트를 뽑아줘" 등의 자연어 쿼리를 수행할 수 있습니다.
사내 파일/문서 리서치 (FileSystem)
Google Drive, Notion, Confluence 등 사내망 문서를 검색하고 요약하는 자체 MCP를 붙여 Agent 8의 역량을 높입니다.
Agent 8 MCP 서버 외부 연동 가이드
Agent 8의 실시간 에이전트 브레인을 외부 IDE나 클라이언트(예: Cursor, Claude Desktop)에서 바로 사용하려면, 다음의 과정을 거쳐야 합니다.
1. API Key 발급: 홈 화면의 계정 설정 모달에서 MCP 연동을 위한 API Key를 직접 생성할 수 있습니다. 보안 및 성능 향상 모델(플라이휠) 최적화를 위해 사용 이력 수집에 동의해야 합니다.
2. IDE/클라이언트 연동:
✅방법 A. 1-line 터미널 통합 설치 (가장 권장)
터미널을 열고 아래 명령어를 실행하면, 현재 프로젝트에 Cursor IDE 설정(.cursor/mcp.json)과 Claude Desktop 글로벌 설정이 동시에 완벽하게 구성됩니다.
curl -sSL https://agent8.org/mcp-install.sh | bash -s -- 발급받은_API_KEYpowershell -ExecutionPolicy Bypass -Command "irm https://agent8.org/mcp-install.ps1 | iex; Install-Agent8Mcp -ApiKey '발급받은_API_KEY'"✅방법 B. JSON 수동 설정 (Cursor / Claude Desktop)
IDE에서 직접 .cursor/mcp.json 또는 claude_desktop_config.json에 아래 설정을 추가하세요.
{
"mcpServers": {
"agent8": {
"command": "agent8",
"args": [
"mcp",
"발급받은_API_KEY"
]
}
}
}※ 주의: Mac의 경우 agent8 명령어 대신 전체 경로(/Users/본인계정/.agent8/bin/agent8)를 기입해야 할 수 있습니다.
제로 유지보수, 실시간 업데이트
사용자의 로컬에는 껍데기(연결 통로)만 설치된 상태이므로, Agent 8 본진 코드에서 프롬프트가 바뀌거나 도구 로직이 수정되면 재설치 없이 100% 즉시 반영됩니다.