Tulip MCP는 어떻게 설정하나요?
Tulip MCP에 대한 자세한 설정 문서는 공식 저장소에서 확인할 수 있습니다: https://github.com/tulip/tulip-mcp/tree/master
Tulip MCP의 설정 절차가 간소화되었습니다. 새로운 절차는 다음 세 가지 주요 단계로 구성됩니다:
- 인증 정보 구성
- 서버 실행
- MCP 클라이언트에 연결
필수 조건
시작하기 전에 시스템에 Node.js가 설치되어 있는지 확인하십시오. 이는 서버를 실행하는 데 필요합니다.
npm 및 Node.js 버전 확인터미널/Windows 터미널(명령 프롬프트, PowerShell)에서 다음 명령어를실행하세요:
node -v npm -v버전명이 표시되면 준비가 완료된 것이므로 1단계로 진행할 수 있습니다. 그렇지 않은 경우, node.js 웹사이트로 이동하여 사용 중인 운영 체제에 맞는 최신 버전을 설치하십시오.
Tulip API 자격 증명 구성
API를 통해 Tulip에 연결하려면 API 자격 증명을 안전하게 저장하는 .env 파일을 생성해야 합니다.
1. 구성 폴더 만들기
환경 구성 파일을 저장할 폴더를 선택하거나 새로 만드세요.
가이드: .env 파일 생성
이 파일에는 Tulip 자격 증명이 저장됩니다. .env 파일 예시는 여기에서 확인할 수 있습니다.
Mac 사용자:
- 터미널을 열고 다음 명령어를 실행하세요:
bashtouch .envnano .env2. 새 파일에 (다음 단계에 있는) 자격 증명 템플릿을 붙여넣으세요.3. 자격 증명을 추가한 후, 아래의 저장 지침을 따르세요.
Windows 사용자:
- 메모장을 엽니다.
- (다음 단계에 나오는) 자격 증명 템플릿을 새 파일에 붙여넣으세요.
- 인증 정보를 추가한 후, 아래의 저장 지침을 따르십시오.
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 파일 경로 찾기
.env파일을 생성한 폴더로 이동합니다.- Windows의 경우:
Shift키를 누른 상태에서.env파일을 마우스 오른쪽 버튼으로 클릭한 다음, “경로로 복사”를 선택합니다. - macOS의 경우:
.env파일을 마우스 오른쪽 버튼으로 클릭한 상태에서Option키를 누른 다음, "경로명으로 .env 복사"를 선택합니다. - 아래의 클라이언트 구성에서 이 복사한 경로를 사용하게 됩니다.
가이드: Claude Desktop
- Claude Desktop 메뉴 바에서 설정... > 개발자 > 구성 편집을 선택합니다.
- 그러면
claude_desktop_config.json파일이 열립니다. mcpServers객체 안에 서버 구성을 추가합니다."C:\\path\\to\\your\\.env"를복사한 실제 경로로 대체해야 합니다.json { "mcpServers": { "tulip-mcp": { "command": "npx", "args": [ "@tulip/mcp-server", "--env", "C:\\path\\to\\your\\.env" ] } } }- 파일을 저장하고 Claude Desktop을 다시 시작하세요.
자세한 내용은 공식 Claude Desktop MCP 퀵스타트를 참조하세요.
커서
가장 간편하게 설정하려면 아래 버튼을 클릭하세요. 그러면 Cursor에 명령어가 미리 입력됩니다.
버튼을 클릭한 후, 자리 표시자 텍스트 (REPLACE_WITH_YOUR_ENV_FILE_PATH_HERE) 를 앞서 복사해 둔 .env 파일의 전체 경로로 대체해야 합니다.
고급 구성
Tulip API 자격 증명 가져오기
Tulip instance 설정에서 API 자격 증명(서비스 계정)을 생성할 수 있습니다.
- 로그인: Tulip instance 에 접속하세요.
- Tulip API로 이동: 설정 > Tulip API로 이동합니다.
- 새 서비스 계정 생성: 새 서비스 계정을 생성하고, 설명이 명확한 이름(예: "MCP 서버")을 지정합니다.
- 범위(Scopes) 구성: 서비스 계정에 필요한 권한(범위)을 부여합니다. 기본 액세스를 위한 권장 범위 세트는 다음과 같습니다.
stations:read, users:read, tables:read, machines:read, apps:read, urls:sign - 인증 정보 복사: 생성된 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)
