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: crm-mcp

📦 설치 옵션

옵션 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🔗 링크

• Quickbase API 문서

• 모델 컨텍스트 프로토콜

• 클로드 데스크탑