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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Tookan con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Tookan. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, 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.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?