Baserow

Baserow MCP

AI 에이전트를 Baserow에 연결하세요. 에이전트는 로그인 시 허용한 도구만 사용하여 하나의 Baserow 워크스페이스에서 테이블을 읽고 변경할 수 있습니다.

이 저장소는 Baserow의 MCP 서버와 에이전트가 이를 사용하는 방법을 가르치는 짧은 스킬을 설치합니다. Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi 및 기타 에이전트와 함께 작동합니다.

서버 URL

• baserow.io: https://api.baserow.io/mcp
• 자체 호스팅: 백엔드 URL 뒤에 /mcp을 붙입니다(예: https://baserow.example.com/mcp). Baserow에서 내 설정 → MCP 서버에서 복사하세요.

아래 예시는 baserow.io URL을 사용합니다. 자체 호스팅 Baserow에서는 자체 URL을 대신 사용하세요.

빠른 시작

npx add-mcp https://api.baserow.io/mcp -n baserow -g
npx skills add baserow/baserow-mcp

add-mcp은 설치된 에이전트를 찾아 Baserow를 추가할 에이전트를 묻습니다. Claude Desktop이 목록에 있으면 체크를 해제하고 대신 사용자 지정 커넥터로 Baserow를 추가하세요. skills add은 baserow-basics 스킬을 에이전트의 스킬 폴더에 복사합니다. 자체 호스팅 Baserow에서는 아래 플러그인에만 스킬이 포함되어 있으므로 skills add도 실행하세요.

자체 호스팅 요구 사항

• 2.4.1보다 최신 버전의 Baserow. 이전 버전에는 /mcp 또는 로그인이 없으므로 엔드포인트 키를 사용하세요.
• 백엔드에서 BASEROW_MCP_OAUTH_ENABLED=true. 기본적으로 꺼져 있습니다.
• 공개 HTTPS 백엔드 URL(Claude.ai, ChatGPT 같은 호스팅 앱이 접근할 수 있어야 함)과 백엔드의 아웃바운드 HTTPS(앱의 클라이언트 메타데이터를 가져오는 데 사용).
• 리버스 프록시가 /mcp 및 /mcp/, /oauth/, /.well-known/oauth-authorization-server, /.well-known/oauth-protected-resource 아래 경로를 백엔드로 전달해야 합니다. /mcp을 접두사가 아닌 정확히 일치시켜야 합니다. 프런트엔드는 /mcp-authorize/에서 로그인 페이지를 제공합니다.

자체 호스팅 Baserow용 MCP OAuth 로그인을 참조하세요.

에이전트별 설치

에이전트	baserow.io	자체 호스팅
Claude Code	플러그인	동일한 플러그인, 요청 시 URL 입력
Claude.ai, Claude Desktop	사용자 지정 커넥터	동일, 자체 URL 사용
ChatGPT	사용자 지정 MCP 서버	동일, 자체 URL 사용
Codex	플러그인	codex mcp add baserow --url <your url>
GitHub Copilot CLI	플러그인	서버만
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Cursor에 추가	구성 파일
VS Code	VS Code에 추가	구성 파일
Goose	Goose에 추가	빠른 시작 및 자체 URL
OpenCode, Windsurf, Zed	구성 파일	동일, 자체 URL 사용
기타 에이전트	빠른 시작	동일, 자체 URL 사용

Codex, Copilot, Gemini 플러그인과 "추가" 버튼은 항상 baserow.io를 가리키므로 자체 호스팅 Baserow에서는 해당 에이전트에 서버만 추가하세요.

Claude Code

/plugin marketplace add baserow/baserow-mcp
/plugin install baserow@baserow

URL을 묻는 메시지가 표시되면 Esc를 눌러 baserow.io를 유지하거나 자체 호스팅 URL을 입력하세요. 나중에 변경하려면 /plugin configure baserow@baserow을 실행하세요.

Claude.ai 및 Claude Desktop

사용자 지정 → 커넥터 → + 추가 → 사용자 지정 커넥터 추가. 이름을 Baserow로 지정하고 서버 URL을 입력하세요. Team 및 Enterprise 요금제에서는 소유자가 조직 설정 → 커넥터에서 추가합니다.

ChatGPT

플러그인을 열고 더하기 버튼을 선택한 다음 사용자 지정 MCP 서버 추가를 선택하고 서버 URL을 입력하세요. 메뉴 이름은 자주 변경됩니다. Business 및 Enterprise 요금제에서는 관리자가 먼저 사용자 지정 MCP 서버를 허용해야 합니다.

Codex

codex plugin marketplace add baserow/baserow-mcp
codex plugin add baserow@baserow
codex mcp login baserow

GitHub Copilot CLI

copilot plugin marketplace add baserow/baserow-mcp
copilot plugin install baserow@baserow

자체 호스팅 Baserow에서는 서버만 추가하세요: copilot mcp add --transport http baserow <your url>. 플러그인이 설치된 경우 먼저 copilot plugin uninstall baserow으로 제거하세요. 플러그인의 서버가 경고 없이 사용자 서버를 대체합니다.

구성 파일

플러그인 없이 서버만 추가하려면:

• Cursor, ~/.cursor/mcp.json:

  { "mcpServers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

• VS Code, .vscode/mcp.json:

  { "servers": { "baserow": { "type": "http", "url": "https://api.baserow.io/mcp" } } }
  

• OpenCode, opencode.json, 그 다음 opencode mcp auth baserow:

  { "mcp": { "baserow": { "type": "remote", "url": "https://api.baserow.io/mcp" } } }
  

• Windsurf, ~/.codeium/windsurf/mcp_config.json:

  { "mcpServers": { "baserow": { "serverUrl": "https://api.baserow.io/mcp" } } }
  

• Zed, 설정:

  { "context_servers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

로그인

에이전트가 브라우저에서 Baserow 페이지를 엽니다. 로그인하고 워크스페이스를 선택한 다음 에이전트가 사용할 도구를 선택하세요. 읽기 도구는 에이전트가 데이터베이스, 테이블, 행을 탐색할 수 있게 하고, 쓰기 도구는 행을 생성, 업데이트, 삭제할 수 있게 합니다. 첫 연결에서는 읽기 도구만 선택됩니다.

로그인 시작 위치:

• Claude Code: /mcp 실행, plugin:baserow:baserow 선택 후 인증.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor, VS Code: 서버 옆의 연결 또는 로그인 버튼.

워크스페이스나 도구를 변경하려면 다시 로그인하세요. 에이전트에서 서버를 다시 인증하거나 Baserow의 내 설정 → MCP 서버에서 앱을 연결 해제한 후 다시 연결하세요. 단순히 다시 연결하면 이전 로그인이 유지됩니다.

문제 해결

• 도구가 없거나 데이터베이스가 나열되지 않음. 연결에는 로그인 시 선택한 워크스페이스와 도구만 있습니다. 위 설명대로 다시 로그인하세요. 테이블이나 필드를 변경하는 도구는 MCP에서 사용할 수 없습니다.
• 로그인이 시작되지 않거나 클라이언트가 OAuth 또는 클라이언트 등록을 지원하지 않는다고 표시됨. 자체 호스팅 Baserow에서는 자체 호스팅 요구 사항을 확인하세요.
• 입력한 URL로 연결 실패. 내 설정 → MCP 서버에 표시된 URL을 정확히 복사하세요. /mcp으로 끝나며 끝에 슬래시가 없습니다.
• Claude Code에 Baserow 서버가 두 개. claude mcp list에 플러그인의 plugin:baserow:baserow와 직접 추가한 baserow 서버가 표시되면 연결되는 서버를 유지하세요. claude plugin disable baserow@baserow은 플러그인의 서버를 끄고, claude mcp remove baserow은 사용자 서버를 제거합니다.

엔드포인트 키

Baserow 2.4.1 이하에서는 엔드포인트 키만 허용하며 플러그인은 이를 설정하지 않습니다. 내 설정 → MCP 서버에서 엔드포인트 URL을 복사하세요. /sse으로 끝나고 키가 포함되어 있습니다. Claude Code, Cursor, VS Code처럼 SSE 서버를 지원하는 에이전트에 직접 추가하세요. Codex와 Goose는 지원하지 않습니다:

npx add-mcp "<endpoint url>" -t sse -n baserow -g -a claude-code

최신 버전에서는 /mcp의 헤더로 키를 허용하며, 이는 스크립트에 유용합니다:

npx add-mcp https://baserow.example.com/mcp -n baserow -g -a claude-code -h "Authorization: Bearer <key>"

키는 해당 워크스페이스에 대한 전체 액세스 권한을 제공합니다. -g은 현재 폴더 대신 사용자 구성에 기록하므로 커밋에 포함되지 않습니다.

개인정보 및 지원

• 개인정보 처리방침: https://baserow.io/privacy-policy
• 이용약관: https://baserow.io/terms-and-conditions
• 도움말: 커뮤니티 포럼 또는 문의하기

개발

scripts/에서 npm install을 실행한 다음 npm test 및 npm run check를 실행하세요. CI도 동일한 검사를 실행합니다. 플러그인 설치 시 해당 종속성이 설치되지 않도록 도구는 그곳에 있습니다.

Claude Code 플러그인은 .claude-plugin/plugin.json에서 서버를 선언하므로 입력한 URL을 사용할 수 있습니다. .mcp.json은 GitHub Copilot CLI 및 Cursor처럼 Claude 형식 플러그인을 읽는 다른 도구를 위한 baserow.io URL을 보관합니다.

라이선스

MIT