이 예제는 특정 클라이언트를 n8n의 MCP 서버에 연결하기 위한 명령과 구성을 그대로 보여 줍니다. 사용하기 전에 인스턴스에서 MCP 접근을 활성화하고 인증 방법을 선택하세요. 자세한 내용은 MCP 클라이언트 연결을 참고하세요.

아래 예제는 모두 https://를 사용합니다. 인스턴스가 일반 HTTP로 서비스되는 경우(예: http://localhost:5678의 로컬 설치) http://를 대신 사용하세요. n8n에서 전체 Server URL을 복사하면 어느 경우든 올바른 접두사가 포함됩니다.

Lovable을 n8n MCP 서버에 연결#

1. Lovable에서 MCP 서버를 구성합니다(OAuth).
   • 워크스페이스 Settings > Integrations로 이동합니다.
   • MCP Servers 섹션에서 n8n을 찾아 Connect를 클릭합니다.
   • n8n 서버 URL을 입력합니다. Connect a client 대화 상자에 표시된 Server URL 값입니다.
   • 연결을 저장합니다. 성공하면 n8n이 Lovable의 접근을 승인하도록 리디렉션합니다.
2. 연결을 확인합니다.
   • 연결되면 Lovable은 MCP 접근이 활성화된 워크플로를 조회할 수 있습니다.
   • 예시: Lovable에 사용자 목록을 표시하고 삭제할 수 있는 워크플로 UI를 만들도록 요청합니다.

Claude Desktop을 n8n MCP 서버에 연결#

OAuth 사용(권장)

1. Claude Desktop에서 Settings > Connectors로 이동합니다.
2. Add custom connector를 클릭합니다.
3. 다음 정보를 입력합니다.
   • Name: n8n MCP
   • Remote MCP Server URL: Connect a client 대화 상자에 표시된 Server URL 값입니다. /mcp-server/http로 끝나며 https://<your-n8n-domain>/mcp-server/http 형태입니다. 이 값은 n8n 에디터의 주소가 아닙니다. 브라우저 주소 표시줄의 URL을 붙여 넣지 마세요.
4. 커넥터를 저장합니다.
5. 안내가 표시되면 Claude Desktop의 접근을 승인합니다.

API 키 사용

claude_desktop_config.json 파일에 다음 항목을 추가합니다.

"mcpServers": {
  "n8n-mcp": {
    "command": "npx",
    "args": [
    "-y",
    "supergateway",
    "--streamableHttp",
    "https://<your-n8n-domain>/mcp-server/http",
    "--header",
    "Authorization:Bearer "
    ]
  }
}

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.

Claude Code를 n8n MCP 서버에 연결#

옵션 1: OAuth로 인증(권장)

다음 CLI 명령을 사용합니다.

claude mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http

또는 claude.json 파일에 다음 항목을 추가합니다.

{
    "mcpServers": {
        "n8n": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http"
        }
    }
}

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.

Claude Code에서 /mcp를 실행하고 n8n을 선택하여 OAuth 인증을 완료합니다.

옵션 2: API 키로 인증

다음 CLI 명령을 사용합니다.

claude mcp add --transport http n8n-mcp https://<your-n8n-domain>/mcp-server/http \
  --header "Authorization: Bearer "

또는 claude.json 파일에 다음 항목을 추가합니다.

{
    "mcpServers": {
        "n8n-mcp": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http",
            "headers": {
                "Authorization": "Bearer "
            }
        }
    }
}

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.
• : 생성한 토큰

Codex CLI를 n8n MCP 서버에 연결#

옵션 1: OAuth로 인증(권장)

다음 CLI 명령을 사용합니다.

codex mcp add n8n --url "https://<your-n8n-domain>/mcp-server/http"

또는 ~/.codex/config.toml 파일에 다음 항목을 추가합니다.

[features]
experimental_use_rmcp_client = true

[mcp_servers.n8n]
url = "https://<your-n8n-domain>/mcp-server/http"

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.

