OpenCharts MCP

resmi

AI ajanınızı OpenCharts'a bağlayın—Claude Code, Codex veya Cursor'dan terminalinizden çıkmadan elektronik tablolar, panolar, müzik ve otomasyonlar oluşturun.

GitHub

Open Charts MCP ile neler yapabilirsiniz?

Projeler oluşturun ve yönetin — create_flowchart, create_whiteboard, create_notes ve create_presentation gibi araçları kullanarak akış şemaları, beyaz tahtalar, notlar, sunumlar ve daha fazlasını oluşturun.
E-tablolarla çalışın — Formül desteğiyle Theo Sheets'i inceleyin, okuyun, oluşturun ve düzenleyin: inspect_sheet, get_sheet, create_sheet, update_sheet ve edit_sheet.
Otomasyonlar oluşturun ve çalıştırın — build_agent, create_agent, configure_agent_trigger ve run_agent ile Theo Ajanları oluşturun, yapılandırın, etkinleştirin ve çalıştırın.
Kanban panolarını yönetin — create_board, add_board_card, update_board_card ve list_board_cards ile panolar oluşturun, kartlar ekleyip güncelleyin ve listeleri yönetin.
Web siteleri ve şarkılar oluşturun — generate_code_canvas ile tam web siteleri veya uygulamalar oluşturun, create_song ile müzik yapın, ardından get_code_canvas_status ve get_song_status ile durumu sorgulayın.
Hesap ve kredileri kontrol edin — whoami ile bağlantınızı doğrulayın ve get_credits ile AI kredi kullanımını izleyin.

Dokümantasyon

OpenCharts MCP Server

Yapay zeka istemcinizden doğrudan OpenCharts içinde akış şemaları, notlar, slaytlar, sayfalar, panolar, siteler, aracılar ve şarkılar oluşturun.

Web Sitesi · Dokümantasyon · API anahtarı alın · Sorunlar

Bu nedir?

OpenCharts, tüm OpenCharts ürününü MCP uyumlu herhangi bir yapay zeka istemcisinin içine yerleştiren genel, barındırılan bir Model Bağlam Protokolü (MCP) sunucusu çalıştırır. Bir API anahtarıyla bir kez bağlanın; asistanınız sizin adınıza gerçek OpenCharts projeleri oluşturabilir ve yönetebilir — akış şemaları, beyaz tahtalar, notlar, sunumlar, elektronik tablolar (Theo Sheets), Kanban + takvim panoları, tam web siteleri ve uygulamalar (Code Canvas), otomasyonlar (Theo Agents) ve şarkılar (Theo Symphony) — hepsi OpenCharts yapay zekası Theo tarafından desteklenmektedir.

Streamable HTTP üzerinden uzak bir sunucudur — yerel olarak kurulacak veya çalıştırılacak hiçbir şey yoktur. İstemcinizi uç noktaya yönlendirin, API anahtarınızı yapıştırın ve başlayın.

Bu depo, o sunucunun genel dokümantasyonudur. Sunucunun kendisi OpenCharts tarafından barındırılır; siz kendiniz çalıştırmazsınız.

Bir dakikadan kısa sürede bağlanmak ister misiniz? opencharts.com/help/mcp-server adresindeki uygulama içi kılavuzu veya opencharts.com/theo-agents/mcp adresindeki kurulum sayfasını kullanın.

Hızlı başlangıç

opencharts.com/theo-agents/mcp adresinden bir API anahtarı oluşturun. Hemen kopyalayın — tam anahtar yalnızca bir kez gösterilir.
Sunucuyu, aşağıdaki eşleşen yapılandırma parçacığını kullanarak yapay zeka istemcinize ekleyin ve {{YOUR_API_KEY}} yerine anahtarınızı yazın.
Asistanınızdan whoami aracını çağırmasını isteyerek bağlantıyı doğrulayın — OpenCharts hesabınızı döndürmelidir.

Uç Nokta

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

Aktarım: Streamable HTTP (POST)
Kimlik Doğrulama: Authorization: Bearer <API key> (aktif bir OpenCharts oturumundan alınan bir JWT de çalışır)

⚠️ Her zaman www. ana bilgisayarını kullanın. Apex opencharts.com, Authorization başlığını kaldıran ve kimlik doğrulamayı bozan bir 307 yönlendirmesi yapar. Tam olarak https://www.opencharts.com/api/mcp kullanın.

Yapay zeka istemcinizi bağlayın

Sunucu, MCP uyumlu herhangi bir istemciyle çalışır. Eşleşen parçacığı kopyalayın ve API anahtarınızı girin. Asistanınızın bağlantıyı kurmasını mı tercih edersiniz? Yardım sayfasında aşağıdaki her istemci için tek yapıştırmalı bir "AI kurulum istemi" bulunur.

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 dosyasına ekleyin:

{
  "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 eklentisi settings.json içinde:

"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}}"
      }
    }
  }
}

Araçlar

