--- title: "Tulip MCP 설정하기" slug: "setting-up-the-tulip-mcp" updated: 2026-10-22T11:18:30Z published: 2026-10-22T11:18:30Z canonical: "support.tulip.co/setting-up-the-tulip-mcp" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Tulip MCP 설정하기 ## Tulip MCP는 어떻게 설정하나요? Tulip MCP에 대한 자세한 설정 문서는 공식 저장소에서 확인할 수 있습니다: [https://github.com/tulip/tulip-mcp/tree/master](https://github.com/tulip/tulip-mcp/tree/master) Tulip MCP의 설정 절차가 간소화되었습니다. 새로운 절차는 다음 세 가지 주요 단계로 구성됩니다: 1. 인증 정보 구성 2. 서버 실행 3. MCP 클라이언트에 연결 ### 필수 조건 시작하기 전에 시스템에 [Node.js가](https://nodejs.org/en/download) 설치되어 있는지 확인하십시오. 이는 서버를 실행하는 데 필요합니다. **npm 및 Node.js 버전 확인**터미널/Windows 터미널(명령 프롬프트, PowerShell)에서 다음 명령어를**실행하세요**: `node -v npm -v`버전명이 표시되면 준비가 완료된 것이므로 1단계로 진행할 수 있습니다. 그렇지 않은 경우, [node.js](https://nodejs.org/en/download) 웹사이트로 이동하여 사용 중인 운영 체제에 맞는 최신 버전을 설치하십시오. ## Tulip API 자격 증명 구성 API를 통해 Tulip에 연결하려면 API 자격 증명을 안전하게 저장하는 `.env` 파일을 생성해야 합니다. ### 1. 구성 폴더 만들기 환경 구성 파일을 저장할 폴더를 선택하거나 새로 만드세요. ### 가이드: `.env` 파일 생성 이 파일에는 Tulip 자격 증명이 저장됩니다. `.env` 파일 예시는 [여기에서](https://github.com/tulip/tulip-mcp/blob/main/env.example) 확인할 수 있습니다. #### **Mac 사용자:** 1. **터미널을** 열고 다음 명령어를 실행하세요: `bashtouch .envnano .env2`. 새 파일에 (다음 단계에 있는) 자격 증명 템플릿을 붙여넣으세요.3. 자격 증명을 추가한 후, 아래의 저장 지침을 따르세요. #### **Windows 사용자:** 1. 메모장을 엽니다. 2. (다음 단계에 나오는) 자격 증명 템플릿을 새 파일에 붙여넣으세요. 3. 인증 정보를 추가한 후, 아래의 저장 지침을 따르십시오. ### 2. Tulip 자격 증명 추가 다음 내용을 `.env` 파일에 복사하여 붙여넣고, 자리 표시자 값을 실제 자격 증명 정보로 대체하십시오: `TULIP_API_KEY=여기에_API_키_입력TULIP_API_SECRET=여기에_API_시크릿_입력TULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=계정 API 키를 사용하는 경우 여기에 작업 공간 ID 입력` - **TULIP_BASE_URL**: Tulip에 접속할 때 사용하는 URL입니다. *예시*: `https://my-company.tulip.co` - **TULIP_WORKSPACE_ID**: Tulip URL에서 `/w/` 뒤에 있는 값입니다 `.` *예*: `https://my-company.tulip.co/w/DEFAULT`에서 작업 공간 ID는 `DEFAULT입니다`. :::(경고) (중요) **계정 API 키** ( **계정 설정에서** 제공)를 사용하는 경우에만 `TULIP_WORKSPACE_ID를` 포함하십시오. **워크스페이스 설정에서** 발급받은 **워크스페이스 API 키를** 사용하는 경우, 이 field 필드는 비워 두어도 됩니다. ::: 파일을 저장하고, 파일이 지정한 폴더에 있는지 확인하십시오. ### 3. 서버 실행 `.env` 파일 구성이 완료되면 서버를 시작할 수 있습니다. 터미널이나 명령 프롬프트를 열고, `.env` 파일이 있는 폴더로 이동한 후 다음 명령어를 실행하세요: `bashnpx @tulip/mcp-server이`명령어는 Tulip MCP 서버의 최신 버전을 다운로드하여 시작합니다. 이제 서버가 실행 중이며 MCP 클라이언트에 연결할 준비가 되었습니다. ### 4. Tulip MCP에 연결하기 MCP 클라이언트가 서버를 실행할 때, 서버가 `.env` 파일과 동일한 디렉터리에 있지 않을 수 있으므로 자격 증명을 자동으로 찾지 못할 수 있습니다. 이 문제를 해결하려면 클라이언트 구성에서 `--env` 플래그를 사용하여 `.env` 파일의 전체 경로를 지정해야 합니다. ### 가이드: .env 파일 경로 찾기 1. `.env` 파일을 생성한 폴더로 이동합니다. 2. **Windows의 경우:** `Shift` 키를 누른 상태에서 `.env` 파일을 마우스 오른쪽 버튼으로 클릭한 다음, **“경로로 복사”를** 선택합니다. 3. **macOS의 경우:** `.env` 파일을 마우스 오른쪽 버튼으로 클릭한 상태에서 `Option` 키를 누른 다음, **"경로명으로 .env 복사"를** 선택합니다. 4. 아래의 클라이언트 구성에서 이 복사한 경로를 사용하게 됩니다. ### 가이드: Claude Desktop 1. Claude Desktop 메뉴 바에서 **설정...** > **개발자** > **구성 편집을** 선택합니다. 2. 그러면 `claude_desktop_config.json` 파일이 열립니다. 3. `mcpServers` 객체 안에 서버 구성을 추가합니다. **`"C:\\path\\to\\your\\.env"를` 복사한 실제 경로로 대체해야 합니다.** `json { "mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\path\\to\\your\\.env" ] } } }` 4. 파일을 저장하고 **Claude Desktop을 다시 시작하세요**. > 자세한 내용은 [공식 Claude Desktop MCP 퀵스타트를](https://modelcontextprotocol.io/quickstart/user) 참조하세요. ### 커서 가장 간편하게 설정하려면 아래 버튼을 클릭하세요. 그러면 Cursor에 명령어가 미리 입력됩니다. [Cursor에 연결](https://cursor.com/install-mcp?name=tulip-mcp&config=eyJjb21tYW5kIjoibnB4IEB0dWxpcC9tY3Atc2VydmVyIC0tZW52IEM6XFxwYXRoXFx0b1xceW91clxcLmVudiJ9) 버튼을 클릭한 후, **자리 표시자 텍스트** (`REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE`) **를** 앞서 복사해 둔 `.env` 파일의 전체 경로로 **대체해야 합니다**. ### 고급 구성 #### Tulip API 자격 증명 가져오기 Tulip instance 설정에서 API 자격 증명(서비스 계정)을 생성할 수 있습니다. 1. **로그인:** Tulip instance 에 접속하세요. 2. **Tulip API로 이동**: **설정** > **Tulip API**로 이동합니다. 3. **새 서비스 계정 생성:** 새 서비스 계정을 생성하고, 설명이 명확한 이름(예: "MCP 서버")을 지정합니다. 4. **범위(Scopes) 구성:** 서비스 계정에 필요한 권한(범위)을 부여합니다. 기본 액세스를 위한 권장 범위 세트는 다음과 같습니다. `stations:read, users:read, tables:read, machines:read, apps:read, urls:sign` 5. **인증 정보 복사:** 생성된 API 키와 시크릿을 복사하여 `.env` 파일에 붙여넣으세요. #### 도구 선택 구성 기본적으로 보안상의 이유로 서버는 `읽기 전용` 및 `테이블` 도구만 활성화합니다. `.env` 파일의 `ENABLED_TOOLS` 환경 변수를 사용하여 사용할 수 있는 도구를 사용자 정의할 수 있습니다. `ENABLED_TOOLS` 변수는 쉼표로 구분된 목록을 허용하며, 다음을 포함할 수 있습니다: - **개별 도구 이름:** `listStations`와 같은 특정 도구. - **범주:** 보안 기반 그룹(`읽기 전용`, `쓰기`, `관리자`). - **유형:** 리소스 기반 그룹(`테이블`, `머신`, `사용자`, `앱`, `인터페이스`, `스테이션`, `스테이션 그룹`, `유틸리티`). **예시:** ``` # 모든 읽기 및 쓰기 작업 활성화 ENABLED\_TOOLS=읽기 전용,쓰기 # 테이블 및 스테이션과 관련된 모든 도구 활성화 ENABLED\_TOOLS=table,station # 특정 도구 활성화 ENABLED\_TOOLS=listStations,addRecord # 권장되는 혼합 방식 ENABLED\_TOOLS=read-only,interface,station,user # 모든 기능 활성화 (데이터 삭제/보관 기능이 허용되므로 주의하여 사용하십시오) ENABLED\_TOOLS=read-only,write,admin``` **관련 기사** * [Tulip API 설정하기](/r230/docs/set-up-a-tulip-api) ```