Taskade

Este repositorio contiene el plugin de agente de Taskade y dos paquetes:

• Servidor MCP (@taskade/mcp-server): el servidor local stdio, para clientes que no pueden conectarse a un servidor remoto.
• Generación de código OpenAPI: genera herramientas MCP a partir de cualquier especificación OpenAPI, no solo de Taskade.

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

El plugin taskade conecta tu herramienta de IA con tu espacio de trabajo de Taskade a través del servidor alojado y añade 7 habilidades: una puerta de entrada (taskade) y seis tareas (getting-started, import-spreadsheet, fix-my-app, app-report, backup-my-app, plan-new-app). Las habilidades indican al agente qué herramientas usar, en qué orden y qué comprobar antes de responder.

• Plan: El acceso MCP está incluido en todos los planes de pago de Taskade (Starter y superiores). Inicia sesión una vez con tu cuenta de Taskade.
• Qué hace: importa una hoja de cálculo a un proyecto, corrige una aplicación de Taskade Genesis con un cambio comprobado cada vez, informa sobre tus proyectos y automatizaciones, hace una copia de seguridad de una aplicación en una carpeta y planifica una aplicación nueva.
• Qué permanece en Taskade: el plugin no puede crear ni editar una automatización, crear ni publicar una aplicación, ni configurar quién puede usarla. Para esas tareas, redacta la solicitud para que la pegues en Taskade EVE.

VS Code: activa la configuración chat.plugins.enabled. Luego ejecuta Chat: Install Plugin From Source desde la paleta de comandos e introduce https://github.com/taskade/mcp.

Cursor: el plugin de Cursor taskade (.cursor-plugin/) de este repositorio añade el mismo servidor alojado y las mismas habilidades.

Para añadir solo el servidor alojado a Codex, ejecuta codex mcp add taskade --url https://www.taskade.com/mcp y luego codex mcp login taskade.

Contenido

• Plugin de agente
• Servidor MCP de Taskade: inicio rápido (Claude, Claude Code, ChatGPT, Cursor, VS Code, Windsurf)
• Herramientas alojadas
• Ejemplos de instrucciones
• Solución de problemas
• Paquete local (stdio)
• Herramientas del paquete local (62)
• ¿Por qué Taskade MCP?
• Recetas de agentes
• Generación de código OpenAPI
• ¿Qué es Taskade?
• Privacidad y seguridad
• Asistencia
• Contribuciones
• Licencia

Demostración

Agente de Taskade con tecnología MCP en Claude Desktop de Anthropic:

Crear agentes mediante MCP	Ejecutar automatizaciones	Gestionar proyectos
Crea, entrena e implementa agentes de IA desde Claude/Cursor	Enumera automatizaciones, ejecuta una y consulta sus ejecuciones	Gestión completa del espacio de trabajo desde tu asistente de IA (planes de pago)

Servidor MCP de Taskade: inicio rápido

Una solicitud initialize sin token devuelve 401 intencionadamente. El 401 indica a tu cliente dónde iniciar el inicio de sesión de OAuth.

Claude (web, Desktop y móvil)

1. En Claude, ve a Customize > Connectors y selecciona Add custom connector. En un plan Team o Enterprise, un propietario debe añadir primero el conector en Organization settings > Connectors (Add y luego Custom).
2. Introduce el nombre Taskade y la URL https://www.taskade.com/mcp; luego selecciona Add.
3. Selecciona Connect, inicia sesión en Taskade y autoriza el acceso.
4. En un chat, selecciona + > Connectors y activa Taskade.

Si el cuadro de diálogo solicita un OAuth client, selecciona Register automatically. El conector también funciona en Claude Desktop y en las aplicaciones móviles de Claude con la misma cuenta.

Claude Code

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

Luego ejecuta /mcp en Claude Code y selecciona taskade para iniciar sesión.

ChatGPT

ChatGPT se conecta a un servidor MCP remoto como conector personalizado en el modo de desarrollador. Solo usa OAuth.

