Conexión MCP

Tovaki aloja un servidor MCP. Crea un token, conecta Claude Code o Cursor con una línea y tu agente podrá leer el lienzo y enviar comandos.

URL del servidor (la misma para cualquier cliente MCP): Streamable HTTP · Authorization: Bearer

https://tovaki.com/agent/v1/mcp

Primero genera un token en la página de Tokens (hay un enlace en la sección «API Token» más abajo) y luego conecta desde tu cliente.

Herramientas disponibles

• canvas_snapshot — Lee una instantánea del lienzo: la lista de nodos con id, tipo, estado y título.
• canvas_ops — Envía operaciones al lienzo. Entran en cola y se ejecutan en 10 segundos con el lienzo abierto.
• ops_status — Consulta el estado de tus últimas 20 operaciones.

Los comandos entran en cola y se ejecutan en 10s con el lienzo abierto; caducan tras 1 hora y el estado siempre se puede consultar.

Claude Code

Un comando (sustituye el token creado arriba):

claude mcp add --transport http tovaki https://tovaki.com/agent/v1/mcp \
  --header "Authorization: Bearer tvk_tu_token"

Cursor

Añade esto al mcp.json de Cursor (Settings → MCP):

{
  "mcpServers": {
    "tovaki": {
      "url": "https://tovaki.com/agent/v1/mcp",
      "headers": { "Authorization": "Bearer tvk_tu_token" }
    }
  }
}

Terminal curl

¿Sin cliente MCP? Llama a la API REST directamente:

1 · Verifica la conexión:

curl https://tovaki.com/agent/v1/verify \
  -H "Authorization: Bearer tvk_tu_token"

2 · Leer una instantánea del lienzo:

curl "https://tovaki.com/agent/v1/canvas?projectId=..." \
  -H "Authorization: Bearer tvk_tu_token"

3 · Enviar órdenes al lienzo (el token debe tener permiso «Lectura y escritura»; se ejecuta en 10 s con el lienzo abierto):

curl -X POST https://tovaki.com/agent/v1/ops \
  -H "Authorization: Bearer tvk_tu_token" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"...","ops":[{"tool":"arrange_row","args":{"selector":{"all":true}}}]}'

4 · Ver el estado de las últimas órdenes:

curl "https://tovaki.com/agent/v1/ops?projectId=..." \
  -H "Authorization: Bearer tvk_tu_token"

API Token

Crea, revoca y gestiona los tokens en su página propia. Gestionar tokens →

Permisos y límites

• Los tokens tienen dos permisos, «Solo lectura» y «Lectura y escritura»: el de lectura puede leer instantáneas y consultar el estado; enviar órdenes requiere lectura y escritura. Ninguno da acceso a pagos ni a la configuración de la cuenta.
• Las acciones de pago (generación, escalado) no se pueden enviar por MCP — solo las confirmas tú, dentro del sitio.

Los conectores de ChatGPT requieren OAuth; el soporte está en preparación.