OpenCharts MCP

OpenCharts MCP Server

Doğrudan yapay zeka istemcinizden akış şemaları, notlar, slaytlar, sayfalar, panolar, siteler, aracılar, şarkılar, görseller ve videolar oluşturun OpenCharts.

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), şarkılar (Theo Symphony) ve görseller ile videolar (Theo Media) — hepsi OpenCharts yapay zekası Theo tarafından desteklenir. Bir site veya uygulama oluştururken, asistanınız satır içinde gerçek görüntü ve video klipler oluşturabilir ve yer tutucular bırakmak yerine döndürülen URL'leri doğrudan koda bırakabilir.

Bu, Akışkan 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 çalıştırmazsınız.

Bir dakikadan kısa sürede bağlanmak mı istiyorsunuz? 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ıç

1. opencharts.com/theo-agents/mcp adresinden bir API anahtarı oluşturun. Hemen kopyalayın — tam anahtar yalnızca bir kez gösterilir.
2. Sunucuyu aşağıdaki eşleşen yapılandırma parçacığını kullanarak yapay zeka istemcinize ekleyin, {{YOUR_API_KEY}} yerine anahtarınızı yazın.
3. 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: Akışkan 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ı sıyıran ve kimlik doğrulamayı bozan bir 307 yönlendirmesi yayınlar. 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 "yapay zeka 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, 11 grup altında 59 araç sunar. Theo AI veya oluşturma kullanan araçlar yapay zeka 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 notlar 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 — yoklanacak bir iş döndürür
get_code_canvas_status	Bir Code Canvas derlemesini yoklayın; hazır olduğunda projeyi + açık URL'yi döndürür

Yapay Zeka

Araç	Açıklama
ask_theo	Tek turlu bir yapay zeka 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ı yoklama; 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 ateşlenmesini 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 Agents'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ışmalarını listeleyin
get_agent_run_status	Tek bir çalışmanı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 taahhüt 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 taahhütlerini listeleyin (uygulanmış / önerilmiş / birleştirilmiş)
diff_sheet_commit	Bir taahhüt 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 taahhüde 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 bir 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 — yoklanacak bir iş döndürür
get_song_status	Bir şarkı işini yoklayın; tamamlandığında ses + kapak resmi sürümlerini döndürür

Theo Media

Araç	Açıklama
generate_image	Bir istemden bir görüntü oluşturun — gömmek veya kaydetmek için genel bir URL döndürür (yer tutucular yerine kullanın)
generate_video	Bir istemden kısa bir video klip oluşturun — yoklanacak bir iş döndürür
get_video_status	Bir video işini yoklayın; tamamlandığında bitmiş klip URL'sini 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 yapay zeka kredi bakiyesini kontrol edin

Kaynaklar

Kaynaklar, bir yapay zeka 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ız tarafından 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 oluşturma kullanan araçlar (örneğin ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song, generate_image, generate_video) planınızdan yapay zeka kredisi tüketir.

Hız limitleri ve krediler

• Kullanıcı başına dakikada 120 istek.
• Yapay zeka ve oluşturma araçları yapay zeka 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: opencharts.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ı sıyı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 limitine 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 ~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 dahil:

• 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: opencharts.com
• 📖 MCP dokümanları: opencharts.com/help/mcp-server
• 🔑 API anahtarı alın: opencharts.com/theo-agents/mcp
• 💬 Topluluk: opencharts.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 opencharts.com adresine bakın.