1. En la configuración de ChatGPT, activa el modo de desarrollador para aplicaciones y conectores.
2. Crea un conector. Introduce Taskade como nombre y https://www.taskade.com/mcp como URL del servidor.
3. Selecciona OAuth como método de autenticación. Inicia sesión en Taskade y autoriza el acceso.

El modo de desarrollador solo está disponible en algunos planes de ChatGPT, y sus etiquetas cambian con frecuencia.

Cursor

Selecciona Add to Cursor en la parte superior de esta página o añade esto a ~/.cursor/mcp.json:

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

VS Code

Selecciona Install in VS Code en la parte superior de esta página o ejecuta:

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

Windsurf

Añade esto a ~/.codeium/windsurf/mcp_config.json:

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

Otros clientes y servidores (token de API)

Un cliente que no admita OAuth puede enviar un token de acceso personal de Taskade como token Bearer. Crea el token en Taskade Settings > API.

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

Guía completa: Taskade MCP alojado.

Herramientas alojadas

Todas las herramientas alojadas declaran anotaciones de herramientas MCP. Claude puede ejecutar una herramienta de solo lectura sin pedir confirmación, y solicita confirmación antes de usar una herramienta que elimina o reemplaza datos.

• get_flow_runs: consulta las ejecuciones recientes de una automatización, empezando por la más reciente. Cada ejecución incluye su estado y sus horarios. Si una ejecución falla, también indica el paso que falló y un breve mensaje de error. Requiere permisos de edición en las automatizaciones.
• run_flow: inicia una ejecución de una automatización que esté activada y configurada para iniciarse «When asked». Cada ejecución es real: cuenta para el límite mensual de ejecuciones de automatización del plan y los pasos de IA consumen créditos.

El servidor también ofrece el recurso taskade://getting-started, una breve guía para el modelo.

Ejemplos de instrucciones

1. Revisión semanal. «Enumera mis espacios de trabajo de Taskade, consulta el proyecto Q4 Roadmap y dame las tareas pendientes agrupadas por persona asignada». Herramientas: list_spaces, list_projects, read_project.
2. Planificar un lanzamiento. «Crea un proyecto llamado Website Launch en mi espacio de trabajo Marketing con tareas para el texto, el diseño, el control de calidad y el día del lanzamiento, y fija el lanzamiento para el 3 de noviembre». Herramientas: list_spaces, create_project, create_task, set_task_date.
3. Crear un agente de asistencia. «Crea un agente llamado Help Bot en mi espacio de trabajo Support, añade el proyecto FAQ como conocimiento y luego pregúntale cómo puede un cliente restablecer una contraseña». Herramientas: create_agent, add_knowledge_project, prompt_agent.
4. Cerrar un sprint. «En el proyecto Sprint 42, marca como completadas todas las tareas que mencionen “shipped” y luego marca el proyecto como completado». Herramientas: list_tasks, complete_task, complete_project.
5. Editar una aplicación de Genesis. «En mi aplicación CRM, consulta app/src/App.tsx y cambia el título de la página a Acme CRM». Herramientas: inspect_space, write_file.

Solución de problemas

Si el problema persiste, abre un issue o escribe a support@taskade.com.

Paquete local (stdio)

Usa el paquete local cuando tu cliente solo admita servidores stdio o cuando necesites una herramienta que solo esté disponible en el paquete local, como las herramientas de webhook (subscribeWebhook, unsubscribeWebhook). Se ejecuta en tu máquina con npx y llama a la API pública de Taskade a través de la red con un token de acceso personal.

1. Obtén tu clave de API

Ve a Taskade Settings > API y crea un token de acceso personal.

2. Claude Desktop

Añádelo a tu claude_desktop_config.json:

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

3. Cursor

Añádelo a la configuración de MCP de Cursor:

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

4. Windsurf

Añádelo a ~/.codeium/windsurf/mcp_config.json (o Settings → Cascade → MCP → Add Server):

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

