Collegare Pipefy MCP a Microsoft Copilot

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, fai clic su Connectors → Pipefy, incolla le tue credenziali, genera una chiave API MCP — fatto. Niente Docker, niente git clone, nessun server locale.

Pipefy + Microsoft Copilot

Piattaforma di gestione del lavoro Pipefy: organizzazioni, pipe (flussi di lavoro), card e fasi tramite l'API GraphQL. Elenca le pipe che un assistente AI può vedere, segui le card mentre avanzano tra le fasi e leggi i valori dei campi delle card.

Prerequisiti

Consulta le istruzioni complete di configurazione incluse nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

PIPEFY_API_TOKEN

Passo 1 — Ottieni le credenziali

La configurazione richiede pochi minuti. Ti servono un account Pipefy e un token API.

1. Apri https://app.pipefy.com/tokens, fai clic su Generate new token, assegna una descrizione e salva. Usa il token più lungo mostrato lì. Per la produzione, Pipefy consiglia invece un token di Service Account (vedi la pagina Authentication nella documentazione per sviluppatori di Pipefy).
2. Incolla il token in PIPEFY_API_TOKEN. Il connettore lo invia come bearer token a ogni chiamata.
3. Installa il connettore ed esegui pipefy_list_organizations: elenca le organizzazioni che il token può vedere e serve anche a verificare che il token funzioni.

Cosa legge: le tue organizzazioni, le pipe (flussi di lavoro) di un'organizzazione e una singola pipe con il conteggio delle card, le fasi, i campi del modulo iniziale e le etichette. Elenca le card di una pipe con titolo, flag di completamento, data di aggiornamento, fase corrente e assegnatari, apre una singola card con tutti i valori dei campi e mostra una fase con il relativo numero di card e i suoi campi. Un percorso tipico è pipefy_list_organizations, pipefy_list_pipes, pipefy_get_pipe (per scoprire gli id delle fasi), pipefy_list_cards e pipefy_get_card.

Id: tutti gli id di Pipefy sono numeri. L'id di una pipe è il numero nell'URL della pipe, ad esempio 301234567 in https://app.pipefy.com/pipes/301234567, e gli id di card, fasi e organizzazioni funzionano allo stesso modo.

Limiti: pipefy_list_cards restituisce 25 card per pagina per impostazione predefinita e al massimo 50, il massimo che Pipefy restituisce per richiesta. Quando pageInfo.hasNextPage è true, l'AI passa pageInfo.endCursor come after per ottenere la pagina successiva. Pipefy ha inoltre una quota mensile di chiamate API che dipende dal tuo piano, e una chiamata a un tool equivale a una chiamata API.

Il connettore è di sola lettura: non crea, non sposta e non aggiorna card, e non cerca tra le card (le scorre invece pagina per pagina).

Passo 2 — Installa l'adapter

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 Pipefy.
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.

Tool disponibili

FAQ

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

• Pagina di presentazione del connettore
• Collegalo a Claude
• Collegalo a ChatGPT