Taskade

Este repositório contém o plugin de agente do Taskade e dois pacotes:

• Servidor MCP (@taskade/mcp-server): o servidor stdio local, para clientes que não conseguem se conectar a um servidor remoto.
• Geração de código OpenAPI: gere ferramentas MCP a partir de qualquer especificação OpenAPI, não apenas do Taskade.

Plugin de agente para Claude Code, Codex, Copilot, Gemini CLI e Cursor

O plugin taskade conecta sua ferramenta de IA ao seu espaço de trabalho do Taskade por meio do servidor hospedado e adiciona 7 habilidades: uma porta de entrada (taskade) e seis tarefas (getting-started, import-spreadsheet, fix-my-app, app-report, backup-my-app, plan-new-app). As habilidades orientam o agente sobre quais ferramentas chamar, em que ordem e o que verificar antes de responder.

• Plano: o acesso MCP faz parte de todos os planos pagos do Taskade (Starter e superiores). Entre uma vez com sua conta do Taskade.
• O que faz: importa uma planilha para um projeto, corrige um aplicativo do Taskade Genesis com uma alteração verificada por vez, gera relatórios sobre seus projetos e automações, faz backup de um aplicativo em uma pasta e planeja um novo aplicativo.
• O que permanece no Taskade: o plugin não pode criar nem editar uma automação, criar ou publicar um aplicativo, nem definir quem pode usar um aplicativo. Para essas tarefas, ele prepara a solicitação para você colar no Taskade EVE.

VS Code: ative a configuração chat.plugins.enabled. Em seguida, execute Chat: Install Plugin From Source na Paleta de Comandos e informe https://github.com/taskade/mcp.

Cursor: o plugin do Cursor taskade (.cursor-plugin/) neste repositório adiciona o mesmo servidor hospedado e as mesmas habilidades.

Para adicionar apenas o servidor hospedado ao Codex, execute codex mcp add taskade --url https://www.taskade.com/mcp e, em seguida, codex mcp login taskade.

Conteúdo

• Plugin de agente
• Servidor MCP do Taskade: guia de início rápido (Claude, Claude Code, ChatGPT, Cursor, VS Code, Windsurf)
• Ferramentas hospedadas
• Exemplos de prompts
• Solução de problemas
• Pacote local (stdio)
• Ferramentas do pacote local (62)
• Por que usar o MCP do Taskade?
• Receitas de agentes
• Geração de código OpenAPI
• O que é o Taskade?
• Privacidade e segurança
• Suporte
• Contribuições
• Licença

Demonstração

Agente do Taskade com tecnologia MCP em execução no Claude Desktop, da Anthropic:

Criar agentes via MCP	Executar automações	Gerenciar projetos
Crie, treine e implante agentes de IA pelo Claude/Cursor	Liste automações, execute uma e leia as execuções	Gerenciamento completo do espaço de trabalho pelo seu assistente de IA (planos pagos)

Servidor MCP do Taskade: guia de início rápido

Uma solicitação initialize sem token retorna 401 intencionalmente. O 401 informa ao cliente por onde iniciar o login OAuth.

Claude (web, Desktop e dispositivos móveis)

1. No Claude, acesse Customize > Connectors e selecione Add custom connector. Em um plano Team ou Enterprise, um Owner deve primeiro adicionar o conector em Organization settings > Connectors (Add e, em seguida, Custom).
2. Informe o nome Taskade e a URL https://www.taskade.com/mcp, depois selecione Add.
3. Selecione Connect, entre no Taskade e aprove o acesso.
4. Em um chat, selecione + > Connectors e ative o Taskade.

Se a janela solicitar um OAuth client, selecione Register automatically. O conector também funciona no Claude Desktop e nos aplicativos móveis do Claude na mesma conta.

Claude Code

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

Em seguida, execute /mcp no Claude Code e selecione taskade para entrar.

ChatGPT

O ChatGPT se conecta a um servidor MCP remoto como um conector personalizado no modo de desenvolvedor. Ele usa apenas OAuth.

1. Nas configurações do ChatGPT, ative o modo de desenvolvedor para aplicativos e conectores.
2. Crie um conector. Informe Taskade como nome e https://www.taskade.com/mcp como URL do servidor.
3. Selecione OAuth como método de autenticação. Entre no Taskade e permita o acesso.

O modo de desenvolvedor está disponível apenas em alguns planos do ChatGPT, e os nomes das opções mudam com frequência.

Cursor

Selecione Add to Cursor no topo desta página ou adicione isto a ~/.cursor/mcp.json:

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

VS Code

Selecione Install in VS Code no topo desta página ou execute:

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

Windsurf

Adicione isto a ~/.codeium/windsurf/mcp_config.json:

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

Outros clientes e servidores (token de API)

Um cliente que não oferece suporte a OAuth pode enviar um token de acesso pessoal do Taskade como token Bearer. Crie o token em Taskade Settings > API.

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

Guia completo: MCP hospedado do Taskade.

Ferramentas hospedadas