5. Cline

En VS Code, abre el panel MCP Servers de Cline → Configure MCP Servers y añade:

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

6. VS Code

Añade un .vscode/mcp.json a tu espacio de trabajo (VS Code usa la clave servers; ${input:…} solicita tu clave la primera vez que se ejecuta):

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

7. Clientes remotos y HTTP

El paquete local solo funciona mediante stdio. No tiene modo HTTP ni SSE. Para un cliente que se conecte mediante HTTP, usa el servidor alojado en https://www.taskade.com/mcp (consulta Servidor MCP de Taskade: inicio rápido).

Herramientas del paquete local (62)

El paquete local tiene sus propios nombres de herramientas. Se corresponden con las API públicas v1 y v2 de Taskade.

Espacios de trabajo

Proyectos

Tareas

Agentes de IA

Crea, administra y publica agentes de IA autónomos con conocimientos y herramientas personalizados.

Plantillas

Contenido multimedia

Personal

Chat con agentes y webhooks (API v2, beta)

Capacidades que no ofrece la API v1: mantener una conversación en directo con un agente de IA y recibir eventos en tiempo real.

¿Por qué Taskade MCP?

Taskade MCP le da a tu asistente de IA acceso a tu espacio de trabajo: proyectos, tareas, agentes, bases de conocimiento, plantillas y automatizaciones (en los planes de pago; algunos endpoints, como el de enumeración de espacios de trabajo, están restringidos en las cuentas gratuitas). En lugar de escribir código para la API, describe en lenguaje natural lo que necesitas.

┌──────────────────────────────────────────────────────────┐
│                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 qué MCP en lugar de la API REST?

¿Por qué Taskade MCP en lugar de otros servidores MCP?

Taskade MCP incluye administración de agentes de IA (crear, entrenar y desplegar agentes), entrenamiento de bases de conocimiento (adjuntar documentos, proyectos y contenido multimedia) y generación de código OpenAPI (generar herramientas MCP a partir de cualquier especificación de API). 62 herramientas en 8 categorías.

Recetas 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

Gestión de proyectos con IA

Pídele a tu asistente de IA que administre tu espacio de trabajo de Taskade:

• "Muéstrame todos mis proyectos y su estado"
• "Crea un proyecto nuevo llamado Q1 Planning con tareas para cada equipo"
• "Mueve todas las tareas vencidas al proyecto Backlog"
• "Establece fechas de vencimiento para todas las tareas del proyecto Sprint"

Creación de agentes de IA

Crea y despliega agentes de IA directamente desde tu editor:

• "Crea un agente de IA llamado Customer Support Bot con conocimientos del proyecto de documentación"
• "Genera un agente para revisar código con esta instrucción: ..."
• "Publica mi agente y dame el enlace para compartir"
• "Añade nuestro proyecto de documentación de API como conocimiento del agente"

Flujos de trabajo con plantillas

Automatiza la creación de proyectos a partir de plantillas:

• "Enumera todas las plantillas de mi espacio de trabajo"
• "Crea 5 proyectos nuevos de incorporación de clientes a partir de la plantilla Client Template"
• "Copia el proyecto Sprint Retrospective para esta semana"

Generación de código OpenAPI

Usa nuestro generador para crear herramientas MCP a partir de cualquier especificación OpenAPI, no solo de 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,
});

Funciona con cualquier especificación OpenAPI 3.0 o posterior. Genera herramientas MCP para tus propias API en minutos.

¿Qué es Taskade?

Taskade (Y Combinator S19) es el espacio de trabajo nativo de IA para crear aplicaciones, desplegar agentes y automatizar flujos de trabajo a partir de una sola instrucción. Más de 150 000 aplicaciones creadas.

