Guida al connettore8 minuti di lettura20 tool MCP7 lingue

Collegare Tookan MCP a 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.

HCA cura del team HelpCodeAggiornato 8 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Tookan

Tookan

Tookan (Jungleworks) delivery and field workforce management: create, edit, assign and track pickup, delivery, appointment and field tasks, update their status, see agents with their location and status, teams and customers. One API key.

tool

20

Regione

INTL

Categoria

Logistica

Autenticazione

API credentials

Env vars richieste

TOOKAN_API_KEY
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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.

Tookan · live via MCP
Condividi
Opus 4.7

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.

  1. Accedi su app.tookanapp.com e apri Impostazioni → Chiavi API.
  2. Nella scheda V2 copia la chiave API in TOOKAN_API_KEY. Se l'elenco è vuoto, clicca prima su Genera Chiave.
  3. Installa il connettore. Esegui tookan_list_teams per 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 mostra YOUR_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.

  1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
  2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
  3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
  4. 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.
  5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Tookan.
  6. 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

StrumentoCosa fa
tookan_list_tasksElenca 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_detailsLeggi 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_idLeggi 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_tasksLeggi le attività di ritiro e consegna che appartengono insieme, tramite il valore pickup_delivery_relationship di un'attività
tookan_list_agentsElenca 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_profileLeggi 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_locationLeggi l'ultima latitudine e longitudine conosciute di un agente
tookan_find_agents_nearbyTrova agenti entro un raggio di un punto (fino a 100 km), con la loro distanza e stato
tookan_list_teamsElenca le squadre: team_id, team_name, indirizzo, coordinate, tag, utilizzo della batteria
tookan_list_customersElenca i clienti: customer_id, nome, telefono, email, indirizzo e coordinate
tookan_find_customer_by_phoneTrova clienti per numero di telefono: customer_id, nome, email, telefono, indirizzo e coordinate
tookan_get_customerLeggi il profilo di un cliente: nome, telefono, email, indirizzo, coordinate e data di creazione
tookan_create_taskCrea un'attività
tookan_edit_taskModifica un'attività esistente: indirizzi, tempi, cliente, descrizione, squadra, agente, tag o campi personalizzati
tookan_update_task_statusImposta 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_taskAssegna un'attività a un agente di una squadra (o riassegnala). notify 1 avvisa l'agente
tookan_delete_taskCancella un'attività
tookan_add_customerAggiungi un cliente alla lista clienti di Tookan
tookan_edit_customerModifica il nome, il telefono, l'email, l'indirizzo o le coordinate di un cliente tramite customer_id
tookan_delete_customerCancella 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?

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.

Guide correlate

Connettori

Collegare Tookan MCP a ChatGPT

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.

Connettori

Collegare Tookan MCP a Claude

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.

Connettori

Collegare Tookan MCP a Cursor

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.

Connettori

Collegare Tookan MCP a Gemini CLI

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.

Connettori

Collegare Tookan MCP a 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.

Connettori

Tookan MCP Server: consegne e agenti

Gestione delle consegne e della forza lavoro sul campo di Tookan (Jungleworks): crea, modifica, assegna e monitora compiti di ritiro, consegna, appuntamenti e sul campo, aggiorna il loro stato, visualizza gli agenti con la loro posizione e stato, team e clienti. Una chiave API.