OpenCharts MCP

официальный

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

GitHub

Попробовать этот MCPСпонсировано

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

Создавайте блок-схемы, доски, заметки и презентации — генерируйте структурированные проекты напрямую с помощью create_flowchart, create_whiteboard, create_notes или create_presentation.
Создавайте полноценные сайты или приложения по описанию — используйте generate_code_canvas для запуска сборки Code Canvas, затем опрашивайте get_code_canvas_status для получения результата.
Управляйте агентами Theo от начала до конца — создавайте, настраивайте триггеры, активируйте, запускайте и отслеживайте агентов с помощью инструментов build_agent, configure_agent_trigger, run_agent и get_agent_run_status.
Работайте с живыми таблицами (Theo Sheets) — создавайте, просматривайте, считывайте диапазоны, применяйте структурированные правки и откатывайте изменения с помощью create_sheet, read_sheet_range, apply_sheet_ops и rollback_sheet.
Генерируйте изображения и видео прямо в процессе — вызывайте generate_image для получения мгновенных публичных URL или generate_video и опрашивайте get_video_status для готовых клипов.
Проверяйте свой аккаунт и баланс AI-кредитов — подтверждайте подключение с помощью whoami и отслеживайте использование через get_credits.

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

Сервер OpenCharts MCP

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

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

Что это?

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

Это удаленный сервер, работающий по протоколу 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}}"
      }
    }
  }
}

Инструменты

Сервер предоставляет 59 инструментов в 11 группах. Инструменты, использующие 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`	Создать доску проекта с канбаном и календарем
`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`	Опрос задачи песни; возвращает аудио и версии обложки по завершении

Theo Media

Инструмент	Описание
`generate_image`	Сгенерировать изображение по промпту — возвращает публичный URL для встраивания или сохранения (используйте вместо заглушек)
`generate_video`	Сгенерировать короткий видеоклип по промпту — возвращает задачу для опроса
`get_video_status`	Опрос задачи видео; возвращает URL готового клипа по завершении

Заметки

Инструмент	Описание
`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, generate_image, generate_video), расходуют 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.