In breve
Gestione delle consegne e della forza lavoro sul campo di Tookan (Jungleworks): crea, modifica, assegna e monitora attività di ritiro, consegna, appuntamenti e lavoro sul campo, aggiorna il loro stato, visualizza gli agenti con la loro posizione e stato, squadre e clienti. Una chiave API.
Configurazione guidata
Collega Tookan a Meta Muse in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Tookan con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Tookan
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Tookan, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Tookan + Meta Muse
Gestione delle consegne e della forza lavoro sul campo di Tookan (Jungleworks): crea, modifica, assegna e monitora attività di ritiro, consegna, appuntamenti e lavoro sul campo, aggiorna il loro stato, visualizza gli agenti con la loro posizione e stato, squadre e clienti. Una chiave API.
Requisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:
TOOKAN_API_KEY
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 2 minuti. Hai bisogno di un account Tookan su app.tookanapp.com con accesso a Impostazioni → Chiavi API. Il connettore ha bisogno di una chiave API.
- Accedi su app.tookanapp.com e apri Impostazioni → Chiavi API.
- Nella scheda V2 copia la chiave API in
TOOKAN_API_KEY. Se l'elenco è vuoto, clicca prima su Genera Chiave. - Installa il connettore. Esegui
tookan_list_teamsper controllare la connessione: elenca le tue squadre con i loro ID.
Cloud e self-hosted funzionano allo stesso modo: la chiave è la stessa e non c'è un URL di reindirizzamento da impostare.
Autenticazione: ogni chiamata a Tookan è un POST con un corpo JSON, e il connettore aggiunge api_key a ciascun corpo. La chiave fornisce accesso completo all'account, quindi trattala come una password.
Da dove iniziare: tookan_list_teams per gli ID delle squadre, tookan_list_agents per gli agenti e il loro stato, tookan_list_tasks per le attività di un giorno (ha bisogno del tipo di attività, di una data di inizio e di una data di fine) e tookan_get_task_details per un'attività.
Cosa legge: attività di un tipo in un intervallo di date di al massimo 31 giorni, paginato con requested_page; fino a 100 attività alla volta con la loro storia; attività per i tuoi stessi ID ordine; il ritiro e la consegna che appartengono a un ordine; agenti con il loro stato, profilo, attività correnti e ultima posizione nota; agenti entro un raggio di un punto (fino a 100 km); squadre; clienti per nome o telefono.
Cosa scrive: tookan_create_task, tookan_edit_task, tookan_update_task_status, tookan_assign_task, tookan_add_customer e tookan_edit_customer sono attivati. Con tookan_assign_task, notify 1 avvisa l'agente.
Disattivato all'installazione: tookan_delete_task (cancellare un'attività) e tookan_delete_customer (cancellare un cliente). Nessuno dei due può essere ripristinato. Per fermare un'attività ma mantenerla, l'AI imposta lo stato 9 (annullato) con tookan_update_task_status. Attivali nella pagina del connettore se l'AI deve usarli; l'AI ti chiede di confermare ogni modifica.
Tipi di attività: tookan_create_task sceglie il tipo con layout_type, has_pickup e has_delivery: ritiro 0, 1, 0; consegna 0, 0, 1; ritiro e consegna 0, 1, 1; appuntamento 1, 0, 0; forza lavoro sul campo 2, 0, 0. Nelle liste i tipi di attività sono 0 ritiro, 1 consegna, 2 appuntamento e 3 forza lavoro sul campo.
Stati: le attività sono 0 assegnate, 1 avviate, 2 riuscite, 3 fallite, 4 in corso o arrivate, 6 non assegnate, 7 accettate, 8 rifiutate, 9 annullate e 10 cancellate. Gli agenti sono 0 disponibili, 1 offline e 2 occupati.
Tempi: i tempi delle attività sono locali, YYYY-MM-DD HH:MM:SS; i filtri delle liste prendono YYYY-MM-DD. timezone è il fuso orario UTC in minuti con il segno invertito: India -330, Europa Centrale -60 in inverno e -120 in estate, New York 300 in inverno. Le risposte usano 0000-00-00 00:00:00 per i tempi vuoti.
Privacy: i token di accesso e gli hash delle password che Tookan include nelle risposte degli agenti e dei clienti vengono rimossi prima di raggiungere l'AI.
Limiti: Tookan non pubblica limiti di frequenza, quindi l'AI evita cicli stretti e utilizza i filtri di data e ID.
Errori comuni: Tookan riporta il risultato nel corpo: status 100 significa un parametro mancante, 101 una chiave API non valida, 201 un'azione rifiutata con il motivo in message, e 404 un errore di esecuzione. Il connettore riporta questi come chiamate fallite con il messaggio.
Non coperto: transazioni del portafoglio degli agenti, pagamenti e stime delle tariffe (niente muove denaro), amministrazione dei commercianti, geofences e webhook.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in Muse
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Tookan.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
tookan_list_tasks | Elenca le attività di un tipo in un intervallo di date (al massimo 31 giorni): job_id, order_id, job_status (0 assegnato, 1 avviato, 2 riuscito, 3 fallito, 4 in… |
tookan_get_task_details | Leggi fino a 100 attività per ID: stato, tipo, agente, squadra, cliente, indirizzi e coordinate, tempi programmati, avviati, arrivati e completati… |
tookan_get_tasks_by_order_id | Leggi le attività create con i tuoi stessi ID ordine (campo order_id di create): gli stessi dettagli di tookan_get_task_details |
tookan_get_related_tasks | Leggi le attività di ritiro e consegna che appartengono insieme, tramite il valore pickup_delivery_relationship di un'attività |
tookan_list_agents | Elenca gli agenti (autisti, personale sul campo, chiamati flotte nell'API): fleet_id, nome, username, email, telefono, stato (0 disponibile, 1 offline, 2… |
tookan_get_agent_profile | Leggi il profilo di un agente e le attività correnti: nome, contatto, tag, trasporto, squadra, stato, posizione e i lavori assegnati a loro |
tookan_get_agent_location | Leggi l'ultima latitudine e longitudine conosciute di un agente |
tookan_find_agents_nearby | Trova agenti entro un raggio di un punto (fino a 100 km), con la loro distanza e stato |
tookan_list_teams | Elenca le squadre: team_id, team_name, indirizzo, coordinate, tag, utilizzo della batteria |
tookan_list_customers | Elenca i clienti: customer_id, nome, telefono, email, indirizzo e coordinate |
tookan_find_customer_by_phone | Trova clienti per numero di telefono: customer_id, nome, email, telefono, indirizzo e coordinate |
tookan_get_customer | Leggi il profilo di un cliente: nome, telefono, email, indirizzo, coordinate e data di creazione |
tookan_create_task | Crea un'attività |
tookan_edit_task | Modifica un'attività esistente: indirizzi, tempi, cliente, descrizione, squadra, agente, tag o campi personalizzati |
tookan_update_task_status | Imposta lo stato di una o più attività: 0 assegnato, 1 avviato, 2 riuscito, 3 fallito, 4 in corso o arrivato, 6 non assegnato, 7 accettato, 8… |
tookan_assign_task | Assegna un'attività a un agente di una squadra (o riassegnala). notify 1 avvisa l'agente |
tookan_delete_task | Cancella un'attività |
tookan_add_customer | Aggiungi un cliente alla lista clienti di Tookan |
tookan_edit_customer | Modifica il nome, il telefono, l'email, l'indirizzo o le coordinate di un cliente tramite customer_id |
tookan_delete_customer | Cancella un cliente |
Esempi di prompt
- "Quali attività di consegna per oggi sono ancora non assegnate?"
- "Quali agenti sono disponibili in questo momento e quali sono entro 5 km dal deposito?"
- "Mostra le attività di ritiro e consegna dell'ordine 10452 e il loro stato."
- "Crea un'attività di consegna per 12 Market Street per domani alle 10:00 per il cliente con telefono +15551234567."
- "Assegna l'attività 98765 all'agente disponibile più vicino del team del centro e avvisali."
FAQ
Può cancellare attività? tookan_delete_task esiste ma è disattivato all'installazione. Per fermare un'attività e mantenere la sua storia, l'AI imposta lo stato 9 (annullato) con tookan_update_task_status.
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
Questa guida ti è stata utile?