n8n 문서 MCP 서버에 연결하기
n8n v2.29n8n 문서는 두 개의 MCP(Model Context Protocol) 서버를 제공합니다. 두 서버는 서로 다른 소스를 기반으로 하므로, AI 도구가 답변하는 방식에 맞는 서버를 선택하세요. 두 서버를 모두 연결할 수 있습니다.
n8n 문서는 두 개의 MCP(Model Context Protocol) 서버를 제공합니다. AI 도구를 서버에 연결하면 작업하는 동안 n8n의 지식을 검색하고 질문에 답변받을 수 있습니다.
두 서버는 서로 다른 소스를 기반으로 하므로, AI 도구가 답변하는 방식에 맞는 서버를 선택하세요.
| 서버 | 소스 | 적합한 용도 |
|---|---|---|
| GitBook 문서 서버 | 공개된 n8n 문서만 | 정확한 문서 페이지를 검색하고 읽는 데 적합합니다. 문서가 유일하고 신뢰할 수 있는 소스입니다. |
| Kapa.ai 서버 | 문서, 커뮤니티 포럼, n8n 블로그 | 문서만으로는 다루지 못하는 더 폭넓은 질문(문제 해결, 실제 사용 사례 등)에 적합합니다. 이는 문서 사이트의 AI 어시스턴트를 구동하는 것과 동일한 엔진입니다. |
두 서버를 모두 연결할 수 있습니다. 문서에 근거한 답변을 원할 때는 GitBook 서버를, n8n의 더 넓은 지식 베이스에서 가져온 답변을 원할 때는 Kapa.ai 서버를 사용하세요.
두 서버 모두 HTTP 전송을 사용하므로, AI 도구가 HTTP를 통한 원격 MCP 서버를 지원해야 합니다. stdio나 SSE는 지원하지 않습니다.
MCP 서버 URL#
원하는 서버의 엔드포인트를 사용하세요.
| 서버 | URL |
|---|---|
| GitBook 문서 서버 | https://docs.n8n.io/~gitbook/mcp |
| Kapa.ai 서버 | https://n8n.mcp.kapa.ai |
AI 도구 연결하기#
단계는 도구마다 다르지만, 각 도구는 위의 서버 URL을 필요로 합니다. 다음 예제는 두 서버를 모두 설정합니다. 하나만 연결하려면 원하는 항목만 남기고 나머지는 제거하세요.
Kapa.ai 서버는 인증이 필요합니다. 처음 연결하거나 처음 사용할 때 AI 도구가 브라우저 기반 로그인 흐름을 엽니다. 안내에 따라 연결을 승인하세요.
Claude Code
터미널에서 다음 명령을 실행하세요.
claude mcp add --transport http n8n-docs https://docs.n8n.io/~gitbook/mcp
claude mcp add --transport http n8n-kapa https://n8n.mcp.kapa.ai
Cursor
mcp.json 파일에 서버를 추가하세요.
{
"mcpServers": {
"n8n-docs": {
"url": "https://docs.n8n.io/~gitbook/mcp"
},
"n8n-kapa": {
"url": "https://n8n.mcp.kapa.ai"
}
}
}
VS Code
mcp.json 파일에 서버를 추가하세요.
{
"servers": {
"n8n-docs": {
"type": "http",
"url": "https://docs.n8n.io/~gitbook/mcp"
},
"n8n-kapa": {
"type": "http",
"url": "https://n8n.mcp.kapa.ai"
}
}
}
Other tools
다른 MCP 클라이언트의 경우, MCP 설정에서 새 원격(HTTP) 서버를 추가하고 서버 URL을 입력하세요.
https://docs.n8n.io/~gitbook/mcp
https://n8n.mcp.kapa.ai
연결한 후에는 도구가 작업하는 동안 n8n의 지식을 검색할 수 있습니다.
정확한 구성 단계와 파일 위치는 도구와 버전에 따라 다릅니다. 원격 MCP 서버를 추가하는 방법은 사용 중인 도구의 문서를 확인하세요. Kapa.ai 서버에 대한 자세한 내용은 Kapa.ai MCP 문서를 참고하세요.