Resumen
Gestión de entrega y fuerza laboral de campo de Tookan (Jungleworks): crear, editar, asignar y rastrear tareas de recogida, entrega, citas y campo, actualizar su estado, ver agentes con su ubicación y estado, equipos y clientes. Una clave API.
Configuración guiada
Conecta Tookan a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Tookan con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Tookan
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Tookan, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Tookan
Gestión de entrega y fuerza laboral de campo de Tookan (Jungleworks): crear, editar, asignar y rastrear tareas de recogida, entrega, citas y campo, actualizar su estado, ver agentes con su ubicación y estado, equipos y clientes. Una clave API.
Configuración
Configurar toma aproximadamente 2 minutos. Necesitas una cuenta de Tookan en app.tookanapp.com con acceso a Configuración → Claves API. El conector necesita una clave API.
- Inicia sesión en app.tookanapp.com y abre Configuración → Claves API.
- En la pestaña V2, copia la clave API en
TOOKAN_API_KEY. Si la lista está vacía, haz clic en Generar Clave primero. - Instala el conector. Ejecuta
tookan_list_teamspara verificar la conexión: lista tus equipos con sus ids.
La nube y el autoalojamiento funcionan de la misma manera: la clave es la misma, y no hay URL de redirección que configurar.
Autenticación: cada llamada a Tookan es un POST con un cuerpo JSON, y el conector añade api_key a cada cuerpo. La clave da acceso completo a la cuenta, así que trátala como una contraseña.
Por dónde empezar: tookan_list_teams para ids de equipos, tookan_list_agents para agentes y su estado, tookan_list_tasks para las tareas de un día (necesita el tipo de tarea, una fecha de inicio y una fecha de fin) y tookan_get_task_details para una tarea.
Qué lee: tareas de un tipo en un rango de fechas de máximo 31 días, paginadas con requested_page; hasta 100 tareas a la vez con su historial; tareas por tus propios ids de pedido; la recogida y entrega que pertenecen a un pedido; agentes con su estado, perfil, tareas actuales y última ubicación conocida; agentes dentro de un radio de un punto (hasta 100 km); equipos; clientes por nombre o teléfono.
Qué escribe: tookan_create_task, tookan_edit_task, tookan_update_task_status, tookan_assign_task, tookan_add_customer y tookan_edit_customer están activados. Con tookan_assign_task, notify 1 alerta al agente.
Desactivado al instalar: tookan_delete_task (eliminar una tarea) y tookan_delete_customer (eliminar un cliente). Ninguno puede ser restaurado. Para detener una tarea pero mantenerla, la IA establece el estado 9 (cancelada) con tookan_update_task_status. Actívalos en la página del conector si la IA debe usarlos; la IA te pedirá que confirmes cada cambio.
Tipos de tareas: tookan_create_task elige el tipo con layout_type, has_pickup y has_delivery: recogida 0, 1, 0; entrega 0, 0, 1; recogida y entrega 0, 1, 1; cita 1, 0, 0; fuerza laboral de campo 2, 0, 0. En listas, los tipos de tarea son 0 recogida, 1 entrega, 2 cita y 3 fuerza laboral de campo.
Estados: las tareas son 0 asignadas, 1 iniciadas, 2 exitosas, 3 fallidas, 4 en progreso o llegadas, 6 no asignadas, 7 aceptadas, 8 rechazadas, 9 canceladas y 10 eliminadas. Los agentes son 0 disponibles, 1 desconectados y 2 ocupados.
Tiempos: los tiempos de las tareas son locales, YYYY-MM-DD HH:MM:SS; los filtros de lista toman YYYY-MM-DD. timezone es el desplazamiento UTC en minutos con el signo invertido: India -330, Europa Central -60 en invierno y -120 en verano, Nueva York 300 en invierno. Las respuestas utilizan 0000-00-00 00:00:00 para tiempos vacíos.
Privacidad: los tokens de inicio de sesión y los hashes de contraseñas que Tookan incluye en las respuestas de agentes y clientes son eliminados antes de llegar a la IA.
Límites: Tookan no publica límites de tasa, así que la IA evita bucles ajustados y utiliza los filtros de fecha e id.
Errores comunes: Tookan informa el resultado en el cuerpo: status 100 significa un parámetro faltante, 101 una clave API inválida, 201 una acción rechazada con la razón en message, y 404 un error de ejecución. El conector informa estos como llamadas fallidas con el mensaje.
No cubierto: transacciones de billetera de agentes, pagos y estimaciones de tarifas (nada mueve dinero), administración de comerciantes, geocercas y webhooks.
Requisitos previos: TOOKAN_API_KEY
Instalar el conector localmente
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Abre http://localhost:3000/connectors/store, elige Tookan y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
tookan_list_tasks | Lista tareas de un tipo en un rango de fechas (máximo 31 días): job_id, order_id, job_status (0 asignada, 1 iniciada, 2 exitosa, 3 fallida, 4 en… |
tookan_get_task_details | Lee hasta 100 tareas por id: estado, tipo, agente, equipo, cliente, direcciones y coordenadas, tiempos programados, iniciados, llegados y completados… |
tookan_get_tasks_by_order_id | Lee las tareas creadas con tus propios ids de pedido (campo order_id de crear): los mismos detalles que tookan_get_task_details |
tookan_get_related_tasks | Lee las tareas de recogida y entrega que pertenecen juntas, por el valor pickup_delivery_relationship de una tarea |
tookan_list_agents | Lista agentes (conductores, personal de campo, llamados flotas en la API): fleet_id, nombre, nombre de usuario, correo electrónico, teléfono, estado (0 disponible, 1 desconectado, 2… |
tookan_get_agent_profile | Lee el perfil de un agente y las tareas actuales: nombre, contacto, etiquetas, transporte, equipo, estado, ubicación y los trabajos asignados a ellos |
tookan_get_agent_location | Lee la última latitud y longitud conocidas de un agente |
tookan_find_agents_nearby | Encuentra agentes dentro de un radio de un punto (hasta 100 km), con su distancia y estado |
tookan_list_teams | Lista equipos: team_id, team_name, dirección, coordenadas, etiquetas, uso de batería |
tookan_list_customers | Lista clientes: customer_id, nombre, teléfono, correo electrónico, dirección y coordenadas |
tookan_find_customer_by_phone | Encuentra clientes por número de teléfono: customer_id, nombre, correo electrónico, teléfono, dirección y coordenadas |
tookan_get_customer | Lee el perfil de un cliente: nombre, teléfono, correo electrónico, dirección, coordenadas y fecha de creación |
tookan_create_task | Crea una tarea |
tookan_edit_task | Cambia una tarea existente: direcciones, tiempos, cliente, descripción, equipo, agente, etiquetas o campos personalizados |
tookan_update_task_status | Establece el estado de una o más tareas: 0 asignada, 1 iniciada, 2 exitosa, 3 fallida, 4 en progreso o llegada, 6 no asignada, 7 aceptada, 8… |
tookan_assign_task | Asigna una tarea a un agente de un equipo (o la reasigna). notify 1 alerta al agente |
tookan_delete_task | Elimina una tarea |
tookan_add_customer | Agrega un cliente a la lista de clientes de Tookan |
tookan_edit_customer | Cambia el nombre, teléfono, correo electrónico, dirección o coordenadas de un cliente por customer_id |
tookan_delete_customer | Elimina un cliente |
Ejemplos de prompts
- "¿Qué tareas de entrega para hoy aún no están asignadas?"
- "¿Qué agentes están disponibles ahora mismo, y cuáles están dentro de 5 km del depósito?"
- "Muestra las tareas de recogida y entrega del pedido 10452 y su estado."
- "Crea una tarea de entrega a 12 Market Street para mañana a las 10:00 para el cliente con teléfono +15551234567."
- "Asigna la tarea 98765 al agente disponible más cercano del equipo del centro y notifícalo."
Próximos pasos
¿Te ha sido útil esta guía?