Taskade

Bu depoda Taskade agent eklentisi ve iki paket bulunur:

• MCP Sunucusu (@taskade/mcp-server): Uzak sunucuya bağlanamayan istemciler için yerel stdio sunucusu.
• OpenAPI Codegen: Yalnızca Taskade için değil, tüm OpenAPI spesifikasyonlarından MCP araçları oluşturur.

Claude Code, Codex, Copilot, Gemini CLI ve Cursor için agent eklentisi

taskade eklentisi, AI aracınızı barındırılan sunucu üzerinden Taskade çalışma alanınıza bağlar ve 7 beceri ekler: bir başlangıç noktası (taskade) ve altı görev (getting-started, import-spreadsheet, fix-my-app, app-report, backup-my-app, plan-new-app). Bu beceriler, agent’a hangi araçları hangi sırayla çağıracağını ve yanıt vermeden önce neleri kontrol edeceğini söyler.

• Plan: MCP erişimi, ücretli tüm Taskade planlarına dahildir (Starter ve üzeri). Taskade hesabınızla bir kez oturum açın.
• Yaptıkları: Bir elektronik tabloyu projeye aktarır, Taskade Genesis uygulamasını her değişikliği tek tek kontrol ederek düzeltir, projeleriniz ve otomasyonlarınız hakkında rapor verir, bir uygulamayı klasöre yedekler ve yeni bir uygulama planlar.
• Taskade’de kalanlar: Eklenti otomasyon oluşturamaz veya düzenleyemez, uygulama oluşturamaz ya da yayımlayamaz ve bir uygulamayı kimlerin kullanabileceğini belirleyemez. Bu işler için isteği Taskade EVE’ye yapıştırmanız üzere hazırlar.

VS Code: chat.plugins.enabled ayarını etkinleştirin. Ardından Komut Paleti’nden Chat: Install Plugin From Source komutunu çalıştırın ve https://github.com/taskade/mcp girin.

Cursor: Bu depodaki Cursor eklentisi taskade (.cursor-plugin/), aynı barındırılan sunucuyu ve becerileri ekler.

Yalnızca barındırılan sunucuyu Codex’e eklemek için codex mcp add taskade --url https://www.taskade.com/mcp komutunu çalıştırın, ardından codex mcp login taskade komutunu çalıştırın.

İçindekiler

• Agent eklentisi
• Taskade MCP sunucusu: hızlı başlangıç (Claude, Claude Code, ChatGPT, Cursor, VS Code, Windsurf)
• Barındırılan araçlar
• Örnek istemler
• Sorun giderme
• Yerel paket (stdio)
• Yerel paket araçları (62)
• Neden Taskade MCP?
• Agent Tarifleri
• OpenAPI Codegen
• Taskade nedir?
• Gizlilik ve Güvenlik
• Destek
• Katkıda Bulunma
• Lisans

Demo

Anthropic’in Claude Desktop uygulamasında çalışan, MCP destekli Taskade agent’ı:

MCP ile Agent Oluşturma	Otomasyonları Çalıştırma	Projeleri Yönetme
Claude/Cursor’dan AI agent’ları oluşturun, eğitin ve dağıtın	Otomasyonları listeleyin, birini çalıştırın ve çalıştırma kayıtlarını okuyun	AI asistanınızdan tüm çalışma alanını yönetin (ücretli planlar)

Taskade MCP sunucusu: hızlı başlangıç

Belirteç içermeyen bir initialize isteği, kasıtlı olarak 401 döndürür. 401, istemcinize OAuth oturum açma işlemini nereden başlatacağını bildirir.

Claude (web, Desktop ve mobil)

1. Claude’da Customize > Connectors bölümüne gidin ve Add custom connector öğesini seçin. Team veya Enterprise planında, bir Owner önce Organization settings > Connectors bölümünden bağlayıcıyı eklemelidir (Add, ardından Custom).
2. Ad olarak Taskade, URL olarak https://www.taskade.com/mcp girin ve Add öğesini seçin.
3. Connect öğesini seçin, Taskade’de oturum açın ve erişimi onaylayın.
4. Bir sohbette + > Connectors öğesini seçin ve Taskade’i etkinleştirin.

İletişim kutusu bir OAuth client sorarsa Register automatically öğesini seçin. Bağlayıcı, aynı hesaptaki Claude Desktop ve Claude mobil uygulamalarında da çalışır.

