remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Requires Node.js 14 or higher as a prerequisite for running the MCP server that connects to the Quickbase API.

Quickbase MCP 커넥터

Quickbase JSON RESTful API 와 통합하기 위한 MCP(Model Context Protocol) 커넥터입니다.

면책 조항: 본 커넥터는 Quickbase, Inc.와 제휴, 후원 또는 보증되지 않는 비공식적이고 독립적인 프로젝트입니다. 본 커넥터는 어떠한 보증도 없이 "있는 그대로" 제공되며 Quickbase에서 지원하지 않습니다. 사용자는 본 커넥터 사용 시 모든 관련 법률, 규정 및 보안 요구 사항을 스스로 준수할 책임이 있습니다.

개요

이 커넥터는 모델 컨텍스트 프로토콜(MCP)을 사용하여 Claude와 같은 AI 비서가 Quickbase API와 상호 작용할 수 있도록 합니다. Quickbase를 사용하여 앱, 테이블, 필드, 레코드, 파일 및 보고서를 관리하는 다양한 작업을 지원합니다.

특징

사용자를 위해

AI 기반 Quickbase 액세스 : Claude를 통해 Quickbase 데이터와 직접 통신하세요
데이터 관리 : 자연어를 통해 앱, 테이블 및 레코드를 만들고, 보고, 업데이트합니다.
파일 처리 : 레코드에 파일 첨부 파일을 업로드하고 다운로드합니다.
보고서 액세스 : Quickbase 보고서를 실행하고 채팅에서 직접 결과를 확인하세요.
대용량 데이터 세트 지원 : 대량의 레코드를 쿼리할 때 자동으로 페이지 매김을 처리합니다.

개발자를 위한

포괄적인 API 범위 : 핵심 Quickbase API 기능에 대한 액세스
구조화된 응답 : 안정적인 구문 분석을 위한 일관된 응답 형식
일괄 작업 : 대량 레코드 작업의 효율적인 처리
오류 진단 : 상태 코드와 문제 해결 정보가 포함된 자세한 오류 메시지

필수 조건

Python 3.8 이상
Node.js 14 이상
Quickbase API 자격 증명(영역 호스트 이름, 사용자 토큰 및 앱 ID)

설치

저장소를 복제합니다.

지엑스피1

환경 설정:

./setup.sh

Quickbase 자격 증명을 구성하세요.

cp .env.example .env
# Edit .env with your credentials

빠른 시작

Claude 또는 Claude Code로 이 커넥터를 시도하고 싶은 분들을 위해:

종속성을 설치하고 서버를 설정합니다.

# Run the setup script to install all dependencies
./setup.sh

# Create a .env file with your Quickbase credentials
echo "QUICKBASE_REALM_HOST=your-realm.quickbase.com
QUICKBASE_USER_TOKEN=your_user_token_here
QUICKBASE_APP_ID=your_app_id_here" > .env

Claude Desktop과 함께 사용(권장):

Claude Desktop 서버를 자동으로 시작하는 구성 파일을 만드세요. 구성 파일 위치는 운영 체제에 따라 다릅니다.

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우 : %APPDATA%\Claude\claude_desktop_config.json
리눅스 : ~/.config/Claude/claude_desktop_config.json

다음 구성을 추가합니다.

{
  "mcpServers": {
    "quickbase": {
      "command": "/path/to/node",
      "args": [
        "/path/to/Quickbase-MCP-connector/src/quickbase/server.js"
      ],
      "env": {
        "QUICKBASE_REALM": "your-realm",
        "QUICKBASE_USER_TOKEN": "your-user-token",
        "QUICKBASE_APP_ID": "your-app-id"
      }
    }
  }
}

Claude Code와 함께 사용:

# This single command both registers and starts the MCP server
claude mcp add quickbase node src/quickbase/server.js

이제 Claude 세션에서 Quickbase 도구를 사용할 수 있습니다! 예시 프롬프트: "Quickbase 커넥터를 사용하여 Quickbase 앱의 모든 테이블을 나열하세요."

사용 가능한 도구 범주

