내 PC/서버에 직접 설치해 텔레그램·디스코드로 제어하는 셀프호스팅 AI 에이전트 플랫폼입니다.
외부 서버 없이 로컬 환경에서 Claude, GPT 등 LLM을 연결해 나만의 AI 직원을 구성할 수 있습니다.
구글 드라이브, 사내 데이터베이스, 각종 써드파티 앱 등 수많은 외부 데이터를 연결할 때마다 매번 파이썬 코드를 짜고 API를 유지보수하는 것은 꽤나 피곤한 일입니다. 그 수고로움을 단번에 해결해 줄 구원투수가 등장했습니다. 바로 2026년 새롭게 도입된 최신 표준 기술, MCP(Model Context Protocol)입니다.
이번 20편에서는 코딩 한 줄 없이 다양한 외부 데이터 소스를 AI 에이전트와 완벽하게 연결하는 openclaw mcp 연동 방법을 처음부터 끝까지 다룹니다. 이 글을 읽고 나면 구글 워크스페이스부터 사내 DB까지 어떤 시스템이든 AI와 연결할 수 있는 진정한 확장성을 갖추게 됩니다.
지난 편(19편: 커스텀 Tool 만들기 — Python 스크립트를 AI 도구로 등록하는 법)에서는 나만의 전용 도구를 파이썬으로 직접 만드는 방법을 배웠습니다. 이번 편에서는 그 방법보다 더 표준화되고 확장성 높은 MCP 프로토콜을 통해 외부 생태계를 연결합니다.
MCP(Model Context Protocol)란 무엇인가?
MCP는 AI 모델이 외부 도구나 데이터 소스(로컬 파일, 데이터베이스, 검색 엔진 등)와 안전하고 표준화된 방식으로 통신할 수 있게 해주는 새로운 개방형 프로토콜입니다.
과거에는 여러 검색 엔진이나 도구를 사용하려면 각각의 API 키를 발급받고 복잡한 인증 절차를 거쳐야 했습니다. 하지만 MCP를 활용하면 단일화된 인터페이스를 통해 수십 가지 도구에 접근할 수 있습니다. 복잡하게 얽혀 있던 각기 다른 충전기 케이블들을 하나의 USB-C 범용 규격으로 통일한 것과 같은 혁명적인 변화입니다.
MCP가 AI 생태계에서 중요한 이유
- 범용 표준: Claude Desktop, Cursor, OpenClaw 등 MCP를 지원하는 AI 툴이라면 동일한 MCP 서버를 그대로 가져다 쓸 수 있습니다. 한 번 만들어두면 여러 AI 환경에서 재사용 가능합니다.
- 코드 없는 연동: 이미 수백 개의 오픈소스 MCP 서버가 GitHub에 공개되어 있습니다. 구글 드라이브, 노션, 슬랙, 깃허브 등 대부분의 주요 서비스는 이미 누군가 만들어 두었습니다.
- 보안 샌드박스: MCP 서버는 AI 본체와 분리된 별도 프로세스로 실행되어 권한이 명확하게 격리됩니다.
OpenClaw에 MCP 서버 연동하기 — 실행 가능한 코드
~/.openclaw/openclaw.json 설정 파일의 provider 블록에 MCP 서버를 등록합니다. 가장 대표적인 예시로, 여러 검색 엔진(Google, Bing, Brave 등)을 개별 API 키 없이 통합 사용할 수 있게 해주는 onesearch MCP 서버를 연결해 보겠습니다.
{
"provider": {
"type": "anthropic",
"mcpServers": {
"onesearch": {
"command": "npx",
"args": ["-y", "@onesearch/mcp-server"]
}
}
}
}설정 항목 해설
provider.mcpServers: 2026년 신규 기능으로, AI 모델 제공자(provider) 설정 블록 안에 연결할 MCP 서버 목록을 등록합니다. 여러 서버를 동시에 등록할 수 있습니다."command": "npx": MCP 서버를 실행할 명령어입니다.npx는 Node.js 패키지를 설치 없이 즉시 실행하는 도구로, 서버가 자동 다운로드됩니다."args": ["-y", "@onesearch/mcp-server"]: npx에 전달할 인수입니다.-y는 설치 확인 프롬프트를 자동 승인하고, 나머지는 실행할 MCP 서버 패키지 이름입니다.
npx 경로 문제가 발생하면 "command": "npx" 대신 절대 경로("/usr/local/bin/npx")를 사용하세요. which npx로 경로를 확인할 수 있습니다.설정 적용 및 시스템 확장
설정 파일을 수정하고 저장했다면, 아래 명령어로 게이트웨이를 재시작해 새 MCP 서버 연동을 반영해야 합니다.
# 새로운 MCP 연동 구성을 적용하기 위해 게이트웨이 재시작
openclaw gateway restart게이트웨이가 재시작되면 OpenClaw는 선언된 MCP 서버를 백그라운드에서 구동하고, 해당 서버가 제공하는 모든 도구를 에이전트가 자동으로 사용할 수 있도록 권한을 매핑합니다.
활용 가능한 대표적인 MCP 서버 예시
- 구글 워크스페이스: Gmail 읽기·쓰기, Google Calendar 일정 등록, Google Drive 파일 관리
- 노션(Notion): 데이터베이스 조회·생성, 페이지 요약, 작업 항목 추가
- 슬랙(Slack): 채널 메시지 요약, 알림 발송, 대화 내역 검색
- 깃허브(GitHub): PR 리뷰, 이슈 생성·조회, 레포지토리 코드 검색
- 사내 SQL DB: 자연어로 SQL 쿼리 생성 및 데이터 조회·집계
provider.mcpServers에 원하는 MCP 서버를 등록하고 openclaw gateway restart로 재시작하면 코딩 없이 외부 시스템이 AI에 연결됩니다. GitHub에서 원하는 MCP 서버를 검색해 바로 붙여 넣으세요.
실전 팁과 주의사항
- npx 실행 전 Node.js 설치 여부를 반드시 확인하세요: MCP 서버 실행 에러의 가장 흔한 원인은 서버 환경에
npx가 설치되지 않았거나 PATH 문제입니다. 터미널에서npx -v로 버전을 먼저 확인하세요. - 환경 변수로 API 키를 주입하세요: MCP 서버가 API 키를 요구하는 경우 설정 파일에 직접 키를 쓰지 말고
"env": { "API_KEY": "${MY_API_KEY}" }처럼 환경 변수로 주입하세요. 설정 파일이 유출되어도 키는 안전합니다. - MCP 서버는 필요한 것만 등록하세요: 사용하지 않는 MCP 서버도 게이트웨이 시작 시 함께 기동되어 메모리와 시작 시간에 영향을 줍니다. 실제로 사용하는 서버만
mcpServers에 남겨두세요. - 사내 DB 연결 시 네트워크 격리를 확인하세요: 프라이빗 MCP 서버로 사내 DB에 연결할 때는 외부에서 해당 포트에 접근할 수 없는지 방화벽 설정을 반드시 검토하세요.
자주 묻는 질문 (FAQ)
- MCP와 기존 스킬(Skills)의 차이는 정확히 무엇인가요?
- 기존의 스킬(Skills)이 OpenClaw 시스템 내부에서 파이썬이나 내장 Tool을 활용해 작성된 자체 매뉴얼이라면, MCP는 AI 업계 전체의 범용 플러그인 표준입니다. Claude Desktop 등 다른 AI 툴에서 쓰던 MCP 서버를 OpenClaw에 그대로 가져와 쓸 수 있다는 점이 가장 큰 차이이자 장점입니다.
- MCP 서버를 추가하려면 반드시 코딩을 직접 해야 하나요?
- 전혀 그렇지 않습니다. 전 세계 개발자들이 이미 GitHub MCP Registry 등에 구글 드라이브, 노션, 슬랙 요약 등 수많은 MCP 서버를 만들어 두었습니다. 본문 예시 코드처럼
npx명령어로 서버 패키지 이름만 설정 파일에 적어주면 자동으로 다운로드되어 실행됩니다. - MCP 연동 설정을 넣었는데 자꾸 실행 에러가 납니다.
- 가장 흔한 원인은 서버 환경에
npx가 제대로 설치되지 않았거나 PATH 경로 문제입니다. 터미널에서npx -v를 입력해 버전이 출력되는지 확인하고, 실행이 안 된다면"command"값에npx의 절대 경로(예:/usr/local/bin/npx)를 직접 입력해 보세요. - 회사 내부 데이터베이스(SQL 등)도 MCP로 연결해서 안전하게 쓸 수 있나요?
- 네, 훌륭한 접근입니다. 사내 DB 접속을 위한 프라이빗 MCP 서버를 구축해 OpenClaw에 연결하면, "오늘자 매출 테이블 요약해 줘"라고 자연어로 지시했을 때 AI가 SQL 쿼리를 생성하고 DB에서 데이터를 직접 뽑아옵니다. 사내망 안에서만 통신하므로 외부 데이터 유출 걱정 없이 안전하게 활용할 수 있습니다.
이 글이 도움이 됐다면 댓글로 여러분의 경험을 알려주세요! 🙌
MCP 연동에서 막히는 부분은 댓글에 남겨주세요 — 직접 답변드립니다.
📬 새 편 알림 받기 → AI 활용 가이드 구독
'OpenClaw' 카테고리의 다른 글
| 오픈클로 완전 가이드 19편 커스텀 Tool 만들기 — Python 스크립트를 AI 도구로 등록하는 법 (1) | 2026.04.04 |
|---|---|
| 오픈클로 완전 가이드 18편 openclaw Tools & Plugins 전체 가이드 — AI가 쓸 수 있는 도구 추가하기 (0) | 2026.04.04 |
| 오픈클로 완전 가이드 17편 openclaw headless 모드 — UI 없이 백그라운드 에이전트 운영하기 (0) | 2026.04.03 |
| 오픈클로 완전 가이드 16편 openclaw 멀티에이전트 — 역할이 다른 에이전트 여러 개 동시 운영하기 (0) | 2026.04.03 |
| 오픈클로 완전 가이드. 15편 openclaw agents.md 작성법 — 나만의 맞춤형 AI 에이전트 만들기 (0) | 2026.04.02 |
댓글