Sunucu, 10 grup altında 56 araç sunar. Theo AI veya üretim kullanan araçlar AI kredisi tüketir.

Projeler

Araç	Açıklama
`list_projects`	Projelerinizi sayfalandırma ve filtrelerle listeleyin
`get_project`	Kimliğe göre tam proje verilerini alın
`create_flowchart`	Düğümler ve kenarlarla bir akış şeması projesi oluşturun
`create_whiteboard`	Yerel şekiller ve öğelerle bir beyaz tahta oluşturun
`create_notes`	Markdown'dan bir not projesi oluşturun
`create_presentation`	Bir taslaktan slayt destesi oluşturun
`update_project`	Meta verileri veya içeriği güncelleyin (notlar, akış şeması, beyaz tahta veya sunum)
`delete_project`	Bir projeyi geçici olarak silin (30 günlük kurtarma)

Code Canvas

Araç	Açıklama
`generate_code_canvas`	Bir açıklamadan tam bir web sitesi veya uygulama (HTML/React) oluşturun — sorgulanacak bir iş döndürür
`get_code_canvas_status`	Bir Code Canvas derlemesini sorgulayın; hazır olduğunda projeyi + açık URL'yi döndürür

AI

Araç	Açıklama
`ask_theo`	Tek turlu bir AI mesajı gönderin (hızlı veya düşünme modu)
`extract_flowchart`	Yüklenen bir belgeden (PDF, resim, PPTX) bir akış şeması çıkarın

Theo Agents

Araç	Açıklama
`build_agent`	Bir açıklamadan bir Theo Agent oluşturun — arka planda çalışır, hazır olduğunda sizi bilgilendirir
`get_agent_build_status`	Bir `build_agent` işi için isteğe bağlı sorgulama; tamamlandığında aracıyı + açık URL'yi döndürür
`create_agent`	Yapılandırılmış adımlar + tetikleyiciden deterministik olarak bir Theo Agent oluşturun
`update_agent`	Bir aracının adını, açıklamasını veya adım listesini düzeltin
`configure_agent_trigger`	Bir aracının tetikleyicisini ayarlayın (manuel, zamanlama, web kancası, olay, telegram)
`activate_agent`	Bir aracıyı etkinleştirin (ilk zamanlanmış çalıştırmayı başlatır)
`deactivate_agent`	Tetikleyicilerin çalışmasını durdurmak için bir aracıyı devre dışı bırakın
`delete_agent`	Bir aracıyı geçici olarak silin (30 günlük kurtarma)
`list_agents`	Theo Agent'larınızı durum + adım sayılarıyla listeleyin
`get_agent`	Bir aracının tam tanımını alın (tetikleyici + sıralı adımlar)
`run_agent`	Bir aracıyı şimdi gönderin — arka planda çalışır, tamamlandığında sizi bilgilendirir
`list_agent_runs`	Bir aracının son yürütme çalıştırmalarını listeleyin
`get_agent_run_status`	Tek bir çalıştırmanın durumunu + düğüm başına ilerlemeyi alın

Theo Sheets

Araç	Açıklama
`list_sheets`	Theo Sheets elektronik tablo projelerinizi listeleyin
`inspect_sheet`	Bir sayfayı inceleyin — sekme başına boyutlar, başlık satırı, örneklenmiş hücreler + formüller, düzen
`get_sheet`	Bir çalışma sayfasını yapılandırılmış satırlar olarak çıkarın (başlıklar + veri satırları)
`read_sheet_range`	Tam bir A1 aralığının değerlerini (+ isteğe bağlı formüller) bir ızgara + CSV olarak okuyun
`create_sheet`	Başlıklardan ve satırlardan canlı bir elektronik tablo (Excel düzeyinde ızgara + formüller) oluşturun
`update_sheet`	Yapılandırılmış elektronik tablo düzenleme işlemlerini uygulayarak bir sayfayı düzenleyin — geri alınabilir bir commit olarak kaydedilir
`apply_sheet_ops`	Yapılandırılmış elektronik tablo düzenleme işlemlerini uygulayın — veya birleştirme kontrollü bir değişiklik önerin
`edit_sheet`	Doğal dil talimatıyla bir sayfayı düzenleyin (Theo işlemleri planlar + uygular)
`list_sheet_commits`	Bir sayfanın git tarzı değişiklik commit'lerini listeleyin (uygulanmış / önerilmiş / birleştirilmiş)
`diff_sheet_commit`	Bir commit veya öneri için hücre düzeyindeki farkı gösterin
`resolve_sheet_proposal`	Bekleyen bir değişiklik önerisini birleştirin veya reddedin
`rollback_sheet`	Canlı sayfayı önceki bir commit'e geri döndürün (tersine çevrilebilir)

Panolar

