OpenCharts MCP
公式AIエージェントをOpenChartsに接続—Claude Code、Codex、Cursorからターミナルを離れずにスプレッドシート、ボード、音楽、自動化を構築できます。
OpenCharts MCPで何ができますか?
- フローチャート、ホワイトボード、ノート、プレゼンテーションを作成 —
create_flowchart、create_whiteboard、create_notes、またはcreate_presentationを使用して、構造化されたプロジェクトを直接生成します。 - 説明文から完全なWebサイトやアプリを構築 —
generate_code_canvasを使用してCode Canvasビルドを開始し、その後get_code_canvas_statusをポーリングして結果を取得します。 - Theo Agentsをエンドツーエンドで管理 —
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 Server
AIクライアントから直接、OpenChartsでフローチャート、ノート、スライド、シート、ボード、サイト、エージェント、曲、画像、動画を作成できます。
ウェブサイト · ドキュメント · APIキーを取得 · 問題
これは何ですか?
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 のセットアップページをご利用ください。
クイックスタート
- 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>(アクティブな 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_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 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 | 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、generate_image、generate_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 サーバーをオフ/オンに切り替える)、ツールリストを再取得してください。キーに
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 をご覧ください。