Overboard Studio — MCP 서버

Overboard Studio는 협업 화이트보드입니다. 이것은 공식 Model Context Protocol (MCP) 서버로, 모든 AI 에이전트(Claude, ChatGPT, Cursor, Codex 등)가 Overboard 웹 앱에서 실시간으로 표시되는 실제 공유 가능한 보드(포스트잇, 도형, 텍스트, 프레임, 차트, 순서도, 표, 커넥터 등)를 생성하고 관리할 수 있게 해줍니다.

호스팅된 엔드포인트 (권장): https://overboard.studio/mcp (OAuth 지원, Claude.ai, ChatGPT, Cursor 등 지원)

Stdio 모드: 로컬에서 실행되는 Claude Code / Cursor / Claude Desktop용.

빠른 연결

Claude.ai (웹)

설정 → 커넥터 → 사용자 지정 커넥터 추가 → URL: https://overboard.studio/mcp → OAuth 흐름 완료.

Claude Code

claude mcp add --transport http overboard https://overboard.studio/mcp
/mcp auth

Claude Desktop (stdio)

~/Library/Application Support/Claude/claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "overboard": {
      "command": "npx",
      "args": ["-y", "@overboard/mcp-server"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
      }
    }
  }
}

Cursor

.cursor/mcp.json에 추가:

{
  "mcpServers": {
    "overboard": {
      "url": "https://overboard.studio/mcp"
    }
  }
}

도구 (16)

보드

도구	설명	주석
`get_current_user`	인증된 사용자의 ID, 이메일, 표시 이름	읽기 전용
`list_boards`	소유하거나 초대받은 보드 목록	읽기 전용
`get_board`	보드 메타데이터 + 멤버/요소 수	읽기 전용
`create_board`	새 빈 보드 생성, 본인이 소유자가 됨	쓰기
`create_board_with_elements`	요소가 미리 채워진 새 보드 생성 (권장)	쓰기
`rename_board`	소유한 보드 이름 변경	쓰기, 멱등성
`delete_board`	보드, 멤버, 요소 삭제	파괴적
`get_board_url`	웹 앱에서 보드를 열기 위한 직접 URL	읽기 전용

요소

도구	설명	주석
`get_elements`	보드의 모든 요소	읽기 전용
`create_element`	포스트잇 / 도형 / 텍스트 / 프레임 / 차트 등 추가	쓰기
`bulk_create_elements`	일괄 생성 (2개 이상의 요소에 권장)	쓰기
`update_element`	속성 병합 — 이동/크기 조정/색상 변경/텍스트 편집	쓰기, 멱등성
`delete_element`	단일 요소 제거	파괴적

협업

도구	설명	주석
`get_collaborators`	역할이 포함된 보드 멤버	읽기 전용
`get_board_activity`	최근 요소 변경 사항 (기본값: 최근 24시간)	읽기 전용
`invite_to_board`	공유 가능한 초대 링크 생성	쓰기

요소 유형

sticky-note, text, path, shape, connector, frame, graph, chart, flowchart, table, timeline, kanban, doc, vote, timer, estimation

위치, 크기, 스타일에는 스마트 기본값이 적용되므로 사용자 지정하려는 항목만 지정하면 됩니다.

인증

호스팅된 엔드포인트는 OAuth 2.0을 사용합니다. 클라이언트(Claude.ai 등)가 사용자에게 Overboard의 인증 흐름을 한 번 안내하며, 토큰은 30일간 유효합니다.

Stdio 모드는 Supabase 서비스 역할 키를 사용합니다. 환경 변수로 전달하십시오. 각 도구 호출은 Supabase 행 수준 보안(Row-Level Security)을 통해 사용자별 보드 액세스를 강제합니다. 서비스 역할 키는 다중 사용자 상태를 읽거나 써야 하는 도구에 대해서만 RLS를 우회합니다.

소스에서 빌드

npm install
npm run build
node dist/index.js

HTTP 모드의 경우:

node dist/index.js --http --port=3002

MCP Inspector로 테스트

SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... \
  npx @modelcontextprotocol/inspector node dist/index.js

예시 프롬프트

연결 후 다음을 시도해 보세요:

"내 모든 보드 나열해줘"
"다음 항목에 대한 5개의 노란색 포스트잇이 포함된 스프린트 계획 보드 생성해줘: 로그인 디자인, API 설정, 테스트 작성, 스테이징 배포, 코드 리뷰"
"보드 {id}에 있는 모든 항목 보여줘"
"첫 번째 포스트잇을 (500, 300)으로 이동하고 녹색으로 변경해줘"
"보드 {id}에 대한 편집자 권한 초대 링크 생성해줘"

라이선스

MIT

Overboard Studio MCP Server