Podio MCP Server: campi ed elementi

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

Podio

Leggi una singola app Podio: le definizioni dei campi, una pagina di elementi filtrati e un singolo elemento. Accede con l'autenticazione app di Podio. Sola lettura.

Configurazione

La configurazione richiede circa 5 minuti. Ti servono una chiave API Podio (client id e secret), oltre all'App ID e all'App token dell'unica app Podio che l'AI deve leggere.

1. Apri https://podio.com/settings/api e genera una chiave API. Copia il client id in PODIO_CLIENT_ID e il client secret in PODIO_CLIENT_SECRET. Podio mostra il secret una sola volta.
2. Apri l'app Podio, poi il menu con la chiave inglese, quindi Developer. Copia l'App ID in PODIO_APP_ID e l'App token in PODIO_APP_TOKEN.
3. Installa il connettore ed esegui podio_get_app: accede e restituisce il nome dell'app e tutti i suoi campi.

Una sola app: i quattro valori fanno accedere il connettore come quell'app (autenticazione app di Podio). Il token di accesso dura 8 ore e il connettore accede di nuovo da solo quando scade. Le altre app dello spazio di lavoro restano fuori portata: una chiamata esterna all'app restituisce 403. L'API di Podio è pubblica, quindi funziona sia su AnythingMCP Cloud sia sulle istanze self-hosted.

Cosa legge: podio_get_app restituisce ogni campo con il relativo field_id, external_id, tipo, etichetta, flag di obbligatorietà e impostazioni, come gli id delle opzioni di categoria. podio_filter_items elenca una pagina di elementi con i valori dei loro campi. podio_get_item apre un singolo elemento tramite l'item_id numerico di quell'elenco (non l'app_item_id). La lettura di un elemento non lo segna come visualizzato, quindi non cancella le tue notifiche di Podio.

Filtri e pagine: l'AI filtra per external_id di un campo, oppure per title, created_on, created_by, last_edit_on, tags, item_id, app_item_id o external_id. I valori di categoria sono id di opzione; numeri, importi e date accettano un intervallo da/a, e le date possono essere relative, come -7d o +1w. I campi di testo non possono essere filtrati, tranne il titolo dell'elemento tramite title. Una pagina contiene 20 elementi per impostazione predefinita, fino a un massimo di 100.

Limiti: Podio conta le chiamate per chiave API all'ora: 250 per podio_filter_items e 1.000 per le altre letture. Oltre il limite Podio risponde con HTTP 420 (non 429) e l'AI attende prima di riprovare.

Errori comuni: 400 all'accesso significa che client id, client secret, App ID e App token non appartengono alla stessa app. 401 significa che Podio ha rifiutato il token di accesso: salva di nuovo il connettore in modo che acceda da capo e ricontrolla i quattro valori. 403 significa che la chiamata è uscita dall'unica app che questo token può leggere. 404 significa che non esiste alcuna app o elemento con quell'id.

Il connettore non crea né modifica elementi, non legge commenti o file, non apre altre app e non accede come utente Podio.

Prerequisiti: PODIO_APP_ID, PODIO_APP_TOKEN, PODIO_CLIENT_ID, PODIO_CLIENT_SECRET

Installa il connettore in locale

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

Apri http://localhost:3000/connectors/store, scegli Podio e incolla le variabili d'ambiente elencate nei Prerequisiti.

Strumenti disponibili

Prossimi passi

• Collega a Claude
• Collega a ChatGPT