OpenCharts MCP

公式

AIエージェントをOpenChartsに接続—Claude Code、Codex、Cursorからターミナルを離れずにスプレッドシート、ボード、音楽、自動化を構築できます。

GitHub

Open Charts MCPで何ができますか？

Create and manage projects — Build flowcharts, whiteboards, notes, presentations, and more using tools like create_flowchart, create_whiteboard, create_notes, and create_presentation.
Work with spreadsheets — Inspect, read, create, and edit Theo Sheets with formula support using inspect_sheet, get_sheet, create_sheet, update_sheet, and edit_sheet.
Build and run automations — Create, configure, activate, and run Theo Agents with build_agent, create_agent, configure_agent_trigger, and run_agent.
Manage Kanban boards — Create boards, add and update cards, and manage lists with create_board, add_board_card, update_board_card, and list_board_cards.
Generate websites and songs — Build full websites or apps with generate_code_canvas and create music with create_song, then poll status with get_code_canvas_status and get_song_status.
Check account and credits — Verify your connection with whoami and monitor AI credit usage with get_credits.

ドキュメント

OpenCharts MCP Server

AIクライアントから直接、OpenChartsでフローチャート、ノート、スライド、シート、ボード、サイト、エージェント、楽曲を構築します。

ウェブサイト · ドキュメント · APIキーを取得 · 課題

これは何ですか？

OpenCharts は、公開・ホスト型の Model Context Protocol (MCP) サーバー を運用しており、OpenCharts 製品全体をあらゆる MCP 互換 AI クライアント内で利用可能にします。API キーで一度接続すれば、あなたのアシスタントがあなたに代わって実際の OpenCharts プロジェクトを構築・管理できます — フローチャート、ホワイトボード、ノート、プレゼンテーション、スプレッドシート (Theo Sheets)、かんばん + カレンダーボード、本格的なウェブサイト & アプリ (Code Canvas)、自動化 (Theo Agents)、楽曲 (Theo Symphony) — すべて OpenCharts AI の Theo によって実現されます。

これは Streamable HTTP 経由のリモートサーバー であり、ローカルにインストールしたり実行したりするものは一切ありません。クライアントをエンドポイントに向け、API キーを貼り付ければ、すぐに開始できます。

このリポジトリは、そのサーバーの公開ドキュメントです。サーバー自体は OpenCharts によってホストされており、ご自身で実行するものではありません。

1分以内に接続したいですか？ opencharts.com/help/mcp-server のアプリ内ガイド、または opencharts.com/theo-agents/mcp のセットアップページをご利用ください。

クイックスタート

API キーを作成します: opencharts.com/theo-agents/mcp にアクセスし、すぐにコピーしてください — 完全なキーは一度しか表示されません。
サーバーを追加します: 以下の対応する設定スニペットを使用し、{{YOUR_API_KEY}} をあなたのキーに置き換えて AI クライアントに追加します。
接続を確認します: アシスタントに whoami ツールを呼び出すように依頼してください — あなたの OpenCharts アカウントが返されるはずです。

エンドポイント

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

トランスポート: Streamable HTTP (POST)
認証: Authorization: Bearer <API key> (アクティブな OpenCharts セッションからの JWT も使用可能)

⚠️ 常に www. ホストを使用してください。 apex 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`	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`	エージェントのトリガーを設定 (手動、スケジュール、Webhook、イベント、Telegram)
`activate_agent`	エージェントを有効化 (最初のスケジュール実行をシード)
`deactivate_agent`	トリガーの発火を停止するためにエージェントを無効化
`delete_agent`	エージェントを論理削除 (30日間の復旧期間あり)
`list_agents`	ステータス + ステップ数を含む Theo Agent を一覧表示
`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`	楽曲ジョブをポーリング。完了時にオーディオ + カバーアートバージョンを返します

ノート

ツール	説明
`get_note_content`	ノートのコンテンツを Markdown として抽出
`append_to_note`	既存のノートに Markdown コンテンツを追加
`clip_to_note`	Web コンテンツ (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 リダイレクト / "no authorization support" / 401 — URL が正確に https://www.opencharts.com/api/mcp (www. 付き) であることを確認してください。apex ホストはリダイレクト時に Authorization ヘッダーを取り除きます。また、キーがアクティブで、Bearer プレフィックス付きで送信されていることを確認してください。
429 Too Many Requests — 毎分 120 リクエストの制限に達しました。待ってから再試行してください。
クライアントにツールが表示されない — クライアントを完全に再起動するか (または OpenCharts サーバーをオフ/オンに切り替える)、ツールリストを再取得してください。キーに read、write、ai スコープが含まれていることを確認してください (デフォルトのキーには 3 つすべてが含まれます)。
セッション中に 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 をご覧ください。