Araç	Açıklama
`create_board`	Bir Kanban + takvim proje panosu oluşturun
`list_boards`	Proje panolarınızı listeleyin
`get_board`	Bir panonun listelerini (sütunlar) ve kartlarını alın
`update_board`	Bir panonun adını, açıklamasını veya liste sütunlarını güncelleyin
`delete_board`	Bir panoyu geçici olarak silin (kurtarılabilir)
`duplicate_board`	Bir panoyu listeleri, kuralları ve kartlarıyla çoğaltın
`add_board_card`	Bir panoya kart (gönderi/görev/fikir/etkinlik) ekleyin
`list_board_cards`	Bir panonun kartlarını, isteğe bağlı olarak zamanlama aralığına göre listeleyin
`update_board_card`	Bir kartı düzenleyin — listeyi taşıyın, yeniden zamanlayın, durumu/rengi değiştirin
`delete_board_card`	Bir panodan bir kartı geçici olarak silin

Theo Symphony

Araç	Açıklama
`create_song`	Theo Symphony ile bir şarkı oluşturun — sorgulanacak bir iş döndürür
`get_song_status`	Bir şarkı işini sorgulayın; tamamlandığında ses + kapak resmi sürümlerini döndürür

Notlar

Araç	Açıklama
`get_note_content`	Bir notun içeriğini Markdown olarak çıkarın
`append_to_note`	Mevcut bir nota Markdown içeriği ekleyin
`clip_to_note`	Web içeriğini (URL + HTML) bir notun içine klip olarak kaydedin

Şablonlar

Araç	Açıklama
`list_templates`	Şablon galerisine göz atın
`use_template`	Bir şablondan yeni bir proje oluşturun

Hesap

Araç	Açıklama
`whoami`	Kimliği doğrulanmış kullanıcının profil bilgilerini alın
`get_credits`	Kalan AI kredi bakiyesini kontrol edin

Kaynaklar

Kaynaklar, bir AI istemcisinin bir araç çağırmadan alabileceği salt okunur bağlam sağlar.

Kaynak	Açıklama
`projects`	Son projelerinizin sayfalandırılmış listesi
`project`	Kimliğe göre tek bir proje için tam veri
`templates`	Göz atılabilir şablon kataloğu

Nasıl çalışır

┌────────────────────┐   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     │
└────────────────────┘                      └────────────────────────────┘

Her istek API anahtarınızla doğrulanır ve kendi OpenCharts hesabınız üzerinde işlem yapar. Sunucu barındırıldığı için, araç yüzeyi otomatik olarak güncel kalır — istemci güncellemesi gerekmez. Theo AI veya üretim kullanan araçlar (örneğin ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song) planınızdan AI kredisi tüketir.

Hız limitleri ve krediler

Kullanıcı başına dakikada 120 istek.
AI ve üretim araçları AI kredisi tüketir — bakiyenizi istediğiniz zaman get_credits aracıyla kontrol edin.

Keşif ve kayıt defteri

İstemciler, tarayıcılar ve kayıt defterleri için makine tarafından okunabilir meta veriler yayınlanır (gizli bilgi içermez):

https://www.opencharts.com/.well-known/mcp — keşif manifestosu
https://www.opencharts.com/.well-known/mcp/server-card.json — sunucu kartı
https://www.opencharts.com/.well-known/oauth-protected-resource — korumalı kaynak meta verileri
Dokümanlar: opencarts.com/help/mcp-server

Sorun Giderme

307 yönlendirmesi / "yetkilendirme desteği yok" / 401 — URL'nin tam olarak https://www.opencharts.com/api/mcp (www. ile) olduğundan emin olun. Apex ana bilgisayarı, yönlendirmede Authorization başlığını kaldırır. Ayrıca anahtarınızın aktif olduğunu ve Bearer önekiyle gönderildiğini doğrulayın.
429 Too Many Requests — 120 istek/dk sınırına ulaştınız; bekleyin ve yeniden deneyin.
İstemcinizde araçlar eksik — araç listesini yeniden alması için istemciyi tamamen yeniden başlatın (veya OpenCharts sunucusunu kapatıp açın). Anahtarınızın read, write ve ai kapsamlarını taşıdığını doğrulayın (varsayılan anahtarlar üçünü de içerir).
Oturum ortasında JWT'nin süresi doldu — oturum JWT'lerinin süresi yaklaşık 15 dakika sonra dolar; uzun süreli entegrasyonlar için kalıcı bir API anahtarı kullanın.

Uyumlu istemciler

Model Bağlam Protokolü'nü destekleyen tüm istemcilerle çalışır, bunlar şunları içerir:

Warp — aracılı geliştirme ortamı
Claude Desktop ve Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

Bağlantılar

🌐 Web Sitesi: opencarts.com
📖 MCP dokümanları: opencarts.com/help/mcp-server
🔑 API anahtarı alın: opencarts.com/theo-agents/mcp
💬 Topluluk: opencarts.com/community
🐛 Sorunlar: GitHub Sorunları

Lisans

Bu dokümantasyon CC-BY-4.0 altında lisanslanmıştır. OpenCharts MCP sunucusu barındırılan bir üründür — şartlar ve fiyatlandırma için opencarts.com adresine bakın.