codex mcp login n8n을 실행하여 OAuth 인증을 완료합니다.

옵션 2: API 키로 인증

~/.codex/config.toml 파일에 다음 항목을 추가합니다.

[features]
experimental_use_rmcp_client = true

[mcp_servers.n8n-mcp]
url = "https://<your-n8n-domain>/mcp-server/http"
http_headers = { "authorization" = "Bearer " }

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.
• : 생성한 토큰

Gemini CLI를 n8n MCP 서버에 연결#

다음 CLI 명령을 사용합니다.

gemini mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http

또는 ~/.gemini/settings.json 파일에 다음 항목을 추가합니다.

{
    "mcpServers": {
        "n8n": {
            "httpUrl": "https://<your-n8n-domain>/mcp-server/http"
        }
    }
}

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.

Gemini CLI에서 /mcp를 실행하고 n8n을 선택하여 OAuth 인증을 완료합니다.

Cursor를 n8n MCP 서버에 연결#

Connect a client 대화 상자의 Your client에서 Cursor를 선택한 다음 One-click setup을 선택하면 Cursor가 열리고 n8n 서버가 자동으로 추가됩니다. Cursor가 n8n으로 다시 리디렉션하면 접근을 승인합니다.

또는 ~/.cursor/mcp.json 파일(또는 프로젝트의 .cursor/mcp.json)에 다음 항목을 추가합니다.

{
  "mcpServers": {
    "n8n": {
      "type": "streamable-http",
      "url": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.

VS Code를 n8n MCP 서버에 연결#

Connect a client 대화 상자의 Your client에서 VS Code를 선택한 다음 One-click setup을 선택하면 VS Code가 열리고 n8n 서버가 자동으로 추가됩니다. VS Code가 n8n으로 다시 리디렉션하면 접근을 승인합니다.

또는 워크스페이스의 .vscode/mcp.json 파일에 다음 항목을 추가합니다.

{
  "servers": {
    "n8n": {
      "type": "http",
      "url": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.

Windsurf를 n8n MCP 서버에 연결#

~/.codeium/windsurf/mcp_config.json 파일에 다음 항목을 추가합니다.

{
  "mcpServers": {
    "n8n": {
      "serverUrl": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

다음 값을 바꾸세요.

• <your-n8n-domain>: https:// 접두사를 제외한 n8n 도메인입니다. n8n Cloud에서는 your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 n8n 에디터를 서비스하는 도메인이며, 예를 들면 n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.

처음 연결을 시도할 때 Windsurf가 n8n으로 리디렉션하면 접근을 승인합니다.

Google ADK 에이전트를 n8n MCP 서버에 연결#

다음은 원격 n8n MCP 서버에 연결하는 에이전트를 만드는 샘플 코드입니다.

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

N8N_INSTANCE_URL = "https://n8n.example.com"
N8N_MCP_TOKEN = "YOUR_N8N_MCP_TOKEN"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="n8n_agent",
    instruction="Help users manage and execute workflows in n8n",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"{N8N_INSTANCE_URL}/mcp-server/http",
                headers={
                    "Authorization": f"Bearer {N8N_MCP_TOKEN}",
                },
            ),
        )
    ],
)

다음 값을 바꾸세요.

• N8N_INSTANCE_URL: n8n 인스턴스의 기본 URL입니다. n8n Cloud에서는 https://your-instance.app.n8n.cloud입니다. 셀프 호스팅인 경우 사용자의 URL이며, 예를 들면 https://n8n.example.com입니다. 전체 서버 URL은 n8n의 Settings > Instance-level MCP > Connect a client > Server URL에서 확인할 수 있습니다.
• YOUR_N8N_MCP_TOKEN: 생성한 액세스 토큰

자세한 내용은 ADK 에이전트를 n8n에 연결을 참고하세요.

문제 해결#

위 단계로 클라이언트가 연결되지 않으면 기본 MCP 서버 페이지의 문제 해결을 참고하세요.

관련 자료#

• n8n MCP 서버에 연결
• MCP 서버 도구 참조