OpenCharts MCP

आधिकारिक

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

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

  • प्रोजेक्ट बनाएँ और प्रबंधित करेंcreate_flowchart, create_whiteboard, create_notes, और create_presentation जैसे टूल का उपयोग करके फ़्लोचार्ट, व्हाइटबोर्ड, नोट्स, प्रेज़ेंटेशन और अधिक बनाएँ।
  • स्प्रेडशीट के साथ काम करेंinspect_sheet, get_sheet, create_sheet, update_sheet, और edit_sheet का उपयोग करके फ़ॉर्मूला सपोर्ट के साथ Theo Sheets का निरीक्षण, पढ़ना, निर्माण और संपादन करें।
  • ऑटोमेशन बनाएँ और चलाएँbuild_agent, create_agent, configure_agent_trigger, और run_agent के साथ Theo Agents बनाएँ, कॉन्फ़िगर करें, सक्रिय करें और चलाएँ।
  • Kanban बोर्ड प्रबंधित करेंcreate_board, add_board_card, update_board_card, और list_board_cards के साथ बोर्ड बनाएँ, कार्ड जोड़ें और अपडेट करें, और सूचियाँ प्रबंधित करें।
  • वेबसाइट और गाने जनरेट करेंgenerate_code_canvas के साथ पूर्ण वेबसाइट या ऐप बनाएँ और create_song के साथ संगीत बनाएँ, फिर get_code_canvas_status और get_song_status के साथ स्थिति की जाँच करें।
  • खाता और क्रेडिट जाँचेंwhoami के साथ अपने कनेक्शन की पुष्टि करें और get_credits के साथ AI क्रेडिट उपयोग की निगरानी करें।

दस्तावेज़

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, OpenCharts AI द्वारा संचालित।

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

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

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

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

  1. opencarts.com/theo-agents/mcp पर एक API कुंजी बनाएँ। इसे तुरंत कॉपी करें — पूरी कुंजी केवल एक बार दिखाई जाती है।
  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}}"
      }
    }
  }
}

उपकरण

सर्वर 10 समूहों में 56 उपकरण उजागर करता है। 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एक गाने की जॉब को पोल करें; पूरा होने पर ऑडियो + कवर-आर्ट संस्करण लौटाता है

नोट्स

उपकरणविवरण
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) आपकी योजना से 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 देखें।