Resumen
Tookan (Jungleworks) gestión de entregas y fuerza laboral en campo: 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 Microsoft 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 Microsoft Copilot. 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.
💡 ¿No tienes 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 + Microsoft Copilot
Tookan (Jungleworks) gestión de entregas y fuerza laboral en campo: 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.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
TOOKAN_API_KEY
Paso 1 — Obtener credenciales
La configuración tarda 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 otorga 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 orden; la recogida y entrega que pertenecen a una orden; 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 pide 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 en campo 2, 0, 0. En listas, los tipos de tarea son 0 recogida, 1 entrega, 2 cita y 3 fuerza laboral en 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 fuera de línea 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.
Paso 2 — Instalar el adaptador
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
Paso 3 — Agregar el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Tookan. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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 orden (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 fuera de línea, 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 reasígnala). 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 indicaciones
- "¿Qué tareas de entrega para hoy aún están sin asignar?"
- "¿Qué agentes están disponibles en este momento, y cuáles están dentro de 5 km del depósito?"
- "Muestra las tareas de recogida y entrega de la orden 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ícale."
Preguntas frecuentes
¿Puede eliminar tareas? tookan_delete_task existe pero está desactivado al instalar. Para detener una tarea y mantener su historial, la IA establece el estado 9 (cancelada) con tookan_update_task_status.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?