• Genesis Apps — Crea aplicaciones completas a partir de instrucciones. Paneles, CRM, portales, formularios: se despliegan al instante. Pruébalo →
• Agentes de IA — Agentes personalizados con herramientas integradas, memoria persistente, equipos multiagente e inserción pública
• Automatizaciones — Automatización de flujos de trabajo sin código, con más de 100 integraciones, ramificaciones, bucles y filtros
• Colaboración en tiempo real — Espacio de trabajo multiusuario con chat, video y varias vistas de proyectos
• Plantillas: plantillas para gestión de proyectos, ingeniería, marketing y más
• API y MCP: API REST v2, este servidor MCP, el complemento de agentes, Agent API, webhooks y OAuth 2.0

Enlaces:

• Aplicación: taskade.com
• Crear: taskade.com/create
• Galería de aplicaciones: taskade.com/apps · todas las categorías
• Agentes: taskade.com/agents
• Plantillas: taskade.com/templates
• Documentación: taskade.com/docs · docs.taskade.com
• Guía de Workspace MCP: https://github.com/taskade/docs/blob/main/apis-living-system-development/workspace-mcp.md
• Guía de Hosted MCP: https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md
• Blog: taskade.com/blog

Hoja de ruta

Consulta los problemas abiertos para ver las funciones y mejoras previstas.

Lanzado recientemente (v0.1.0): chat con agentes (promptAgent) y activadores de webhooks, ya disponibles mediante la capa de herramientas de Taskade API v2.

• Herramientas de automatización: el servidor alojado enumera automatizaciones, lee sus ejecuciones y ejecuta una automatización "When asked" (list_automations, get_flow_runs, run_flow). La creación, activación y administración de automatizaciones mediante MCP están en la hoja de ruta.
• agent.js — Kit de herramientas de código abierto para agentes autónomos (próximamente)
• TaskOS — Plataforma de agentes en docs.taskade.com

Privacidad y seguridad

• Servidor alojado. Taskade lo ejecuta en www.taskade.com. Solo lee y escribe en los espacios de trabajo a los que puede acceder tu cuenta de Taskade y que pertenecen a un plan de pago. El servidor no lee tu historial de chat con el cliente de IA. prompt_agent ejecuta un agente de Taskade, que puede usar sus propias herramientas, como la búsqueda web.
• Complemento de agentes. El complemento contiene habilidades (archivos de texto) y la dirección del servidor alojado. No ejecuta código propio. La habilidad de copia de seguridad escribe los archivos del espacio de trabajo en una carpeta local (./taskade-backup/, a menos que indiques otra).
• Paquete local. Tu token de API autoriza al servidor a llamar a las API públicas de Taskade (https://www.taskade.com/api/v1 y https://www.taskade.com/api/v2) en tu nombre. El paquete no envía tus datos a ningún otro servicio. Guarda el token en una variable de entorno y no lo incluyas nunca en un commit.
• Política de privacidad: taskade.com/privacy. Términos: taskade.com/terms.
• Informes de seguridad y vulnerabilidades: consulta SECURITY.md.

Asistencia

• Centro de ayuda: help.taskade.com
• Correo electrónico: support@taskade.com
• Errores y solicitudes de funciones: problemas de GitHub

Contribuciones

Ayúdanos a mejorar las herramientas MCP, los flujos de trabajo de OpenAPI y las capacidades de los agentes.

• Problemas — Informa de errores o solicita funciones
• Solicitudes de incorporación de cambios — Agradecemos las contribuciones
• Aplicaciones — Explora y clona aplicaciones de la comunidad · categorías

Más de Taskade

• Habilidad de agente (SKILL.md) · Índice llms.txt · Documentación para desarrolladores
• Awesome Vibe Coding — selección de herramientas de vibe coding, servidores MCP y habilidades para agentes
• Documentación de Taskade (código fuente) — documentación para desarrolladores y referencia de la API
• Kit de integración — acciones y activadores de código abierto para Zapier/n8n
• Taskade en GitHub — página de la organización y repositorios de código abierto
• Taskade — página principal de la plataforma, incluido Genesis, el creador de aplicaciones de IA

Licencia

MIT