Tulip MCP 설정

  • 에 게시됨 Aug 7, 2025
  • 3 읽은 시간(초)
  • Pete Hartnett
 Prev Next

Tulip MCP는 어떻게 설정하나요?

Tulip MCP에 대한 자세한 설정 문서는 공식 리포지토리 (https://github.com/tulip/tulip-mcp/tree/master)에서 확인할 수 있습니다.

Tulip MCP 설정이 간소화되었습니다. 새로운 프로세스에는 세 가지 주요 단계가 포함됩니다:

  1. 자격 증명 구성
  2. 서버 실행
  3. MCP 클라이언트에 연결

전제 조건

시작하기 전에 시스템에 Node.js가 설치되어 있는지 확인하세요. 이는 서버를 실행하는 데 필요합니다.

npm 및 Node.js 버전 확인터미널/Windows터미널(명령 프롬프트, PowerShell)에서 다음 명령을실행합니다:

node -vnpm -v버전이름이 표시되면 정상이며 1단계를 계속 진행할 수 있고, 그렇지 않은 경우 node.js로 이동하여 운영 체제에 맞는 최신 버전을 설치하세요.

Tulip API 자격 증명 구성하기

API를 통해 Tulip에 연결하려면 API 자격 증명을 안전하게 저장하는 .env 파일을 만들어야 합니다.

1. 구성 폴더 만들기

환경 구성 파일을 저장할 폴더를 선택하거나 만듭니다.

Guide: .env 파일 만들기

이 파일에는 Tulip 자격 증명이 저장됩니다. .env 파일의 예는 여기에서 확인할 수 있습니다.

Mac 사용자:

  1. 터미널을 열고 다음 명령을 실행합니다:

bashtouch .envnano .env2. 자격 증명 템플릿(다음 단계)을 새 파일에 붙여넣습니다.3. 자격 증명을 추가한 후 아래의 저장 지침을 따릅니다.

Windows 사용자:

  1. 메모장을 엽니다.
  2. 자격증명 템플릿(다음 단계)을 새 파일에 붙여넣습니다.
  3. 자격 증명을 추가한 후 아래의 저장 지침을 따릅니다.

2. 튤립 자격증명 추가하기

다음을 복사하여 .env 파일에 붙여넣고, 자리 표시자 값을 실제 자격 증명으로 바꿉니다:

TULIP_API_KEY=your_api_key_hereTULIP_API_SECRET=your_api_secret_hereTULIP_BASE_URL=https://your-instance.tulip.coTULIP_WORKSPACE_ID=your_workspace_id_here_if_using_account_api_key

  • 튤립_베이스_URL: 튤립에 액세스하는 데 사용하는 URL입니다.
    예: https://my-company.tulip.co
  • 튤립_작업공간_ID: Tulip URL에서 /w/ 뒤에 오는 URL입니다.
    예: https://my-company.tulip.co/w/DEFAULT 에서 워크스페이스 ID는 기본값입니다.

:::(경고) (중요) 계정 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. 아래 클라이언트 구성에서 이 복사된 경로를 사용합니다.

Guide: Claude 데스크톱

  1. 클로드 데스크톱 메뉴 모음에서 설정... > 개발자 > 구성 편집을 선택합니다.
  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 빠른 시작을 참조하세요.

커서

가장 쉽게 설정하려면 아래 버튼을 클릭하세요. 그러면 커서에 명령이 미리 채워집니다.

커서에 연결하기

버튼을 클릭한 후 플레이스홀더 텍스트(REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE)를 이전에 복사한 .env 파일의 전체 경로로 바꿔야 합니다.

고급 구성

Tulip API 자격 증명 가져오기

Tulip instance 설정에서 API 자격증명(토큰)을 만들 수 있습니다.

  1. 로그인합니다: Tulip instance 에 액세스합니다.
  2. API 토큰으로 이동합니다: 설정 > API 토큰으로 이동합니다.
  3. 새 API 토큰을 만듭니다: 새 토큰을 생성하고 토큰에 설명이 포함된 이름(예: "MCP 서버")을 지정합니다.
  4. 범위를 구성합니다: 토큰에 필요한 권한(범위)을 부여합니다. 기본 액세스를 위한 좋은 시작 범위는 stations:read, users:read, tables:read, machines:read, apps:read, urls:sign입니다.
  5. 자격증명 복사: 생성된 API 키와 비밀번호를 복사하여 .env 파일에 붙여넣습니다.

도구 선택 구성

기본적으로 서버는 안전을 위해 읽기 전용 및 테이블 도구만 사용하도록 설정합니다. .env 파일에서 ENABLED_TOOLS 환경 변수를 사용하여 사용 가능한 도구를 사용자 지정할 수 있습니다.

ENABLED_TOOLS 변수는 쉼표로 구분된 목록을 사용할 수 있습니다:

  • 개별 도구 이름: 목록 스테이션과 같은 특정 도구.
  • 카테고리: 보안 기반 그룹화(읽기 전용, 쓰기, 관리자).
  • 유형: 리소스 기반 그룹화(테이블, 머신, 사용자, 앱, 인터페이스, 스테이션, 스테이션 그룹, 유틸리티).

예시:


# 모든 읽기 및 쓰기 작업 사용

ENABLED\_TOOLS=읽기 전용,쓰기

# 테이블 및 스테이션과 관련된 모든 도구 활성화

ENABLED\_TOOLS=테이블,스테이션

# 특정 도구 활성화

ENABLED\_TOOLS=목록 스테이션,추가 레코드

# 권장되는 혼합 접근 방식

ENABLED\_TOOLS=읽기 전용, 인터페이스, 스테이션, 사용자

# 모든 도구 활성화(데이터 삭제/보관이 가능하므로 주의해서 사용)

ENABLED\_TOOLS=읽기 전용,쓰기,관리자```

**관련 문서**

* [튤립 API 설정하기](/r230/docs/set-up-a-tulip-api)