Dify + MCP 가이드 2026: AI 에이전트를 모든 도구에 연결하기
Model Context Protocol(MCP)은 AI 모델을 외부 도구에 연결하는 새로운 범용 표준입니다. 이 가이드는 Dify에 MCP 서버를 통합하는 방법을 보여줍니다 — 에이전트에게 파일 시스템, GitHub, Slack, 데이터베이스, 모든 API에 대한 액세스 권한을 부여합니다.
MCP(Model Context Protocol)란 무엇인가요?
Model Context Protocol(MCP)은 Anthropic이 2024년 말에 출시한 오픈 표준입니다. AI 언어 모델이 외부 도구 및 데이터 소스에 연결하는 방법을 정의합니다. 이전에는 모든 AI 플랫폼이 각 도구에 대한 자체 통합이 필요했습니다 — GitHub 커넥터, 데이터베이스 어댑터, 파일 리더, 모두 개별적으로 개발되었습니다. MCP가 이것을 근본적으로 변경합니다.
가장 좋은 비유: MCP는 AI를 위한 USB-C입니다. USB-C가 모든 장치를 모든 컴퓨터에 연결할 수 있게 하는 것처럼, MCP는 모든 AI 에이전트가 모든 MCP 호환 도구 서버에 연결할 수 있게 합니다. 하나의 표준, 무한한 확장성.
기술적 배경: MCP는 HTTP 또는 stdio를 통한 클라이언트-서버 아키텍처를 사용합니다. AI 에이전트(클라이언트)가 에이전트가 호출할 수 있는 "도구"(함수)를 제공하는 MCP 서버에 요청을 보냅니다. 프로토콜은 언어에 독립적입니다: 서버는 Node.js, Python, Go 또는 다른 언어로 작성될 수 있습니다.
표준화
모든 도구를 위한 하나의 프로토콜. 한 번 구축하고 어디서나 연결.
오픈소스
Apache-2.0 라이선스. 커뮤니티 기반 서버 생태계.
안전함
서버가 로컬 또는 개인 네트워크에서 실행됩니다. 데이터가 당신과 함께 유지됩니다.
확장 가능
모든 API, 데이터베이스 또는 서비스에 대한 자체 MCP 서버를 구축하세요.
MCP 클라이언트로서의 Dify
Dify는 MCP를 클라이언트로 기본 지원합니다. 즉, Dify 에이전트가 모든 MCP 서버와 직접 통신할 수 있습니다. Dify에 MCP 서버를 추가하면 Dify가 제공된 모든 도구를 자동으로 인식하고 에이전트 앱에서 사용 가능하게 만듭니다. AI 에이전트가 어떤 도구를 언제 호출할지 자율적으로 결정합니다.
이것은 기존 API 통합에 비해 상당한 발전입니다. Dify에서 각 API에 대한 별도의 "커스텀 도구" 항목을 만드는 대신, Dify를 MCP 서버로 지정하기만 하면 전체 도구 카탈로그가 자동으로 로드됩니다. GitHub MCP 서버를 추가하면 에이전트가 즉시 저장소를 나열하고, 파일을 읽고, 이슈를 만들고, PR을 검토할 수 있습니다.
MCP를 통해 연결할 수 있는 것
MCP 서버를 Dify에 연결하기 — 단계별
MCP 서버를 Dify의 도구로 추가하는 데 약 2분이 걸립니다. 전체 과정은 다음과 같습니다:
MCP 서버 시작
MCP 서버를 로컬 또는 서버에서 시작합니다. 공식 Anthropic 파일 시스템 서버 예: npx @modelcontextprotocol/server-filesystem /path/to/your/files — 포트 3000에서 HTTP MCP 서버를 시작합니다.
Dify 도구 열기
Dify에서 상단 탐색의 도구를 클릭한 다음 왼쪽 패널에서 커스텀 도구를 클릭합니다.
새 MCP 도구 만들기
"+ 만들기"를 클릭합니다. 도구 유형으로 MCP 서버를 선택합니다(OpenAPI가 아님).
MCP 서버 URL 입력
MCP 서버의 URL을 붙여넣습니다(예: http://localhost:3000/mcp 또는 http://your-server-ip:3000/mcp). 서버에 인증이 필요한 경우 Authorization 헤더 필드에 인증 토큰을 입력합니다.
자동 탐색
Dify가 서버의 도구 매니페스트를 자동으로 로드합니다. 제공된 모든 도구 목록이 표시됩니다 — 예를 들어 파일 시스템 서버의 경우 "read_file", "list_directory", "write_file".
에이전트 앱에 추가
Dify에서 에이전트 앱을 열거나 만듭니다. 도구 섹션에서 도구 추가를 클릭하고 MCP 서버를 선택합니다. 이제 에이전트가 인식된 모든 도구를 사용할 수 있습니다.
셀프 호스팅 참고: Dify와 MCP 서버가 같은 호스트에서 실행되는 경우 localhost가 아닌 서버의 내부 IP 또는 호스트명을 사용하세요 — Dify가 Docker에서 실행되기 때문입니다. 예: http://172.17.0.1:3000/mcp 또는 macOS/Windows에서 http://host.docker.internal:3000/mcp.
Dify를 위한 인기 MCP 서버
Anthropic과 커뮤니티는 성장하는 MCP 서버 생태계를 유지합니다. Dify에 가장 유용한 것들:
| MCP 서버 | 기능 | 주요 도구 | 설치 |
|---|---|---|---|
| filesystem | 로컬 파일 읽기 및 쓰기 | read_file, write_file, list_directory, search_files | npx @modelcontextprotocol/server-filesystem |
| github | GitHub 저장소, PR, 이슈 | get_file_contents, create_issue, list_pull_requests, search_code | npx @modelcontextprotocol/server-github |
| slack | Slack 메시지 및 채널 | list_channels, get_messages, send_message, search_messages | npx @modelcontextprotocol/server-slack |
| postgresql | 읽기 전용 SQL 데이터베이스 액세스 | query, list_tables, describe_table | npx @modelcontextprotocol/server-postgres |
| brave-search | 실시간 웹 검색 | brave_web_search, brave_local_search | npx @modelcontextprotocol/server-brave-search |
| puppeteer | 브라우저 자동화 및 스크래핑 | navigate, screenshot, get_content, click, fill | npx @modelcontextprotocol/server-puppeteer |
| everything | Windows 파일 검색 (Everything) | search, get_file_info | npx @modelcontextprotocol/server-everything |
MCP 서버 설정: 단계별 예제
완전한 예제: Dify 에이전트가 서버의 파일을 읽고 쓸 수 있도록 Anthropic 파일 시스템 MCP 서버를 설정합니다.
1단계: Node.js 18+ 설치 (이미 설치된 경우 건너뛰기)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - sudo apt-get install -y nodejs
2단계: 파일 시스템 MCP 서버 시작
npx @modelcontextprotocol/server-filesystem /home/user/documents
# 서버가 http://localhost:3000/mcp에서 실행됩니다
3단계: 백그라운드 서비스로 실행 (선택사항)
npm install -g pm2 pm2 start "npx @modelcontextprotocol/server-filesystem /home/user/documents" --name mcp-filesystem pm2 save && pm2 startup
4단계: 서버 테스트
curl http://localhost:3000/mcp
# 예상 출력: {"name":"filesystem","version":"...","tools":[...]} 5단계: GitHub MCP 서버 (인증 포함)
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here \ npx @modelcontextprotocol/server-github
# github.com/settings/tokens에서 GitHub PAT 생성
실용적인 사용 사례
오늘 재현할 수 있는 세 가지 프로덕션 준비 완료 Dify + MCP 설정:
사용 사례 1: AI 문서 어시스턴트
파일 시스템 MCP 서버를 Dify 에이전트에 연결합니다. AI 에이전트가 이제 문서 폴더를 탐색하고, 계약서를 읽고, 중요한 데이터를 추출하고, 버전을 비교하고, 요약을 작성할 수 있습니다 — 모두 자연어로. "/reports/Q1의 모든 PDF 보고서를 요약하고 경영진 요약을 만들어줘" — 그리고 작동합니다.
사용 사례 2: GitHub PR 리뷰어
GitHub MCP 서버를 Dify에 연결합니다. PR을 자동으로 리뷰하는 에이전트를 구축합니다: 열린 PR 나열, diff 읽기, 코드 표준 확인, 잠재적 버그 식별, 리뷰 댓글 게시 — 모두 Dify 인터페이스 내에서. 자동 코드 리뷰를 위해 Dify 워크플로우를 통해 예약 실행.
사용 사례 3: 데이터베이스 분석가
PostgreSQL MCP 서버를 읽기 전용 자격 증명으로 Dify에 연결합니다. 자연어 데이터 분석가를 구축합니다: 사용자가 비즈니스 질문을 하면 에이전트가 SQL 쿼리를 작성하고, 데이터베이스에 대해 실행하고, 결과를 사람이 읽기 쉬운 형태로 반환합니다. 사용자 측에 SQL 지식이 필요 없습니다.
자주 묻는 질문
MCP(Model Context Protocol)란 무엇인가요?
MCP는 AI 모델이 외부 도구 및 데이터 소스에 연결하는 방법을 정의하는 Anthropic의 오픈 표준입니다. 'AI를 위한 USB-C'라고 생각하세요 — 각 도구에 대한 개별 통합 대신 하나의 표준이 모든 곳에서 작동합니다. Dify는 MCP를 클라이언트로 지원합니다.
MCP를 통해 Dify에 무엇을 연결할 수 있나요?
MCP를 통해 Dify를 연결할 수 있습니다: 로컬 파일 시스템, GitHub(저장소, PR, 이슈), Slack(메시지, 채널), PostgreSQL 데이터베이스, 웹 브라우저(Puppeteer), 웹 검색(Brave, DuckDuckGo) 및 MCP 서버가 있는 모든 서비스.
Dify와 함께 MCP를 사용하려면 코딩 지식이 필요한가요?
공식 MCP 서버(파일 시스템, GitHub 등)의 경우 단일 npx 명령으로 시작한 후 Dify에 URL을 입력하면 됩니다. 코딩 불필요. 자체 MCP 서버를 구축하려면 기본적인 Node.js 또는 Python 지식이 필요합니다.
MCP는 프로덕션 사용에 안전한가요?
MCP 보안은 서버 구성에 따라 다릅니다. MCP 서버는 항상 localhost 또는 개인 네트워크에서 실행하세요 — 인터넷에 직접 노출하지 마세요. 인증 토큰을 사용하고 파일 액세스를 특정 디렉토리로 제한하세요.
프로덕션에서 Dify + MCP를 운영하고 싶으신가요?
MCP는 Dify와 MCP 서버가 함께 셀프 호스팅될 때 — 같은 개인 서버에서, 데이터가 자체 인프라를 벗어나지 않을 때 — 완전한 강점을 발휘합니다. Hetzner는 Dify와 여러 MCP 서버를 동시에 실행하기 위한 성능이 있는 €3.79/월부터 시작하는 VPS를 제공합니다. 또는 완전히 관리되는 원클릭 Dify 배포를 위해 Elestio를 사용하세요.