Cada ferramenta hospedada declara anotações de ferramenta MCP. O Claude pode executar uma ferramenta somente de leitura sem pedir confirmação e solicita confirmação antes de uma ferramenta que exclui ou substitui dados.

• get_flow_runs: lê as execuções recentes de uma automação, da mais nova para a mais antiga. Cada execução inclui seu status e horários. Uma execução com falha também informa a etapa que falhou e um breve erro. Requer permissão de edição nas automações.
• run_flow: inicia uma execução de uma automação que esteja ativada e configurada para iniciar "When asked". Cada execução é real: conta para o limite mensal de execuções de automação do plano, e as etapas de IA usam créditos.

O servidor também disponibiliza o recurso taskade://getting-started, um breve guia para o modelo.

Exemplos de prompts

1. Revisão semanal. "Liste meus espaços de trabalho do Taskade, leia o projeto Q4 Roadmap e me mostre as tarefas abertas agrupadas por responsável." Ferramentas: list_spaces, list_projects, read_project.
2. Planejar um lançamento. "Crie um projeto chamado Website Launch no meu espaço de trabalho Marketing, com tarefas para texto, design, QA e dia do lançamento, e defina a data da tarefa de lançamento como 3 de novembro." Ferramentas: list_spaces, create_project, create_task, set_task_date.
3. Criar um agente de suporte. "Crie um agente chamado Help Bot no meu espaço de trabalho Support, adicione o projeto FAQ como conhecimento e depois pergunte como um cliente redefine uma senha." Ferramentas: create_agent, add_knowledge_project, prompt_agent.
4. Encerrar um sprint. "No projeto Sprint 42, marque como concluídas todas as tarefas que mencionam 'shipped' e, em seguida, marque o projeto como concluído." Ferramentas: list_tasks, complete_task, complete_project.
5. Editar um aplicativo Genesis. "No meu aplicativo CRM, leia app/src/App.tsx e altere o título da página para Acme CRM." Ferramentas: inspect_space, write_file.

Solução de problemas

Se o problema persistir, abra uma issue ou envie um e-mail para support@taskade.com.

Pacote local (stdio)

Use o pacote local quando seu cliente oferecer suporte apenas a servidores stdio ou quando precisar de uma ferramenta disponível somente no pacote local, como as ferramentas de webhook (subscribeWebhook, unsubscribeWebhook). Ele é executado na sua máquina com npx e chama a API pública do Taskade pela rede usando um token de acesso pessoal.

1. Obtenha sua chave de API

Acesse Taskade Settings > API e crie um Personal Access Token.

2. Claude Desktop

Adicione ao seu claude_desktop_config.json:

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

3. Cursor

Adicione às configurações de MCP do Cursor:

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

4. Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json (ou Settings → Cascade → MCP → Add Server):

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

5. Cline

No VS Code, abra o painel MCP Servers do Cline → Configure MCP Servers e adicione:

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

6. VS Code

Adicione um .vscode/mcp.json ao seu espaço de trabalho (o VS Code usa a chave servers; ${input:…} solicita sua chave na primeira execução):

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

7. Clientes remotos e HTTP

O pacote local funciona apenas por stdio. Ele não tem modo HTTP nem SSE. Para um cliente que se conecta por HTTP, use o servidor hospedado em https://www.taskade.com/mcp (consulte Servidor MCP do Taskade: guia de início rápido).

Ferramentas do pacote local (62)

O pacote local tem seus próprios nomes de ferramentas. Eles correspondem às APIs públicas v1 e v2 do Taskade.

Workspaces

Projetos

Tarefas

Agentes de IA

Crie, gerencie e publique agentes de IA autônomos com conhecimento e ferramentas personalizados.

Modelos

Mídia

Pessoal

Chat com agentes e webhooks (API v2, beta)

Recursos que a API v1 não oferece: manter uma conversa ao vivo com um agente de IA e receber eventos em tempo real.

Por que usar o Taskade MCP?

O Taskade MCP dá ao seu assistente de IA acesso ao seu workspace — projetos, tarefas, agentes, bases de conhecimento, modelos e automações (nos planos pagos; alguns endpoints, como a listagem de workspaces, são restritos em contas gratuitas). Em vez de escrever código para a API, descreva em linguagem natural o que você precisa.

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

Por que usar MCP em vez da API REST?

Por que escolher o Taskade MCP em vez de outros servidores MCP?

O Taskade MCP inclui gerenciamento de agentes de IA (criar, treinar e implantar agentes), treinamento de bases de conhecimento (anexar documentos, projetos e mídia) e geração de código OpenAPI (gerar ferramentas MCP a partir de qualquer especificação de API). 62 ferramentas em 8 categorias.

Receitas para agentes

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.

Casos de uso

Gerenciamento de projetos com IA

Peça ao seu assistente de IA para gerenciar seu workspace do Taskade:

• "Mostre todos os meus projetos e seus status"
• "Crie um novo projeto chamado Q1 Planning com tarefas para cada equipe"
• "Mova todas as tarefas atrasadas para o projeto Backlog"
• "Defina datas de vencimento para todas as tarefas do projeto Sprint"

Criação de agentes de IA

Crie e implante agentes de IA diretamente no seu editor:

