¿Qué es el MCP de Whet?
Model Context Protocol (MCP) es un protocolo abierto que permite a aplicaciones host (Claude Desktop, Cursor, agentes propios) descubrir y ejecutar tools expuestas por servers externos. Whet expone su propio MCP server para que cualquier agente compatible pueda operar el workbench con los mismos permisos que un humano.
¿Por qué nos importa?
Whet está diseñado agent-native by default: cada acción que un humano hace en la UI tiene paridad en CLI y MCP. Eso significa que un agente puede:
- Crear pipelines desde un intent ("seguí a este competidor y generá drafts diarios").
- Leer el inbox de artifacts pendientes.
- Refinar drafts (shorter, change tone, match voice).
- Publicar con confirmación explícita.
- Diagnosticar un pipeline que no está produciendo lo esperado.
- Manejar una session de drafting end-to-end: snapshottear items upstream, attachear variantes, generar, exportar.
- Leer y editar dashboards de analytics como artifacts vivos.
Sin tener que mirar la UI, sin scrapear tu workbench, sin re-implementar lógica.
Arquitectura
El MCP server vive como rutas Next.js dentro del workbench (apps/web/lib/mcp/ + /app/api/mcp/route.ts). No es un container separado. Esto simplifica el deployment: si el workbench corre, el MCP corre.
- Transport: WebStandard Streamable HTTP (stateless per-request).
- Endpoint:
POST /api/mcp(tambiénGETyDELETE). - Auth: Bearer token en el header
Authorization. Mismo token que usa el CLI. - SDK:
@modelcontextprotocol/sdkv1.29.
Cada request crea una instancia fresca de McpServer. No hay sesión compartida — el state vive en la base del workbench.
Lo que expone
| Superficie | Cantidad | Detalle |
|---|---|---|
| Core tools | 8 | start_draft, read_inbox, list_posts, diagnose_pipeline, create_pipeline_from_intent, publish_artifact, connect_x_account, scrape_url. Ver Tools. |
| Sessions tools | 18 | Lifecycle + selection + variants + exports + presets del canvas de drafting. Ver Tools y el concepto Sessions. |
| Dashboards tools | 9 | Read/write de dashboards y widgets, con catálogo de datasets y ejecución de widgets. Ver Tools. |
| Prompts | 2 | Templates guía: draft_from_handle, refine_post. Ver Prompts y resources. |
| Resources | 2 | URIs accesibles: pipeline://{id}, artifact://{id}. Ver Prompts y resources. |
Empezar
Elegí tu client:
- Claude Desktop
- Cursor
- Cualquier otro MCP client soporta Streamable HTTP — usá la misma config.
Modelo de permisos
Hoy el agent token tiene scope completo del workspace (MVP). Scopes granulares (org:read, artifacts:publish, etc.) están en el roadmap. Mientras tanto, la regla operativa es manual: si querés que un agente NO publique, no le des un token; usalo en flujos donde la decisión de publicar pasa por un humano confirmando.
Whet no auto-publica. Ni desde MCP, ni desde el CLI, ni desde la UI. Cada publish_artifact representa una decisión explícita. Esto es por diseño, no es un toggle.