OpenCharts MCP

आधिकारिक

अपने AI एजेंट को OpenCharts से जोड़ें—Claude Code, Codex, या Cursor से टर्मिनल छोड़े बिना स्प्रेडशीट, बोर्ड, संगीत और ऑटोमेशन बनाएं।

OpenCharts MCP के साथ आप क्या कर सकते हैं?

  • फ़्लोचार्ट, व्हाइटबोर्ड, नोट्स और प्रेजेंटेशन बनाएंcreate_flowchart, create_whiteboard, create_notes, या create_presentation के ज़रिए सीधे संरचित प्रोजेक्ट जनरेट करें।
  • विवरण से पूर्ण वेबसाइट या ऐप बनाएं — कोड कैनवास बिल्ड शुरू करने के लिए generate_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 का उपयोग करके शीट बनाएं, निरीक्षण करें, रेंज पढ़ें, संरचित संपादन लागू करें और बदलाव वापस लें।
  • इनलाइन इमेज और वीडियो जनरेट करें — तत्काल सार्वजनिक URL के लिए generate_image या generate_video को कॉल करें और तैयार क्लिप के लिए get_video_status को पोल करें।
  • अपने खाते और AI क्रेडिट बैलेंस की जांच करेंwhoami से अपना कनेक्शन सत्यापित करें और get_credits के ज़रिए उपयोग की निगरानी करें।

दस्तावेज़

OpenCharts

OpenCharts MCP सर्वर

अपने AI क्लाइंट से सीधे OpenCharts में फ़्लोचार्ट, नोट्स, स्लाइड, शीट, बोर्ड, साइट, एजेंट, गाने, इमेज और वीडियो बनाएँ।

वेबसाइट · दस्तावेज़ीकरण · API कुंजी प्राप्त करें · समस्याएँ

License Website MCP


यह क्या है?

OpenCharts एक सार्वजनिक, होस्टेड मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर चलाता है जो पूरे OpenCharts उत्पाद को किसी भी MCP-संगत AI क्लाइंट के अंदर रखता है। एक बार API कुंजी से कनेक्ट करें और आपका सहायक आपकी ओर से वास्तविक OpenCharts प्रोजेक्ट बना और प्रबंधित कर सकता है — फ़्लोचार्ट, व्हाइटबोर्ड, नोट्स, प्रस्तुतियाँ, स्प्रेडशीट (Theo Sheets), कानबन + कैलेंडर बोर्ड, पूर्ण वेबसाइट और ऐप (Code Canvas), ऑटोमेशन (Theo Agents), गाने (Theo Symphony), और इमेज और वीडियो (Theo Media) — सभी OpenCharts AI, Theo द्वारा संचालित। साइट या ऐप बनाते समय, आपका सहायक वास्तविक इमेजरी और वीडियो क्लिप इनलाइन उत्पन्न कर सकता है और प्लेसहोल्डर छोड़ने के बजाय लौटाए गए URL को सीधे कोड में डाल सकता है।

यह स्ट्रीमेबल HTTP पर एक रिमोट सर्वर है — स्थानीय रूप से इंस्टॉल या चलाने के लिए कुछ भी नहीं है। अपने क्लाइंट को एंडपॉइंट पर इंगित करें, अपनी API कुंजी पेस्ट करें, और जाएँ।

यह रिपॉजिटरी उस सर्वर के लिए सार्वजनिक दस्तावेज़ीकरण है। सर्वर स्वयं OpenCharts द्वारा होस्ट किया गया है; आप इसे स्वयं नहीं चलाते हैं।

एक मिनट से कम में कनेक्ट करना चाहते हैं? opencarts.com/help/mcp-server पर इन-ऐप गाइड या opencarts.com/theo-agents/mcp पर सेटअप पेज का उपयोग करें।

