Cowork Connector – Automazione Open Source per Claude Cowork
Progetto open source MIT che accoda task in linguaggio naturale per Claude Cowork, eseguiti durante sessioni programmate senza consumare API a pagamento.
[chat-prompt] Cowork Connector – Case Study Automazione Open Source
Ho sviluppato e rilasciato Cowork Connector, un progetto open source (licenza MIT, repo su GitHub) che risolve un problema molto concreto per chi usa Claude Cowork: automatizzare task esterni senza dover aprire una seconda spesa in API a pagamento verso servizi come OpenAI.
Il problema risolto: Automatizzare flussi di lavoro con Claude Cowork spesso significa collegare API esterne a pagamento per far eseguire compiti fuori dalla sessione — con costi in token che crescono nel tempo e complessità di gestione chiavi, retry, rate limit. La soluzione sviluppata: Un sistema di coda che accetta task in linguaggio naturale e li fa eseguire a Claude stesso durante le sue sessioni programmate (skillschedule), usando gli strumenti già disponibili nel progetto Cowork — zero chiamate a modelli esterni a pagamento.
Caratteristiche tecniche:
- ✅ Due backend a scelta: locale (Python 3 standard library + SQLite, zero deploy) o remoto (PHP 7.4+ + SQLite su server esterno)
- ✅ Coda atomica: ogni task prelevato in modo esclusivo, nessuna esecuzione duplicata
- ✅ Tracciamento completo: status, log, timestamp e tentativi configurabili per ogni task
- ✅ Protocollo
action_typepersonalizzabile: definisci tu le categorie di task che ti servono - ✅ Integrazione nativa con la skill
scheduledi Claude Cowork per cicli ricorrenti - ✅ Open source MIT: codice modificabile e riutilizzabile anche in progetti commerciali
Se vuoi vedere il codice, contribuire o semplicemente installarlo nel tuo progetto Cowork, il repository è pubblico su GitHub con licenza MIT: puoi usarlo, modificarlo e integrarlo liberamente, mantenendo l'avviso di copyright originale. [/chat-prompt]
Cowork Connector – Automazione Open Source per Claude Cowork
---
🎯 La Sfida: Automatizzare Cowork Senza Pagare Due Volte
Chi usa Claude Cowork per il lavoro quotidiano prima o poi si scontra con lo stesso bisogno: far reagire il sistema a qualcosa che succede fuori dalla sessione — un file nuovo, un evento su un altro sistema, un task ricorrente da eseguire in autonomia.
La soluzione più immediata a cui si pensa di solito è collegare un'API esterna a pagamento (OpenAI o un altro provider) per orchestrare questi eventi. Funziona, ma comporta due problemi concreti:
- Costi crescenti: ogni chiamata consuma token su un servizio a pagamento, oltre a quello che già si spende per Claude stesso.
- Complessità inutile: gestione di chiavi API, retry, rate limit, per un lavoro che Claude Cowork potrebbe già svolgere da solo con gli strumenti che ha a disposizione nella sessione.
schedule, perché pagare un'altra API per fargli eseguire compiti che potrebbe già fare lui, semplicemente sapendo cosa fare e quando?
---
💡 La Soluzione: Una Coda di Task in Linguaggio Naturale
Cowork Connector risponde a questa domanda con un'architettura minimale: un sistema di coda dove si accodano istruzioni in linguaggio naturale, che Claude preleva ed esegue durante le sessioni programmate, usando esclusivamente gli strumenti già disponibili nel progetto Cowork.
Come funziona, in sintesi:- Si scrive un'istruzione in linguaggio naturale (es. "controlla la cartella X e genera un riepilogo").
- Il task viene accodato — in locale via SQLite o su un server remoto tramite
core/tasks.php. - Alla sessione schedulata successiva, Claude preleva il task, lo esegue con gli strumenti disponibili e ne registra l'esito.
- Stato, log e tentativi restano tracciati per ogni singolo task.
---
🚀 Funzionalità Chiave
Due Backend, Secondo l'Esigenza
Backend locale — Python 3 (solo libreria standard) + SQLite, tutto dentro la cartella del progetto Cowork. Zero deploy: la scelta più rapida per flussi interni, senza esporre nulla verso l'esterno. Backend remoto — PHP 7.4+ + SQLite su un server esterno proprio, concore/tasks.php caricato via FTP/SFTP e protetto da un token generato. Necessario quando sistemi esterni (un sito, un webhook, un altro processo) devono accodare task per Claude Cowork da fuori il progetto locale.
Coda Atomica e Tracciamento Completo
Ogni task viene prelevato in modo esclusivo da un solo ciclo di esecuzione: se più cicli schedulati si sovrappongono, nessun task viene eseguito due volte. Ogni esecuzione mantiene stato (in coda, in esecuzione, completata, fallita), log testuale, timestamp e un numero di tentativi configurabile in caso di errore.
Protocollo action_type Personalizzabile
Non esiste un elenco fisso di categorie di task: si definisce liberamente il protocollo action_type più adatto al proprio flusso di lavoro — report, notifiche, sincronizzazioni, pubblicazioni — e si istruisce Claude su come comportarsi per ciascun tipo, tramite il file CLAUDE.md del progetto.
Integrazione con la Skill schedule
Cowork Connector non sostituisce lo scheduling di Claude Cowork: si integra con la skill schedule già disponibile, che fa partire i cicli ricorrenti durante i quali la coda viene letta ed eseguita.
---
🛠️ Stack Tecnologico
- Python 3 (libreria standard) — client e coda del backend locale
- PHP 7.4+ — API
core/tasks.phpdel backend remoto - SQLite — persistenza della coda, sia locale sia remota
- Claude Cowork — motore di esecuzione dei task, tramite la skill
schedule
---
📦 Open Source, Licenza MIT
Cowork Connector non è un prodotto in vendita: è uno strumento che uso ogni giorno, reso pubblico perché il problema che risolve — automatizzare Claude Cowork senza aprire una seconda spesa in API a pagamento — è comune a chiunque usi Cowork per lavoro reale.
La licenza MIT permette di usare, modificare e integrare il codice anche in progetti commerciali, mantenendo l'avviso di copyright originale. Contributi, issue e pull request sono benvenuti.
Codice pubblico · Licenza MIT · Contributi benvenuti
---
📞 Vuoi Automatizzare Claude Cowork Nel Tuo Progetto?
Se usi Claude Cowork per il lavoro quotidiano e vuoi automatizzare task esterni senza gestire chiavi API a pagamento, Cowork Connector è pronto da clonare e configurare. Ho scritto anche una guida pratica passo-passo e un articolo che racconta il ragionamento dietro il progetto: