OpenCharts MCP

공식

AI 에이전트를 OpenCharts에 연결하여 Claude Code, Codex, Cursor에서 터미널을 벗어나지 않고 스프레드시트, 보드, 음악, 자동화를 구축하세요.

GitHub

Open Charts MCP(으)로 무엇을 할 수 있나요?

프로젝트 생성 및 관리 — create_flowchart, create_whiteboard, create_notes, create_presentation 같은 도구를 사용하여 순서도, 화이트보드, 노트, 프레젠테이션 등을 제작하세요.
스프레드시트 작업 — inspect_sheet, get_sheet, create_sheet, update_sheet, edit_sheet를 사용하여 수식 지원이 포함된 Theo Sheets를 검사, 읽기, 생성, 편집하세요.
자동화 구축 및 실행 — build_agent, create_agent, configure_agent_trigger, run_agent로 Theo Agents를 생성, 구성, 활성화 및 실행하세요.
Kanban 보드 관리 — create_board, add_board_card, update_board_card, list_board_cards를 사용하여 보드를 만들고, 카드를 추가 및 업데이트하며, 목록을 관리하세요.
웹사이트 및 노래 생성 — generate_code_canvas로 전체 웹사이트나 앱을 구축하고, create_song으로 음악을 만든 후 get_code_canvas_status와 get_song_status로 상태를 확인하세요.
계정 및 크레딧 확인 — whoami로 연결 상태를 확인하고, get_credits로 AI 크레딧 사용량을 모니터링하세요.

문서

OpenCharts MCP 서버

AI 클라이언트에서 바로 OpenCharts의 순서도, 노트, 슬라이드, 시트, 보드, 사이트, 에이전트 및 노래를 제작하세요.

웹사이트 · 문서 · API 키 발급 · 이슈

무엇인가요?

OpenCharts는 공개 호스팅형 모델 컨텍스트 프로토콜 (MCP) 서버를 운영하여, 모든 MCP 호환 AI 클라이언트에 OpenCharts 제품 전체를 제공합니다. API 키로 한 번 연결하면, 여러분의 어시스턴트가 순서도, 화이트보드, 노트, 프레젠테이션, 스프레드시트(Theo Sheets), 칸반 + 캘린더 보드, 전체 웹사이트 및 앱(Code Canvas), 자동화(Theo Agents), 노래(Theo Symphony) 등 실제 OpenCharts 프로젝트를 대신 제작하고 관리할 수 있습니다. 이 모든 것은 OpenCharts AI, Theo가 지원합니다.

이 서버는 Streamable HTTP를 통한 원격 서버이므로 로컬에 설치하거나 실행할 필요가 없습니다. 클라이언트를 엔드포인트로 지정하고 API 키를 붙여넣기만 하면 됩니다.

이 저장소는 해당 서버의 공개 문서입니다. 서버 자체는 OpenCharts에서 호스팅하므로 직접 실행하지 않습니다.

1분 안에 연결하고 싶으신가요? **opencarts.com/help/mcp-server**의 인앱 가이드 또는 **opencarts.com/theo-agents/mcp**의 설정 페이지를 이용하세요.

빠른 시작

opencarts.com/theo-agents/mcp에서 API 키를 생성하세요. 전체 키는 한 번만 표시되므로 즉시 복사하세요.
아래 설정 스니펫 중 해당하는 것을 사용하여 AI 클라이언트에 서버를 추가하고, {{YOUR_API_KEY}}를 여러분의 키로 교체하세요.
어시스턴트에게 whoami 도구를 호출하도록 요청하여 연결을 확인하세요. 여러분의 OpenCharts 계정이 반환되어야 합니다.

엔드포인트

https://www.opencharts.com/api/mcp

전송 방식: Streamable HTTP (POST)
인증: Authorization: Bearer <API key> (활성 OpenCharts 세션의 JWT도 사용 가능)

⚠️ 항상 www. 호스트를 사용하세요. 최상위 opencharts.com은 307 리디렉션을 실행하여 Authorization 헤더를 제거하고 인증을 중단시킵니다. 정확히 https://www.opencharts.com/api/mcp를 사용하세요.

AI 클라이언트 연결하기

이 서버는 모든 MCP 호환 클라이언트와 작동합니다. 해당하는 스니펫을 복사하고 API 키를 넣으세요. 어시스턴트가 설정하도록 하시겠습니까? 도움말 페이지에는 아래 모든 클라이언트를 위한 "AI 설정 프롬프트"가 있습니다.

Warp