त्वरित शुरुआत

  1. एक API कुंजी बनाएँ opencarts.com/theo-agents/mcp पर। इसे तुरंत कॉपी करें — पूरी कुंजी केवल एक बार दिखाई जाती है।
  2. सर्वर जोड़ें अपने AI क्लाइंट में नीचे दिए गए मिलान कॉन्फ़िग स्निपेट का उपयोग करके, {{YOUR_API_KEY}} को अपनी कुंजी से बदलें।
  3. सत्यापित करें अपने सहायक से whoami टूल को कॉल करने के लिए कहकर कनेक्शन — इसे आपका OpenCharts खाता लौटाना चाहिए।

एंडपॉइंट

https://www.opencharts.com/api/mcp
  • ट्रांसपोर्ट: स्ट्रीमेबल 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 एजेंट बनाएँ — पृष्ठभूमि में चलता है, तैयार होने पर आपको सूचित करता है
get_agent_build_statusbuild_agent जॉब के लिए वैकल्पिक पोल; पूरा होने पर एजेंट + खुला URL लौटाता है
create_agentसंरचित चरणों + ट्रिगर से नियतात्मक रूप से एक Theo एजेंट बनाएँ
update_agentकिसी एजेंट का नाम, विवरण, या चरण सूची पैच करें
configure_agent_triggerकिसी एजेंट का ट्रिगर सेट करें (मैनुअल, शेड्यूल, वेबहुक, ईवेंट, टेलीग्राम)
activate_agentकिसी एजेंट को सक्रिय करें (पहले शेड्यूल किए गए रन को सीड करता है)
deactivate_agentकिसी एजेंट को निष्क्रिय करें ताकि ट्रिगर फायर करना बंद कर दें
delete_agentकिसी एजेंट को सॉफ्ट-डिलीट करें (30-दिन की रिकवरी)
list_agentsस्थिति + चरण गणना के साथ अपने Theo एजेंट सूचीबद्ध करें
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हेडर और पंक्तियों से एक लाइव स्प्रेडशीट (एक्सेल-ग्रेड ग्रिड + सूत्र) बनाएँ
update_sheetसंरचित स्प्रेडशीट संपादन ऑप्स लागू करके एक शीट संपादित करें — रोलबैक-सक्षम कमिट के रूप में सहेजा गया
apply_sheet_opsसंरचित स्प्रेडशीट संपादन ऑप्स लागू करें — या मर्ज-गेटेड परिवर्तन प्रस्तावित करें
edit_sheetप्राकृतिक-भाषा निर्देश के साथ एक शीट संपादित करें (Theo योजना बनाता है + ऑप्स लागू करता है)
list_sheet_commitsशीट के गिट-शैली परिवर्तन कमिट सूचीबद्ध करें (लागू / प्रस्तावित / मर्ज किए गए)
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_noteवेब सामग्री (URL + HTML) को नोट के अंदर क्लिप के रूप में सहेजें

टेम्पलेट

उपकरणविवरण
list_templatesटेम्पलेट गैलरी ब्राउज़ करें
use_templateटेम्पलेट से एक नया प्रोजेक्ट बनाएँ

खाता

उपकरणविवरण
whoamiप्रमाणित उपयोगकर्ता की प्रोफ़ाइल जानकारी प्राप्त करें
get_creditsशेष AI क्रेडिट शेष राशि की जाँच करें

संसाधन

संसाधन केवल-पढ़ने के लिए संदर्भ प्रदान करते हैं जिसे 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_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 — संरक्षित-संसाधन मेटाडेटा
  • दस्तावेज़: opencarts.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 कुंजी का उपयोग करें।

संगत क्लाइंट

किसी भी क्लाइंट के साथ काम करता है जो मॉडल कॉन्टेक्स्ट प्रोटोकॉल का समर्थन करता है, जिसमें शामिल हैं:

लिंक

लाइसेंस

यह दस्तावेज़ीकरण CC-BY-4.0 के तहत लाइसेंस प्राप्त है। OpenCharts MCP सर्वर एक होस्टेड उत्पाद है — शर्तों और मूल्य निर्धारण के लिए opencarts.com देखें।