Quickbase MCP 서버
Claude Desktop 및 기타 AI 어시스턴트와의 원활한 통합을 위해 설계된 Quickbase용 TypeScript 기반 모델 컨텍스트 프로토콜(MCP) 서버입니다.
📋 커뮤니티 프로젝트 공지
이 통합 기능은 커뮤니티에서 개발한 것으로, 공식 Quickbase 제품이 아닙니다. Quickbase의 공개 API를 사용하지만 Quickbase, Inc.의 공식 지원은 제공되지 않습니다. 이 프로젝트는 "있는 그대로" 제공되며 커뮤니티에서 관리합니다. 공식 Quickbase 제품 및 지원은 quickbase.com을 방문하세요.
🚀 Claude Desktop 빠른 시작
한 줄 설정 확인
지엑스피1
Claude Desktop 구성
Claude Desktop 구성 파일에 다음을 추가하세요.
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우 : %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"quickbase": {
"command": "npx",
"args": ["-y", "mcp-quickbase"],
"env": {
"QUICKBASE_REALM_HOST": "your-realm.quickbase.com",
"QUICKBASE_USER_TOKEN": "your-user-token",
"QUICKBASE_APP_ID": "your-app-id"
}
}
}
}이제 끝입니다! Claude Desktop을 다시 시작하면 Quickbase 도구를 사용할 수 있습니다.
Related MCP server: Database Tools for Claude AI
📦 설치 옵션
옵션 1: NPM(권장)
# Use directly with npx (no installation needed)
npx -y mcp-quickbase
# Or install globally
npm install -g mcp-quickbase옵션 2: 소스에서
# Clone the repository
git clone https://github.com/danielbushman/MCP-Quickbase.git
cd MCP-Quickbase
# Install dependencies
npm install
# Build the project
npm run build소스 설치의 경우 다음 Claude Desktop 구성을 사용하세요.
{
"mcpServers": {
"quickbase": {
"command": "node",
"args": ["/path/to/MCP-Quickbase/dist/mcp-stdio-server.js"],
"env": {
"QUICKBASE_REALM_HOST": "your-realm.quickbase.com",
"QUICKBASE_USER_TOKEN": "your-user-token",
"QUICKBASE_APP_ID": "your-app-id"
}
}
}
}🔧 구성
환경 변수를 구성하지 않아도 서버를 시작할 수 있지만, 적절한 구성이 제공될 때까지 도구가 작동하지 않습니다. check_configuration 도구를 사용하여 설정을 확인하세요.
필수 환경 변수
QUICKBASE_REALM_HOST- Quickbase 영역(예:company.quickbase.com)QUICKBASE_USER_TOKEN- Quickbase API 토큰( 여기서 받으세요 )
선택적 환경 변수
QUICKBASE_APP_ID- 기본 애플리케이션 ID
선택 설정
QUICKBASE_CACHE_ENABLED- 캐싱 활성화(true/false, 기본값:true)QUICKBASE_CACHE_TTL- 캐시 기간(초) (기본값:3600)DEBUG- 디버그 로깅 활성화(true/false, 기본값:false)LOG_LEVEL- 로깅 레벨(DEBUG/INFO/WARN/ERROR, 기본값:INFO)
🛠️ 사용 가능한 도구
연결 및 구성
check_configuration- Quickbase 구성이 제대로 설정되었는지 확인합니다.test_connection- Quickbase에 대한 연결 테스트configure_cache- 캐싱 동작 구성
애플리케이션 관리
create_app- 새로운 Quickbase 애플리케이션 생성update_app- 기존 애플리케이션 업데이트list_tables- 애플리케이션의 모든 테이블 나열
테이블 작업
create_table- 새 테이블 생성update_table- 테이블 속성 업데이트get_table_fields- 테이블의 필드 정보 가져오기
현장 관리
create_field- 테이블에 새 필드 만들기update_field- 필드 속성 업데이트
기록 작업
query_records- 필터링 및 정렬을 사용한 레코드 쿼리create_record- 단일 레코드 생성update_record- 기존 레코드 업데이트bulk_create_records- 여러 레코드 만들기bulk_update_records- 여러 레코드 업데이트
파일 작업
upload_file- 파일 첨부 필드에 파일 업로드download_file- 레코드에서 파일 다운로드
보고
run_report- Quickbase 보고서 실행
📚 사용 예시
기본 레코드 쿼리
Query all customers from the Customers table새 레코드 만들기
Create a new customer record with name "Acme Corp" and status "Active"파일 업로드
Upload invoice.pdf to the Documents field in record 123🔒 보안
API 토큰은 안전하게 처리되며 기록되지 않습니다.
모든 파일 작업은 작업 디렉토리에 샌드박스됩니다.
필드 수준 권한 및 액세스 제어를 지원합니다.
📋 요구 사항
Node.js 18 이상
API 액세스가 가능한 유효한 Quickbase 계정
Claude Desktop(MCP 통합용)
🤝 기여하기
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
📄 라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.