{
  "mcpServers": {
    "opencharts": {
      "type": "http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "opencharts": {
      "type": "streamable-http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "opencharts": {
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json에 추가하세요:

{
  "servers": {
    "opencharts": {
      "type": "http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:opencharts-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "opencharts-key",
      "type": "promptString",
      "description": "OpenCharts API key",
      "password": true
    }
  ]
}

Windsurf (Codeium)

{
  "mcpServers": {
    "opencharts": {
      "serverUrl": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http opencharts https://www.opencharts.com/api/mcp --header "Authorization: Bearer {{YOUR_API_KEY}}"

Codex (OpenAI)

codex mcp add opencharts --url https://www.opencharts.com/api/mcp --header "Authorization: Bearer {{YOUR_API_KEY}}"

Amp

VS Code 확장 settings.json에서:

"amp.mcpServers": {
  "opencharts": {
    "url": "https://www.opencharts.com/api/mcp",
    "headers": {
      "Authorization": "Bearer {{YOUR_API_KEY}}"
    }
  }
}

OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "opencharts": {
      "type": "remote",
      "url": "https://www.opencharts.com/api/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

도구

서버는 10개 그룹에 걸쳐 56개의 도구를 제공합니다. Theo AI 또는 생성 기능을 사용하는 도구는 AI 크레딧을 소모합니다.

프로젝트

도구	설명
`list_projects`	페이지네이션 및 필터로 프로젝트 나열
`get_project`	ID로 전체 프로젝트 데이터 가져오기
`create_flowchart`	노드와 엣지로 순서도 프로젝트 생성
`create_whiteboard`	기본 도형과 요소로 화이트보드 생성
`create_notes`	마크다운으로 노트 프로젝트 생성
`create_presentation`	개요로 슬라이드 덱 생성
`update_project`	메타데이터 또는 콘텐츠 업데이트 (노트, 순서도, 화이트보드, 프레젠테이션)
`delete_project`	프로젝트 소프트 삭제 (30일 복구 가능)

Code Canvas

도구	설명
`generate_code_canvas`	설명으로 전체 웹사이트 또는 앱(HTML/React) 빌드 — 폴링할 작업 반환
`get_code_canvas_status`	Code Canvas 빌드 폴링; 준비되면 프로젝트 + 열기 URL 반환

AI

도구	설명
`ask_theo`	단일 턴 AI 메시지 전송 (빠른 모드 또는 생각 모드)
`extract_flowchart`	업로드된 문서(PDF, 이미지, PPTX)에서 순서도 추출

Theo Agents

도구	설명
`build_agent`	설명으로 Theo Agent 빌드 — 백그라운드에서 실행, 준비되면 알림
`get_agent_build_status`	`build_agent` 작업에 대한 선택적 폴링; 완료 시 에이전트 + 열기 URL 반환
`create_agent`	구조화된 단계 + 트리거로 결정론적 Theo Agent 생성
`update_agent`	에이전트의 이름, 설명 또는 단계 목록 패치
`configure_agent_trigger`	에이전트의 트리거 설정 (수동, 일정, 웹훅, 이벤트, 텔레그램)
`activate_agent`	에이전트 활성화 (첫 번째 예약 실행 시드)
`deactivate_agent`	트리거 실행이 중지되도록 에이전트 비활성화
`delete_agent`	에이전트 소프트 삭제 (30일 복구 가능)
`list_agents`	상태 + 단계 수와 함께 Theo Agents 나열
`get_agent`	에이전트의 전체 정의 가져오기 (트리거 + 순서 단계)
`run_agent`	지금 에이전트 디스패치 — 백그라운드에서 실행, 완료 시 알림
`list_agent_runs`	에이전트의 최근 실행 기록 나열
`get_agent_run_status`	단일 실행의 상태 + 노드별 진행 상황 가져오기

Theo Sheets

도구	설명
`list_sheets`	Theo Sheets 스프레드시트 프로젝트 나열
`inspect_sheet`	시트 검사 — 탭별 크기, 헤더 행, 샘플 셀 + 수식, 레이아웃
`get_sheet`	워크시트를 구조화된 행(헤더 + 데이터 행)으로 추출
`read_sheet_range`	정확한 A1 범위의 값(+ 선택적 수식)을 그리드 + CSV로 읽기
`create_sheet`	헤더와 행으로 라이브 스프레드시트(엑셀급 그리드 + 수식) 생성
`update_sheet`	구조화된 스프레드시트 편집 작업을 적용하여 시트 편집 — 롤백 가능한 커밋으로 저장
`apply_sheet_ops`	구조화된 스프레드시트 편집 작업 적용 — 또는 병합 게이트 변경 제안
`edit_sheet`	자연어 지시로 시트 편집 (Theo가 계획 + 작업 적용)
`list_sheet_commits`	시트의 git 스타일 변경 커밋 나열 (적용됨 / 제안됨 / 병합됨)
`diff_sheet_commit`	커밋 또는 제안에 대한 셀 수준 차이 표시
`resolve_sheet_proposal`	보류 중인 변경 제안 병합 또는 거부
`rollback_sheet`	라이브 시트를 이전 커밋으로 롤백 (되돌릴 수 있음)

보드

도구	설명
`create_board`	칸반 + 캘린더 프로젝트 보드 생성
`list_boards`	프로젝트 보드 나열
`get_board`	보드의 목록(열) 및 카드 가져오기
`update_board`	보드의 이름, 설명 또는 목록 열 업데이트
`delete_board`	보드 소프트 삭제 (복구 가능)
`duplicate_board`	목록, 규칙 및 카드와 함께 보드 복제
`add_board_card`	보드에 카드(게시물/작업/아이디어/이벤트) 추가
`list_board_cards`	보드의 카드 나열, 선택적으로 일정 범위별
`update_board_card`	카드 편집 — 목록 이동, 일정 변경, 상태/색상 변경
`delete_board_card`	보드에서 카드 소프트 삭제

Theo Symphony

도구	설명
`create_song`	Theo Symphony로 노래 생성 — 폴링할 작업 반환
`get_song_status`	노래 작업 폴링; 완료 시 오디오 + 커버 아트 버전 반환

노트

도구	설명
`get_note_content`	노트의 콘텐츠를 마크다운으로 추출
`append_to_note`	기존 노트에 마크다운 콘텐츠 추가
`clip_to_note`	웹 콘텐츠(URL + HTML)를 노트 안에 클립으로 저장

템플릿

도구	설명
`list_templates`	템플릿 갤러리 탐색
`use_template`	템플릿으로 새 프로젝트 생성

계정

도구	설명
`whoami`	인증된 사용자의 프로필 정보 가져오기
`get_credits`	남은 AI 크레딧 잔액 확인

리소스

리소스는 AI 클라이언트가 도구를 호출하지 않고도 검색할 수 있는 읽기 전용 컨텍스트를 제공합니다.

리소스	설명
`projects`	최근 프로젝트의 페이지네이션된 목록
`project`	ID별 단일 프로젝트의 전체 데이터
`templates`	탐색 가능한 템플릿 카탈로그

작동 방식

┌────────────────────┐   Streamable HTTP    ┌────────────────────────────┐
│   Your AI client    │   + Bearer API key   │   OpenCharts MCP (hosted)  │
│  Warp · Claude ·    │ ───────────────────► │                            │
│  Cursor · VS Code · │                      │  Projects · Code Canvas ·  │
│  Windsurf · Codex · │ ◄─────────────────── │  Agents · Sheets · Boards ·│
│  Amp · OpenCode     │      tool results    │  Symphony · Notes · AI     │
└────────────────────┘                      └────────────────────────────┘

모든 요청은 여러분의 API 키로 인증되며 여러분의 OpenCharts 계정에 대해 작동합니다. 서버가 호스팅되므로 도구 환경은 클라이언트 업데이트 없이 자동으로 최신 상태를 유지합니다. Theo AI 또는 생성 기능을 사용하는 도구(예: ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song)는 플랜의 AI 크레딧을 소모합니다.

속도 제한 및 크레딧

사용자당 분당 120 요청.
AI 및 생성 도구는 AI 크레딧을 소모합니다 — get_credits 도구로 언제든지 잔액을 확인하세요.

검색 및 레지스트리

클라이언트, 크롤러 및 레지스트리를 위해 기계 판독 가능한 메타데이터가 게시됩니다(비밀 정보 없음):

https://www.opencharts.com/.well-known/mcp — 검색 매니페스트
https://www.opencharts.com/.well-known/mcp/server-card.json — 서버 카드
https://www.opencharts.com/.well-known/oauth-protected-resource — 보호된 리소스 메타데이터
문서: opencarts.com/help/mcp-server

문제 해결

307 리디렉션 / "인증 지원 없음" / 401 — URL이 정확히 https://www.opencharts.com/api/mcp (www. 포함)인지 확인하세요. 최상위 호스트는 리디렉션 시 Authorization 헤더를 제거합니다. 또한 키가 활성 상태이고 Bearer 접두사와 함께 전송되는지 확인하세요.
429 Too Many Requests — 분당 120 요청 제한에 도달했습니다. 잠시 기다렸다가 다시 시도하세요.
클라이언트에 도구가 없음 — 클라이언트를 완전히 다시 시작하거나(또는 OpenCharts 서버를 껐다 켜서) 도구 목록을 다시 가져오도록 합니다. 키에 read, write 및 ai 범위가 포함되어 있는지 확인하세요(기본 키에는 세 가지 모두 포함됨).
세션 중 JWT 만료 — 세션 JWT는 약 15분 후에 만료됩니다. 장기 실행 통합에는 영구 API 키를 사용하세요.

호환 클라이언트

모델 컨텍스트 프로토콜을 지원하는 모든 클라이언트와 작동합니다:

Warp — 에이전트 개발 환경
Claude Desktop & Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

링크

🌐 웹사이트: opencarts.com
📖 MCP 문서: opencarts.com/help/mcp-server
🔑 API 키 발급: opencarts.com/theo-agents/mcp
💬 커뮤니티: opencarts.com/community
🐛 이슈: GitHub Issues

라이선스

이 문서는 CC-BY-4.0에 따라 라이선스가 부여됩니다. OpenCharts MCP 서버는 호스팅 제품입니다 — 이용 약관 및 가격은 opencarts.com을 참조하세요.