• "Crie um agente de IA chamado Customer Support Bot com conhecimento do nosso projeto de documentação"
• "Gere um agente para revisão de código usando este prompt: ..."
• "Publique meu agente publicamente e me dê o link de compartilhamento"
• "Adicione nosso projeto de documentação da API como conhecimento do agente"

Fluxos de trabalho com modelos

Automatize a criação de projetos a partir de modelos:

• "Liste todos os modelos no meu workspace"
• "Crie 5 novos projetos de integração de clientes a partir do modelo Client Template"
• "Copie o projeto Sprint Retrospective desta semana"

Geração de código OpenAPI

Use nosso gerador para criar ferramentas MCP a partir de qualquer especificação OpenAPI — não apenas do Taskade.

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,
});

Compatível com qualquer especificação OpenAPI 3.0+. Gere ferramentas MCP para suas próprias APIs em minutos.

O que é o Taskade?

Taskade (Y Combinator S19) é o workspace nativo de IA para criar aplicativos, implantar agentes e automatizar fluxos de trabalho a partir de um único prompt. Mais de 150.000 aplicativos criados.

• Genesis Apps — Crie aplicativos completos a partir de prompts. Painéis, CRMs, portais, formulários — implantados instantaneamente. Experimente →
• Agentes de IA — Agentes personalizados com ferramentas integradas, memória persistente, equipes multiagente e incorporação pública
• Automações — Automação de fluxos de trabalho sem código, com mais de 100 integrações, ramificações, loops e filtros
• Colaboração em tempo real — Workspace multiusuário com chat, vídeo e várias visualizações de projeto
• Modelos: modelos para gerenciamento de projetos, engenharia, marketing e muito mais
• API e MCP: API REST v2, este servidor MCP, o plugin de agente, Agent API, webhooks, OAuth 2.0

Links:

• Aplicativo: taskade.com
• Criar: taskade.com/create
• Galeria de aplicativos: taskade.com/apps · todas as categorias
• Agentes: taskade.com/agents
• Modelos: taskade.com/templates
• Documentação: taskade.com/docs · docs.taskade.com
• Guia do Workspace MCP: https://github.com/taskade/docs/blob/main/apis-living-system-development/workspace-mcp.md
• Guia do MCP hospedado: https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md
• Blog: taskade.com/blog

Roteiro

Consulte problemas em aberto para ver os recursos e melhorias planejados.

Lançado recentemente (v0.1.0): Chat com agentes (promptAgent) e acionadores de webhook, disponíveis agora pela camada de ferramentas da API v2 do Taskade.

• Ferramentas de automação: o servidor hospedado lista automações, lê suas execuções e executa uma automação "When asked" (list_automations, get_flow_runs, run_flow). Criar, ativar e gerenciar automações pelo MCP está no roteiro.
• agent.js — Kit de ferramentas de agente autônomo de código aberto (em breve)
• TaskOS — Plataforma de agentes em docs.taskade.com

Privacidade e segurança

• Servidor hospedado. O Taskade o executa em www.taskade.com. Ele lê e grava apenas nos workspaces aos quais sua conta do Taskade tem acesso e que estão em um plano pago. O servidor não lê seu histórico de conversas com o cliente de IA. prompt_agent executa um agente do Taskade, que pode usar suas próprias ferramentas, como a pesquisa na web.
• Plugin de agente. O plugin contém habilidades (arquivos de texto) e o endereço do servidor hospedado. Ele não executa código próprio. A habilidade de backup grava arquivos do workspace em uma pasta local (./taskade-backup/, a menos que você indique outra).
• Pacote local. Seu token de API autoriza o servidor a chamar a API pública do Taskade (https://www.taskade.com/api/v1 e https://www.taskade.com/api/v2) em seu nome. O pacote não envia seus dados a nenhum outro serviço. Mantenha o token em uma variável de ambiente e nunca o inclua em um commit.
• Política de privacidade: taskade.com/privacy. Termos: taskade.com/terms.
• Relatórios de segurança e vulnerabilidades: consulte SECURITY.md.

Suporte

• Central de ajuda: help.taskade.com
• E-mail: support@taskade.com
• Bugs e solicitações de recursos: problemas no GitHub

Contribuições

Ajude-nos a aprimorar as ferramentas MCP, os fluxos de trabalho OpenAPI e os recursos dos agentes.

• Problemas — Relate bugs ou solicite recursos
• Pull Requests — Contribuições são bem-vindas
• Aplicativos — Explore e clone aplicativos da comunidade · categorias

Mais do Taskade

• Habilidade de agente (SKILL.md) · Índice llms.txt · Documentação para desenvolvedores
• Awesome Vibe Coding — seleção de ferramentas de vibe coding, servidores MCP e habilidades de agente
• Documentação do Taskade (código-fonte) — documentação para desenvolvedores e referência da API
• Kit de integração — ações e acionadores de código aberto para Zapier/n8n
• Taskade no GitHub — página da organização e repositórios de código aberto
• Taskade — página inicial da plataforma, incluindo o Genesis, o criador de aplicativos de IA

Licença

MIT