OpenCharts MCP

официальный

Подключите вашего ИИ-агента к OpenCharts — создавайте таблицы, доски, музыку и автоматизации из Claude Code, Codex или Cursor, не покидая терминал.

GitHub

Что можно делать с Open Charts MCP?

Создание проектов и управление ими — Создавайте блок-схемы, доски, заметки, презентации и многое другое с помощью инструментов create_flowchart, create_whiteboard, create_notes и create_presentation.
Работа с электронными таблицами — Просматривайте, читайте, создавайте и редактируйте Theo Sheets с поддержкой формул, используя inspect_sheet, get_sheet, create_sheet, update_sheet и edit_sheet.
Создание и запуск автоматизаций — Создавайте, настраивайте, активируйте и запускайте Theo Agents с помощью build_agent, create_agent, configure_agent_trigger и run_agent.
Управление досками 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 и отслеживайте использование AI-кредитов через get_credits.

Документация

OpenCharts MCP Server

Создавайте блок-схемы, заметки, слайды, таблицы, доски, сайты, агентов и песни в OpenCharts — прямо из вашего AI-клиента.

Веб-сайт · Документация · Получить API-ключ · Проблемы

Что это?

OpenCharts запускает публичный, размещенный сервер Model Context Protocol (MCP), который помещает весь продукт OpenCharts внутрь любого MCP-совместимого AI-клиента. Подключитесь один раз с помощью API-ключа, и ваш ассистент сможет создавать и управлять реальными проектами OpenCharts от вашего имени — блок-схемы, доски, заметки, презентации, электронные таблицы (Theo Sheets), доски Kanban + календарь, полноценные веб-сайты и приложения (Code Canvas), автоматизации (Theo Agents) и песни (Theo Symphony) — все на базе Theo, AI OpenCharts.

Это удаленный сервер через Streamable HTTP — ничего не нужно устанавливать или запускать локально. Направьте ваш клиент на конечную точку, вставьте ваш API-ключ и работайте.

Этот репозиторий является публичной документацией для этого сервера. Сам сервер размещается OpenCharts; вы не запускаете его самостоятельно.

Хотите подключиться менее чем за минуту? Используйте встроенное руководство по адресу opencharts.com/help/mcp-server или страницу настройки opencharts.com/theo-agents/mcp.

Быстрый старт

Создайте API-ключ на opencharts.com/theo-agents/mcp. Скопируйте его немедленно — полный ключ показывается только один раз.
Добавьте сервер в ваш AI-клиент, используя соответствующий фрагмент конфигурации ниже, заменив {{YOUR_API_KEY}} на ваш ключ.
Проверьте подключение, попросив вашего ассистента вызвать инструмент whoami — он должен вернуть вашу учетную запись OpenCharts.

Конечная точка

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

Транспорт: Streamable HTTP (POST)
Аутентификация: Authorization: Bearer <API key> (JWT из активного сеанса OpenCharts также работает)

⚠️ Всегда используйте хост 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}}"
      }
    }
  }
}

Инструменты

Сервер предоставляет 56 инструментов в 10 группах. Инструменты, использующие Theo AI или генерацию, расходуют AI-кредиты.

Проекты

Инструмент	Описание
`list_projects`	Список ваших проектов с пагинацией и фильтрами
`get_project`	Получить полные данные проекта по ID
`create_flowchart`	Создать проект блок-схемы с узлами и ребрами
`create_whiteboard`	Создать доску с нативными фигурами и элементами
`create_notes`	Создать проект заметок из Markdown
`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`	Установить триггер агента (вручную, расписание, вебхук, событие, telegram)
`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`	Создать живую электронную таблицу (сетка уровня Excel + формулы) из заголовков и строк
`update_sheet`	Редактировать таблицу, применяя структурированные операции редактирования — сохраняется как коммит с возможностью отката
`apply_sheet_ops`	Применить структурированные операции редактирования — или предложить изменение через слияние
`edit_sheet`	Редактировать таблицу с помощью инструкции на естественном языке (Theo планирует и применяет операции)
`list_sheet_commits`	Список коммитов изменений таблицы в стиле git (примененные / предложенные / слитые)
`diff_sheet_commit`	Показать разницу на уровне ячеек для коммита или предложения
`resolve_sheet_proposal`	Принять или отклонить ожидающее предложение изменения
`rollback_sheet`	Откатить живую таблицу к предыдущему коммиту (обратимо)

Доски

Инструмент	Описание
`create_board`	Создать доску проекта Kanban + календарь
`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`	Извлечь содержимое заметки как Markdown
`append_to_note`	Добавить содержимое Markdown к существующей заметке
`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 — метаданные защищенного ресурса
Документы: opencharts.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-ключ для долгосрочных интеграций.

Совместимые клиенты

Работает с любым клиентом, поддерживающим Model Context Protocol, включая:

Warp — агентная среда разработки
Claude Desktop и Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

Ссылки

🌐 Веб-сайт: opencharts.com
📖 Документация MCP: opencharts.com/help/mcp-server
🔑 Получить API-ключ: opencharts.com/theo-agents/mcp
💬 Сообщество: opencharts.com/community
🐛 Проблемы: GitHub Issues

Лицензия

Эта документация лицензирована в соответствии с CC-BY-4.0. Сервер OpenCharts MCP является размещенным продуктом — см. opencharts.com для условий и цен.