← ClaudeAtlas

collega-api-googlelisted

Collega una NUOVA API Google (Search Console, Business Profile, YouTube Data, Merchant Center, Tag Manager, Calendar, Drive…) alle credenziali ADC condivise senza rompere gli MCP già funzionanti — e la usa subito via REST. Copre l'intera catena di ostacoli che si incontra ogni volta e i cui messaggi d'errore puntano quasi sempre nella direzione sbagliata: API disabilitata sul progetto, scope OAuth insufficienti, 'Questa app è bloccata', ambiti da dichiarare a mano nel consent screen, scadenza dei refresh token a 7 giorni. Include backup e rollback delle credenziali, test di non-regressione sugli MCP esistenti (Google Ads, GA4, GTM) e la regola del perimetro minimo di scope. Attiva quando l'utente dice 'colleghiamo l'API X di Google', 'voglio usare Search Console/Business Profile/YouTube da qui', 'aggiungiamo uno scope', 'ho un 403 insufficient authentication scopes', 'ACCESS_TOKEN_SCOPE_INSUFFICIENT', 'Questa app è bloccata', 'devo rifare il login gcloud', 'mi chiede di ri-autenticarmi ogni settimana', 'serve
SalvatoreSalernods/collega-api-google · ★ 0 · API & Backend · score 70
Install: claude install-skill SalvatoreSalernods/collega-api-google
# Collega una nuova API Google Il percorso completo da "questa API Google mi servirebbe" a "la sto chiamando", **senza rompere quello che già funziona**. > **Il rischio non è l'API nuova. È l'ADC.** Le credenziali Application Default sono condivise > fra tutti gli MCP Google configurati sulla macchina: un login fatto male li rompe tutti > insieme, in silenzio, e te ne accorgi giorni dopo. Il grosso di questa skill serve a > evitare quello. ## Il perimetro: cosa fa questa skill, e cosa presuppone Fa una cosa: **aggiungere un'API a credenziali ADC condivise, con backup e verifica dei permessi.** Presuppone cioè che più strumenti sulla stessa macchina usino lo stesso file ADC — il caso normale di chi installa gli MCP ufficiali di Google (`google-ads-mcp`, `analytics-mcp`), che per default si autenticano così. Non è l'unica architettura possibile. Ma prima di proporre alternative, ricorda che **l'utente non ha scelto di condividere l'ADC**: è ciò che si ottiene non facendo niente di speciale, perché `gcloud` scrive un file solo e gli MCP ufficiali leggono quel file. Non trattarlo come un errore suo. ### Gate: cosa tenere insieme e cosa isolare **Le chiavi che aprono solo per guardare possono stare nello stesso mazzo. Quelle che aprono per cambiare stanno da sole.** Il motivo è che nell'ADC condiviso ogni strumento eredita i permessi di tutti gli altri: uno scope di scrittura ce l'hanno tutti, non solo chi ne ha bisogno. **Quando l'utente chiede di aggiungere uno scope di