In breve
Gestione progetti YouGile: progetti, bacheche kanban, colonne, attività con scadenze, checklist e assegnatari, messaggi di chat delle attività, dipendenti, reparti, adesivi personalizzati e di sprint e abbonamenti webhook. Chiave API.
Configurazione guidata
Collega YouGile a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega YouGile 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 YouGile
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 Connectors → YouGile, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
YouGile + Microsoft Copilot
Gestione progetti YouGile: progetti, bacheche kanban, colonne, attività con scadenze, checklist e assegnatari, messaggi di chat delle attività, dipendenti, reparti, adesivi personalizzati e di sprint e abbonamenti webhook. Chiave API.
Requisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
YOUGILE_API_KEY
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 5 minuti.
YouGile non ha una pagina che mostra una chiave API: una chiave viene creata con una chiamata API che prende il tuo login e password di YouGile. Eseguila una volta da un terminale; il connettore stesso non vede mai la tua password.
- Trova il tuo id aziendale: nell'app web di YouGile premi Ctrl+Alt+Q (Ctrl+Option+Q su un Mac), oppure esegui
curl -X POST https://yougile.com/api-v2/auth/companies -H "Content-Type: application/json" -d '{"login":"<la tua email>","password":"<la tua password>"}'e prendicontent[].iddella tua azienda. - Crea la chiave:
curl -X POST https://yougile.com/api-v2/auth/keys -H "Content-Type: application/json" -d '{"login":"<la tua email>","password":"<la tua password>","companyId":"<id aziendale>"}'. La risposta è{"key":"..."}. - Incolla la chiave in
YOUGILE_API_KEY.
Una chiave non scade. Un account può contenere al massimo 30 chiavi; elencale con POST /auth/keys/get (stesso corpo di login) e rimuovila con DELETE /auth/keys/<chiave>. La chiave agisce come l'impiegato che l'ha creata e vede solo ciò che quell'impiegato vede, quindi creala con un account che può aprire i progetti su cui vuoi lavorare.
Da dove iniziare: yougile_get_current_user controlla la chiave. Poi scendi: yougile_list_projects, yougile_list_boards con l'id del progetto, yougile_list_columns con l'id della bacheca, yougile_list_tasks con l'id della colonna.
Struttura: yougile_get_project, yougile_get_board, yougile_get_column; crea con yougile_create_project, yougile_create_board, yougile_create_column; modifica con yougile_update_project, yougile_update_board, yougile_update_column. Un'attività appartiene a una colonna, una colonna a una bacheca, una bacheca a un progetto.
Attività: yougile_list_tasks (filtra per colonna, assegnatario, titolo o stato dell'adesivo), yougile_get_task, yougile_create_task, yougile_update_task, e yougile_move_task per cambiare la colonna. yougile_delete_task è installato disattivato; imposta archived con yougile_update_task per il lavoro completato.
Chat: ogni attività ha una chat il cui id è l'id dell'attività. Leggila con yougile_list_task_messages e scrivi con yougile_send_task_message. yougile_list_group_chats elenca le chat aziendali, che utilizzano i stessi due strumenti.
Persone: yougile_list_users, yougile_get_user, yougile_list_departments, yougile_get_department.
Adesivi: i campi personalizzati di un'attività sono adesivi. yougile_list_string_stickers e yougile_get_string_sticker restituiscono adesivi con un insieme fisso di stati (priorità, tipo); yougile_list_sprint_stickers e yougile_get_sprint_sticker restituiscono sprint. Creali con yougile_create_string_sticker e yougile_create_sprint_sticker, attivali per una bacheca con yougile_update_board, poi impostali su un'attività come id adesivo per id stato.
Webhook: yougile_list_webhooks mostra gli abbonamenti e i loro contatori di errore.
Liste e paging: gli strumenti di elenco rispondono con paging (count, limit, offset, next) e content. Dimensione della pagina predefinita 50, al massimo 1000; mentre paging.next è vero, chiama di nuovo con offset aumentato di limit. Gli oggetti eliminati sono esclusi a meno che include_deleted non sia vero.
Tempi: i tempi delle attività e dei messaggi sono millisecondi dal 1970 (timestamp, deadline.deadline, messaggio id); sprint begin e end sono secondi. Gli id sono UUID; gli id degli stati degli adesivi sono brevi stringhe esadecimali.
Limite di richiesta: 50 richieste al minuto per l'intera azienda, condivise da tutte le sue chiavi. Paga con un grande limit invece di molte piccole chiamate.
Errori: una chiamata fallita ha uno stato di 4xx o 5xx e un campo error o message. 401 significa che la chiave è errata o è stata eliminata; 403 o 404 su un oggetto che esiste significa che il proprietario della chiave non ha accesso ad esso.
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
YouGile. - 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 |
|---|---|
yougile_get_current_user | Leggi l'impiegato a cui appartiene la chiave API: id, email, realName, isAdmin, status (online o offline) e lastActivity. Usalo per controllare il… |
yougile_list_users | Elenca gli impiegati dell'azienda: id, email, realName, isAdmin, messengerOnly, status e lastActivity. Filtra per email o per progetto. Il… |
yougile_get_user | Leggi un impiegato per id: email, realName, isAdmin, messengerOnly, status, lastActivity e customStatus. Solo lettura |
yougile_list_departments | Elenca i reparti dell'azienda: id, title, parentId (il dipartimento sopra, assente a livello superiore) e users (id impiegato mappato a… |
yougile_get_department | Leggi un dipartimento per id: title, parentId e users (id impiegato mappato a manager o membro). Solo lettura |
yougile_list_projects | Elenca i progetti che il proprietario della chiave può vedere: id, title, timestamp (tempo di creazione, millisecondi) e users (id impiegato mappato al ruolo… |
yougile_get_project | Leggi un progetto per id: title, timestamp, users con i loro ruoli e reparti con la loro mappatura dei ruoli. Solo lettura |
yougile_create_project | Crea un progetto e restituisci il suo id. Dai gli impiegati che lavorano su di esso con i loro ruoli; un impiegato non elencato non può vedere il… |
yougile_update_project | Rinomina un progetto o cambia chi lavora su di esso. Solo i campi che passi cambiano; in users e departments un valore di - rimuove quel… |
yougile_list_boards | Elenca le bacheche: id, title, projectId e stickers (quali adesivi delle attività mostra la bacheca: scadenza, assegnatario, timeTracking, timer, cronometro… |
yougile_get_board | Leggi una bacheca per id: title, projectId e gli adesivi attivati per le sue attività. Solo lettura |
yougile_create_board | Crea una bacheca in un progetto e restituisci il suo id. Una nuova bacheca non ha colonne: aggiungile con yougile_create_column. Scrive su YouGile |
yougile_update_board | Rinomina una bacheca, spostala in un altro progetto o cambia quali adesivi mostrano le sue attività. Solo i campi che passi cambiano. Restituisce l'id della bacheca.… |
yougile_list_columns | Elenca le colonne di una bacheca: id, title, color (1 a 16) e boardId. Le attività vivono nelle colonne, quindi questo è il passo tra una bacheca e le sue… |
yougile_get_column | Leggi una colonna per id: title, color e la bacheca a cui appartiene. Solo lettura |
yougile_create_column | Crea una colonna su una bacheca e restituisci il suo id. Le nuove colonne vengono aggiunte dopo quelle esistenti. Scrive su YouGile |
yougile_update_column | Rinomina una colonna, cambia il suo colore o spostala in un'altra bacheca. Solo i campi che passi cambiano. Restituisce l'id della colonna. Scrive su YouGile |
yougile_list_tasks | Elenca le attività: id, title, columnId, description, completed, archived, assigned (id impiegati), deadline (millisecondi), timeTracking… |
yougile_get_task | Leggi un'attività per id con tutti i suoi campi: title, description (HTML), columnId, completed e completedTimestamp, archived, assigned… |
yougile_create_task | Crea un'attività in una colonna e restituisci il suo id. Senza una colonna, l'attività viene creata al di fuori di qualsiasi bacheca e raggiungibile solo per id, quindi sempre… |
yougile_update_task | Cambia un'attività: title, description, assegnatari, deadline, time tracking, checklist, adesivi, sottotask, colore, completata o archiviata. Solo i… |
yougile_move_task | Sposta un'attività in un'altra colonna, sulla stessa bacheca o su un'altra. Questo è come un'attività cambia il suo stato (Da fare, In corso, Fatto).… |
yougile_delete_task | Contrassegna un'attività come eliminata. Scompare dalla sua bacheca per tutti; può ancora essere letta con include_deleted. Installato disattivato… |
yougile_list_task_messages | Leggi la chat di un'attività o di una chat di gruppo: per id messaggio (anche il suo tempo di creazione in millisecondi), fromUserId, text, textHtml, label… |
yougile_send_task_message | Scrivi un messaggio nella chat di un'attività (o di una chat di gruppo) come proprietario della chiave. Tutti gli iscritti alla chat vengono notificati. Restituisce il… |
yougile_list_group_chats | Elenca le chat di gruppo dell'azienda: id, title, users (id impiegato mappato a impostazione di notifica) e userRoleMap. L'id è l'id della chat… |
yougile_list_string_stickers | Elenca gli adesivi personalizzati con un insieme di stati (priorità, tipo, stato e simili): id, name, icon e stati con id, name e colore. Un… |
yougile_get_string_sticker | Leggi un adesivo di stato per id: name, icon e i suoi stati (id, name, color). Solo lettura |
yougile_create_string_sticker | Crea un adesivo personalizzato con un insieme di stati, ad esempio Priorità con Alta e Bassa, e restituisci il suo id. Attivalo per una bacheca con… |
yougile_list_sprint_stickers | Elenca gli adesivi di sprint: id, name e stati, dove ogni stato è uno sprint con id, name, begin e end (secondi dal 1970; uno stato… |
yougile_get_sprint_sticker | Leggi un adesivo di sprint per id: name e i suoi sprint (id, name, begin e end in secondi dal 1970). Solo lettura |
yougile_create_sprint_sticker | Crea un adesivo di sprint con i suoi sprint e restituisci il suo id. Attivalo per una bacheca con yougile_update_board prima che le attività possano essere inserite in… |
yougile_list_webhooks | Elenca gli abbonamenti webhook dell'azienda: id, url, event (come task-created, o un pattern come task-*), disabled, lastSuccess e… |
Esempi di prompt
- "Quali attività sulla bacheca Marketing sono scadute, e chi le ha?"
- "Crea un'attività Prepara il report Q1 nella colonna In corso, scadenza venerdì prossimo, assegnata a Anna."
- "Sposta l'attività Copia della pagina di atterraggio nella colonna Fatto."
- "Cosa è stato discusso nella chat dell'attività Rilancio del sito web questa settimana?"
- "Mostra le attività dello sprint attuale per assegnatario."
FAQ
Come ottengo una chiave API di YouGile? YouGile non ha una pagina che mostra una chiave: ne crei una una volta con una chiamata API che prende il tuo login YouGile, password e id aziendale, e incolli la risposta in YOUGILE_API_KEY. Il connettore non vede mai la tua password. Una chiave non scade e agisce come l'impiegato che l'ha creata, quindi creala con un account che può aprire i progetti di cui hai bisogno.
Cosa copre? Progetti, bacheche e colonne, attività con scadenze, checklist, assegnatari e adesivi, spostamento delle attività tra colonne, messaggi di chat delle attività e di gruppo, dipendenti e reparti, adesivi personalizzati e di sprint, e gli abbonamenti webhook. L'intera azienda condivide 50 richieste al minuto tra tutte le sue chiavi.
Quali strumenti sono installati disattivati? yougile_delete_task. Attivalo nella pagina del connettore solo se l'IA dovrebbe usarlo; per il lavoro completato l'IA archivia l'attività invece.
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?