OpenCharts MCP

公式

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

OpenCharts MCPで何ができますか?

  • フローチャート、ホワイトボード、ノート、プレゼンテーションを作成create_flowchartcreate_whiteboardcreate_notes、または create_presentation を使用して、構造化されたプロジェクトを直接生成します。
  • 説明文から完全なWebサイトやアプリを構築generate_code_canvas を使用してCode Canvasビルドを開始し、その後 get_code_canvas_status をポーリングして結果を取得します。
  • Theo Agentsをエンドツーエンドで管理build_agentconfigure_agent_triggerrun_agentget_agent_run_status などのツールを使用して、エージェントの作成、トリガーの設定、有効化、実行、監視を行います。
  • ライブスプレッドシート(Theo Sheets)を操作create_sheetread_sheet_rangeapply_sheet_opsrollback_sheet を使用して、作成、検査、範囲の読み取り、構造化編集の適用、変更のロールバックを行います。
  • 画像と動画をインラインで生成generate_image を呼び出して即時公開URLを取得するか、generate_video を呼び出して get_video_status をポーリングし、完成したクリップを取得します。
  • アカウントとAIクレジット残高を確認whoami で接続を確認し、get_credits で使用状況を監視します。

ドキュメント

OpenCharts

OpenCharts MCP Server

AIクライアントから直接、OpenChartsでフローチャート、ノート、スライド、シート、ボード、サイト、エージェント、曲、画像、動画を作成できます。

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

License Website MCP


これは何ですか?

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

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

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

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

クイックスタート

  1. API キーを作成します: opencharts.com/theo-agents/mcp にアクセスし、すぐにコピーしてください。完全なキーは一度しか表示されません。
  2. サーバーを追加します: 以下の対応する設定スニペットを使用して AI クライアントに追加し、{{YOUR_API_KEY}} をあなたのキーに置き換えます。
  3. 接続を確認します: アシスタントに 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}}"
      }
    }
  }
}

ツール

サーバーは 11 グループにわたる 59 のツール を公開しています。Theo AI または生成を使用するツールは AI クレジットを消費します。

プロジェクト

ツール説明
list_projectsページネーションとフィルターでプロジェクトを一覧表示
get_projectID でプロジェクトの全データを取得
create_flowchartノードとエッジを持つフローチャートプロジェクトを作成
create_whiteboardネイティブな図形と要素を持つホワイトボードを作成
create_notesMarkdown からノートプロジェクトを作成
create_presentationアウトラインからスライドデッキを作成
update_projectメタデータまたはコンテンツ (ノート、フローチャート、ホワイトボード、プレゼンテーション) を更新
delete_projectプロジェクトを論理削除 (30日間の復旧期間あり)

Code Canvas

ツール説明
generate_code_canvas説明から本格的なウェブサイトまたはアプリ (HTML/React) を構築 — ポーリングするジョブを返します
get_code_canvas_statusCode Canvas ビルドをポーリング。準備ができるとプロジェクト + オープン URL を返します

AI

ツール説明
ask_theo単一ターンの AI メッセージを送信 (高速または思考モード)
extract_flowchartアップロードされたドキュメント (PDF、画像、PPTX) からフローチャートを抽出

Theo Agents

ツール説明
build_agent説明から Theo Agent を構築 — バックグラウンドで実行され、準備ができると通知
get_agent_build_statusbuild_agent ジョブのオプションのポーリング。完了するとエージェント + オープン URL を返します
create_agent構造化されたステップ + トリガーから決定論的に Theo Agent を作成
update_agentエージェントの名前、説明、またはステップリストを修正
configure_agent_triggerエージェントのトリガーを設定 (手動、スケジュール、Webhook、イベント、Telegram)
activate_agentエージェントを有効化 (最初のスケジュール実行をシード)
deactivate_agentトリガーが発火しないようにエージェントを無効化
delete_agentエージェントを論理削除 (30日間の復旧期間あり)
list_agentsTheo Agents をステータス + ステップ数とともに一覧表示
get_agentエージェントの完全な定義 (トリガー + 順序付けられたステップ) を取得
run_agentエージェントを今すぐディスパッチ — バックグラウンドで実行され、完了時に通知
list_agent_runsエージェントの最近の実行履歴を一覧表示
get_agent_run_status単一の実行のステータス + ノードごとの進捗を取得

Theo Sheets

ツール説明
list_sheetsTheo 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_songTheo 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_noteWeb コンテンツ (URL + HTML) をノート内にクリップとして保存

テンプレート

ツール説明
list_templatesテンプレートギャラリーを閲覧
use_templateテンプレートから新しいプロジェクトを作成

アカウント

ツール説明
whoami認証されたユーザーのプロファイル情報を取得
get_creditsAI クレジットの残高を確認

リソース

リソースは、AI クライアントがツールを呼び出さずに取得できる読み取り専用のコンテキストを提供します。

リソース説明
projects最近のプロジェクトのページネーションされたリスト
projectID による単一プロジェクトの全データ
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_theoextract_flowchartgenerate_code_canvasbuild_agentcreate_songgenerate_imagegenerate_video) は、プランの AI クレジットを消費します。

レート制限とクレジット

  • 1ユーザーあたり毎分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. を含む) であることを確認してください。最上位ホストはリダイレクト時に Authorization ヘッダーを削除します。また、キーがアクティブで、Bearer プレフィックス付きで送信されていることを確認してください。
  • 429 Too Many Requests — 毎分120リクエストの制限に達しました。待ってから再試行してください。
  • クライアントにツールが表示されない — クライアントを完全に再起動するか (または OpenCharts サーバーをオフ/オンに切り替える)、ツールリストを再取得してください。キーに readwriteai スコープが含まれていることを確認してください (デフォルトのキーには3つすべてが含まれます)。
  • セッション中に JWT の有効期限が切れた — セッション JWT は約15分で期限切れになります。長時間実行する統合には、永続的な API キーを使用してください。

互換性のあるクライアント

Model Context Protocol をサポートする任意のクライアントで動作します。例:

リンク

ライセンス

このドキュメントは CC-BY-4.0 の下でライセンスされています。OpenCharts MCP サーバーはホスト型製品です。利用規約と価格については opencharts.com をご覧ください。