연결 도구

test_connection : Quickbase API 연결을 확인하세요
check_auth : 인증 상태 및 권한 확인

앱 도구

get_app : 특정 앱에 대한 세부 정보를 가져옵니다.
get_apps : 사용 가능한 모든 앱 나열
create_app , update_app : 애플리케이션 생성 및 업데이트

테이블 도구

get_table , get_tables : 테이블 정보 검색
create_table , update_table : 테이블 생성 및 업데이트

현장 도구

get_field , get_fields : 필드 정보 검색
create_field , update_field : 필드 생성 및 업데이트

기록 도구

get_record , query_records : 레코드 데이터 검색
create_record , update_record : 개별 레코드 작업
bulk_create_records , bulk_update_records : 효율적인 일괄 작업

파일 도구

upload_file : 레코드 필드에 파일 업로드
download_file : 레코드 필드에서 파일을 다운로드합니다.
manage_attachments : 고급 첨부 파일 관리

보고서 도구

run_report : Quickbase 보고서 실행

구현되지 않음

다음 작업은 구현되지 않습니다.

삭제 작업(delete_app, delete_table, delete_field, delete_record, bulk_delete_records, delete_file)
사용자 작업(get_user, get_current_user, get_user_roles, manage_users)
양식 작업(manage_forms)
대시보드 작업(manage_dashboards)
파이프라인 작업(manage_pipelines)
FastField 양식 작업(manage_fast_field_form)

개발자 및 기여자를 위한

MCP 서버 수동 시작

개발이나 디버깅을 위해 서버를 수동으로 시작해야 하는 경우:

node src/quickbase/server.js

테스트 실행

이 섹션은 주로 변경 사항을 검증하거나 테스트 모음을 실행하려는 기여자를 위한 것입니다.

모든 테스트는 tests/ 디렉터리에 있습니다. 테스트 러너를 사용하여 특정 테스트 또는 모든 테스트를 실행할 수 있습니다.

# Run all tests
python tests/run_tests.py --all

# Run specific tests
python tests/run_tests.py connection pagination file

# Run the comprehensive validation script
python tests/run_tests.py validate

개별 테스트 스크립트도 직접 실행할 수 있습니다.

# Test connection
python tests/test_connection.py

# Test file operations
python tests/test_file_operations.py

# Test pagination
python tests/test_pagination.py

테스트에 대한 자세한 내용은 tests/README.md를 참조하세요.

환경 변수

다음 환경 변수를 구성해야 할 수도 있습니다.

# Quickbase API Credentials
QUICKBASE_REALM_HOST=your-realm.quickbase.com
QUICKBASE_USER_TOKEN=your_user_token_here
QUICKBASE_APP_ID=your_app_id_here

# For file operation testing
QUICKBASE_TABLE_ID=your_table_id_here
QUICKBASE_RECORD_ID=your_record_id_here
QUICKBASE_FILE_FIELD_ID=your_file_field_id_here

# MCP Server Settings (optional)
MCP_SERVER_PORT=3535

오류 처리

커넥터는 다음을 통해 포괄적인 오류 처리를 제공합니다.

오류 유형 분류
HTTP 상태 코드
Quickbase API의 자세한 오류 메시지
제안된 솔루션
매개변수 검증
JSON 데이터 검증
API 요청 오류의 적절한 처리

일반적인 오류 시나리오

필수 매개변수가 없습니다
잘못된 JSON 데이터 형식입니다
존재하지 않는 테이블 또는 필드 ID
잘못된 WHERE 절 구문
인증 실패
권한 문제
네트워크 연결 문제

모든 오류 응답에는 문제 해결에 도움이 되는 유용한 진단 정보가 포함되어 있습니다.

기여하다

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 만들기

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Claude 및 기타 MCP 클라이언트를 통해 Quickbase의 JSON RESTful API와 상호 작용하기 위한 표준화된 인터페이스를 제공하여 레코드 쿼리, 테이블 관계 관리, 파일 첨부 처리와 같은 작업을 지원합니다.

Quickbase MCP Server