Claude Code

claude mcp add --transport http taskade https://www.taskade.com/mcp

Ardından Claude Code’da /mcp komutunu çalıştırın ve oturum açmak için taskade öğesini seçin.

ChatGPT

ChatGPT, geliştirici modunda özel bir bağlayıcı olarak uzak MCP sunucusuna bağlanır. Yalnızca OAuth kullanır.

1. ChatGPT ayarlarında uygulamalar ve bağlayıcılar için geliştirici modunu etkinleştirin.
2. Bir bağlayıcı oluşturun. Ad olarak Taskade, sunucu URL’si olarak https://www.taskade.com/mcp girin.
3. Kimlik doğrulama yöntemi olarak OAuth’u seçin. Taskade’de oturum açın ve erişime izin verin.

Geliştirici modu yalnızca bazı ChatGPT planlarında kullanılabilir ve arayüzdeki adlar sık sık değişir.

Cursor

Bu sayfanın üst kısmındaki Add to Cursor öğesini seçin veya bunu ~/.cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "taskade": {
      "url": "https://www.taskade.com/mcp"
    }
  }
}

VS Code

Bu sayfanın üst kısmındaki Install in VS Code öğesini seçin veya şu komutu çalıştırın:

code --add-mcp '{"name":"taskade","type":"http","url":"https://www.taskade.com/mcp"}'

Windsurf

Bunu ~/.codeium/windsurf/mcp_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "taskade": {
      "serverUrl": "https://www.taskade.com/mcp"
    }
  }
}

Diğer istemciler ve sunucular (API token)

OAuth kullanamayan bir istemci, Taskade kişisel erişim token’ını Bearer token olarak gönderebilir. Token’ı Taskade Settings > API bölümünde oluşturun.

{
  "mcpServers": {
    "taskade": {
      "type": "http",
      "url": "https://www.taskade.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TASKADE_API_TOKEN" }
    }
  }
}

Tam kılavuz: Barındırılan Taskade MCP.

Barındırılan araçlar

Barındırılan her araç MCP araç açıklamalarını tanımlar. Claude, salt okunur bir aracı onay istemeden çalıştırabilir; verileri silen veya değiştiren bir araçtan önce ise onay ister.

• get_flow_runs: Tek bir otomasyonun en yeniden eskiye doğru son çalıştırmalarını okur. Her çalıştırmanın durumu ve zaman bilgileri bulunur. Başarısız bir çalıştırmada, başarısız olan adım ve kısa bir hata açıklaması da yer alır. Otomasyonları düzenleme izni gerekir.
• run_flow: Açık olan ve "When asked" tetikleyicisini kullanan bir otomasyonun çalıştırmasını başlatır. Her çalıştırma gerçektir: planın aylık otomasyon çalıştırma sayısına dahil edilir ve AI adımları kredi kullanır.

Sunucu ayrıca model için kısa bir kılavuz olan taskade://getting-started kaynağını da sunar.

Örnek istemler

1. Haftalık değerlendirme. "Taskade çalışma alanlarımı listele, Q4 Roadmap projesini oku ve açık görevleri atanan kişiye göre grupla." Araçlar: list_spaces, list_projects, read_project.
2. Bir lansman planla. "Marketing çalışma alanımda Website Launch adlı bir proje oluştur; metin, tasarım, QA ve lansman günü için görevler ekle ve lansman görevini 3 Kasım’a ayarla." Araçlar: list_spaces, create_project, create_task, set_task_date.
3. Bir destek agent’ı oluştur. "Support çalışma alanımda Help Bot adlı bir agent oluştur, FAQ projesini bilgi kaynağı olarak ekle ve ardından müşterinin parolasını nasıl sıfırlayacağını sor." Araçlar: create_agent, add_knowledge_project, prompt_agent.
4. Bir sprinti tamamla. "Sprint 42 projesinde 'shipped' ifadesini içeren tüm görevleri tamamlandı olarak işaretle, ardından projeyi tamamlandı olarak işaretle." Araçlar: list_tasks, complete_task, complete_project.
5. Bir Genesis uygulamasını düzenle. "CRM uygulamamda app/src/App.tsx öğesini oku ve sayfa başlığını Acme CRM olarak değiştir." Araçlar: inspect_space, write_file.

Sorun giderme

Sorun devam ederse bir issue açın veya support@taskade.com adresine e-posta gönderin.

Yerel paket (stdio)

İstemciniz yalnızca stdio sunucularını destekliyorsa veya yalnızca yerel pakette bulunan bir araca (örneğin webhook araçlarına: subscribeWebhook, unsubscribeWebhook) ihtiyacınız varsa yerel paketi kullanın. Paket, npx ile makinenizde çalışır ve kişisel erişim token’ı kullanarak ağ üzerinden Taskade genel API’sini çağırır.

1. API anahtarınızı alın

Taskade Settings > API bölümüne gidin ve bir Personal Access Token oluşturun.

2. Claude Desktop

claude_desktop_config.json dosyanıza ekleyin:

{
  "mcpServers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Cursor

Cursor MCP ayarlarınıza ekleyin:

{
  "mcpServers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. Windsurf

~/.codeium/windsurf/mcp_config.json dosyasına ekleyin (veya Settings → Cascade → MCP → Add Server yolunu izleyin):

{
  "mcpServers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

5. Cline

VS Code’da Cline MCP Servers panelini açın → Configure MCP Servers öğesini seçin ve şunu ekleyin:

{
  "mcpServers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

6. VS Code

Çalışma alanınıza bir .vscode/mcp.json ekleyin (VS Code, servers anahtarını kullanır; ${input:…} ilk çalıştırmada anahtarınızı ister):

{
  "servers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "${input:taskade_api_key}"
      }
    }
  }
}

7. Uzak ve HTTP istemcileri

Yerel paket yalnızca stdio üzerinden çalışır. HTTP veya SSE modu yoktur. HTTP üzerinden bağlanan bir istemci için https://www.taskade.com/mcp adresindeki barındırılan sunucuyu kullanın (Taskade MCP sunucusu: hızlı başlangıç bölümüne bakın).

Yerel paket araçları (62)

Yerel paketin kendi araç adları vardır. Bunlar Taskade public API v1 ve v2 ile eşleşir.

Çalışma Alanları

Projeler

Görevler

AI Ajanları

Özel bilgi ve araçlarla otonom AI ajanları oluşturun, yönetin ve yayımlayın.

Şablonlar

Medya

Kişisel

Ajan Sohbeti ve Webhook'lar (API v2, beta)

v1 API'de bulunmayan özellikler: bir AI ajanıyla canlı konuşma yürütme ve gerçek zamanlı etkinlikleri alma.

Neden Taskade MCP?

Taskade MCP, AI asistanınıza çalışma alanınıza erişim sağlar — projeler, görevler, ajanlar, bilgi tabanları, şablonlar ve otomasyonlar (ücretli planlarda; çalışma alanı listeleme gibi bazı uç noktalar ücretsiz hesaplarda kısıtlıdır). API kodu yazmak yerine, ihtiyacınızı doğal dille açıklayın.

┌──────────────────────────────────────────────────────────┐
│                HOW TASKADE MCP WORKS                     │
└──────────────────────────────────────────────────────────┘

  You (in Claude/Cursor/Windsurf):
  "Create a support agent trained on our docs project"
                         ↓
  ┌──────────────────────────────────┐
  │     Taskade MCP Server           │
  │     (62 tools, 8 categories)     │
  └──────────────────────────────────┘
       ↓              ↓            ↓
  folderCreateAgent  agentKnowledge  agentPublicAccess
  (creates agent)    (attaches docs)  (publishes it)
                         ↓
  Result: Live AI chatbot trained on your data

REST API Yerine Neden MCP?

Diğer MCP Sunucuları Yerine Neden Taskade MCP?

Taskade MCP; AI ajanı yönetimi (ajan oluşturma, eğitme, dağıtma), bilgi tabanı eğitimi (belgeleri, projeleri, medyayı ekleme) ve OpenAPI kod üretimi (herhangi bir API spesifikasyonundan MCP araçları oluşturma) özelliklerini içerir. 8 kategoride 62 araç.

Ajan Tarifleri

You: "Check my Taskade workspace for yesterday's completed tasks,
      summarize them as a standup update, then create today's
      priority tasks based on what's still open."

Claude uses:
  1. meProjectsGet → find your active projects
  2. projectTasksGet → pull tasks from each project
  3. taskCreate → create today's priority tasks

Result: A formatted standup summary + fresh task list in Taskade.

You: "Create an AI support agent called 'Help Bot' in my
      Customer Success folder, train it on our Documentation
      project, and publish it publicly."

Claude uses:
  1. workspaceFoldersGet → find "Customer Success" folder
  2. folderCreateAgent → create "Help Bot" with support instructions
  3. agentKnowledgeProjectCreate → attach Documentation project
  4. agentPublicAccessEnable → publish with shareable link

Result: Live AI chatbot trained on your docs, ready to embed.

You: "Create a new sprint project from our 'Sprint Template',
      name it 'Sprint 2026-W15', move the top 10 backlog
      items into it, and assign them to the engineering team."

Claude uses:
  1. folderProjectTemplatesGet → find "Sprint Template"
  2. projectFromTemplate → create "Sprint 2026-W15"
  3. projectTasksGet → get backlog items
  4. taskMove → move top 10 tasks to new sprint
  5. taskPutAssignees → assign engineering team members

Result: Sprint ready to go, fully populated and assigned.

You: "Generate an AI agent that researches our top 5 competitors.
      Train it on our Competitive Analysis project.
      Name it 'Market Intel Agent'."

Claude uses:
  1. folderAgentGenerate → generate agent from research prompt
  2. agentKnowledgeProjectCreate → connect Competitive Analysis project
  3. agentUpdate → refine instructions for research cadence

Result: AI research agent with domain knowledge, ready for briefings.

You: "For our new client Acme Corp: create a project from
      the 'Client Onboarding' template, add tasks for
      kickoff meeting and SOW review, set due dates for
      the next 2 weeks, then share the project link."

Claude uses:
  1. projectFromTemplate → create "Acme Corp Onboarding"
  2. taskCreate → add kickoff, requirements, SOW tasks
  3. taskPutDate → set dates across next 2 weeks
  4. projectShareLinkEnable → generate share link

Result: Client onboarding project live and shareable in 30 seconds.

Kullanım Alanları

AI ile Proje Yönetimi

AI asistanınızdan Taskade çalışma alanınızı yönetmesini isteyin:

• "Tüm projelerimi ve durumlarını göster"
• "Her ekip için görevler içeren Q1 Planning adlı yeni bir proje oluştur"
• "Süresi geçmiş tüm görevleri Backlog projesine taşı"
• "Sprint projesindeki tüm görevler için son tarihleri ayarla"

AI Ajanı Oluşturma

Doğrudan düzenleyicinizden AI ajanları oluşturup kullanıma alın:

• "Belgeler projemizdeki bilgilerle Customer Support Bot adlı bir AI ajanı oluştur"
• "Şu istemi kullanarak kod incelemesi için bir ajan oluştur: ..."
• "Ajanımı herkese açık yayımla ve paylaşım bağlantısını ver"
• "API belgeleri projemizi ajana bilgi olarak ekle"

Şablon İş Akışları

Şablonlardan proje oluşturmayı otomatikleştirin:

• "Çalışma alanımdaki tüm şablonları listele"
• "Client Template şablonundan 5 yeni müşteri katılım projesi oluştur"
• "Bu hafta için Sprint Retrospective projesini kopyala"

OpenAPI Kod Üretimi

Yalnızca Taskade için değil, herhangi bir OpenAPI spesifikasyonundan MCP araçları oluşturmak için oluşturucumuzu kullanın.

npm install --save-dev @taskade/mcp-openapi-codegen @readme/openapi-parser

import { dereference } from '@readme/openapi-parser';
import { codegen } from '@taskade/mcp-openapi-codegen';

const document = await dereference('your-api-spec.yaml');

await codegen({
  path: 'src/tools.generated.ts',
  document,
});

Herhangi bir OpenAPI 3.0+ spesifikasyonuyla çalışır. Kendi API'leriniz için dakikalar içinde MCP araçları oluşturun.

Taskade Nedir?

Taskade (Y Combinator S19), tek bir istemden uygulamalar oluşturmak, ajanları kullanıma almak ve iş akışlarını otomatikleştirmek için tasarlanmış AI yerel çalışma alanıdır. 150.000'den fazla uygulama oluşturuldu.

• Genesis Apps — İstemlerden eksiksiz uygulamalar oluşturun. Panolar, CRM'ler, portallar, formlar — anında kullanıma alınır. Deneyin →
• AI Agents — Yerleşik araçlara, kalıcı belleğe, çok ajanlı ekiplere ve herkese açık yerleştirme özelliğine sahip özel ajanlar
• Automations — 100'den fazla entegrasyon, dallanma, döngü ve filtreleme içeren kodsuz iş akışı otomasyonu
• Gerçek Zamanlı İş Birliği — Sohbet, video ve birden fazla proje görünümü içeren çok kullanıcılı çalışma alanı
• Şablonlar: proje yönetimi, mühendislik, pazarlama ve daha fazlası için şablonlar
• API ve MCP: REST API v2, bu MCP sunucusu, ajan eklentisi, Agent API, webhook'lar, OAuth 2.0

Bağlantılar:

• Uygulama: taskade.com
• Oluştur: taskade.com/create
• Uygulama galerisi: taskade.com/apps · tüm kategoriler
• Ajanlar: taskade.com/agents
• Şablonlar: taskade.com/templates
• Belgeler: taskade.com/docs · docs.taskade.com
• Çalışma Alanı MCP kılavuzu: https://github.com/taskade/docs/blob/main/apis-living-system-development/workspace-mcp.md
• Barındırılan MCP kılavuzu: https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md
• Blog: taskade.com/blog

Yol Haritası

Planlanan özellikler ve iyileştirmeler için açık sorunlara bakın.

Yakın zamanda yayımlandı (v0.1.0): Ajan sohbeti (promptAgent) ve webhook tetikleyicileri, artık Taskade API v2 araç katmanı üzerinden kullanılabilir.

• Otomasyon araçları: barındırılan sunucu otomasyonları listeler, çalıştırmalarını okur ve "When asked" otomasyonunu çalıştırır (list_automations, get_flow_runs, run_flow). MCP üzerinden otomasyon oluşturma, etkinleştirme ve yönetme yol haritasında.
• agent.js — Açık kaynaklı otonom ajan araç takımı (yakında)
• TaskOS — docs.taskade.com adresindeki ajan platformu

Gizlilik ve Güvenlik

• Barındırılan sunucu. Taskade sunucuyu www.taskade.com üzerinde çalıştırır. Yalnızca Taskade hesabınızın erişebildiği ve ücretli planda bulunan çalışma alanlarını okur ve yazar. Sunucu, AI istemcisiyle olan sohbet geçmişinizi okumaz. prompt_agent, örneğin web araması gibi kendi araçlarını kullanabilen bir Taskade ajanını çalıştırır.
• Ajan eklentisi. Eklenti, becerileri (metin dosyaları) ve barındırılan sunucunun adresini içerir. Kendi kodunu çalıştırmaz. Yedekleme becerisi, çalışma alanı dosyalarını yerel bir klasöre yazar (./taskade-backup/; başka bir klasör belirtmediğiniz sürece).
• Yerel paket. API token'ınız, sunucunun sizin adınıza Taskade public API'yi (https://www.taskade.com/api/v1 ve https://www.taskade.com/api/v2) çağırmasına izin verir. Paket verilerinizi başka hiçbir hizmete göndermez. Token'ı bir ortam değişkeninde saklayın ve asla depoya göndermeyin.
• Gizlilik politikası: taskade.com/privacy. Koşullar: taskade.com/terms.
• Güvenlik ve güvenlik açığı bildirimleri: SECURITY.md dosyasına bakın.

Destek

• Yardım merkezi: help.taskade.com
• E-posta: support@taskade.com
• Hatalar ve özellik istekleri: GitHub sorunları

Katkıda Bulunma

MCP araçlarını, OpenAPI iş akışlarını ve ajan özelliklerini geliştirmemize yardımcı olun.

• Sorunlar — Hataları bildirin veya özellik isteyin
• Pull Request'ler — Katkılarınızı bekliyoruz
• Uygulamalar — Topluluk uygulamalarına göz atın ve kopyalayın · kategoriler

Taskade'den Daha Fazlası

• Ajan becerisi (SKILL.md) · llms.txt dizini · Geliştirici belgeleri
• Awesome Vibe Coding — özenle seçilmiş vibe coding araçları, MCP sunucuları ve ajan becerileri
• Taskade Belgeleri (kaynak) — geliştirici belgeleri ve API referansı
• Integration Kit — açık kaynaklı Zapier/n8n eylemleri ve tetikleyicileri
• GitHub'da Taskade — kuruluş ana sayfası ve açık kaynak depoları
• Taskade — Genesis ve AI uygulama oluşturucu dahil platform ana sayfası

Lisans

MIT