Collegare Claude con MCP

Connettere Claude a Orange Engine

Il connettore MCP remoto consente a Claude di chiamare direttamente strumenti dell'hub anche quando la rete del suo ambiente di esecuzione codice è limitata. Il servizio MCP è protetto dallo stesso token dei client API e applica gli stessi scope. È un connettore privato personalizzato, non un'integrazione pubblicata nel catalogo Anthropic.

Configurazione

1. In Claude apri **Personalizza → Connettori → Aggiungi → Connettore personalizzato**. Nei piani Team o Enterprise potrebbe doverlo aggiungere prima un proprietario dell'organizzazione. 2. Nome: `Orange Engine Hub`. 3. URL del server: `https://orangeengine.layoutdiprova.it/wp-json/orangeengine/v1/mcp`. 4. Scegli **Nessun accesso / No sign in** se richiesto e, in **Request headers**, aggiungi `Authorization` con valore `Bearer TOKEN`, sostituendo `TOKEN` con il token esistente dell'hub. Non includere virgolette o parentesi. Il token va nel campo protetto del connettore, non nel suo URL. 5. Salva, collega e abilita il connettore nella conversazione. Chiedi a Claude di elencare gli asset e poi di creare una voce roadmap di prova, se il token ha lo scope adatto.

In WordPress, **Orange Engine → Client API** consente di creare, controllare e revocare token. Lo scope `admin` consente tutte le operazioni; altri scope limitano le singole operazioni. Il token è visibile solo alla creazione. Se il connettore non può essere configurato con header personalizzati nel tuo piano, occorre un metodo di autenticazione o un ambiente Claude diverso: non è sufficiente inserire il token nell'URL.

Strumenti disponibili

Il connettore espone strumenti per cercare, leggere, creare, modificare e ritirare asset; elencare e creare tipi; gestire progetti e roadmap; leggere e aggiornare release; leggere manifest e generare URL di download. Le letture di bozze e contenuti privati tramite `context=edit` richiedono `assets:write` per gli asset, `projects:write` per i progetti e `roadmap:write` per la roadmap. I download di asset privati non sono ancora disponibili.

`list_media` elenca gli allegati WordPress e può filtrarli per nome (`search`) e tipo (`mime_type`). `import_asset_zip`, `import_project_zip` e `import_release_zip` copiano uno ZIP già caricato nei Media nell'archivio privato e creano una versione. `upload_media_base64` consente di caricare file ZIP o immagini fino a **4 MiB** tramite il connettore; per ZIP con binari engine/progetto specifica `kind=release` o `kind=project` e lo scope corrispondente. L'invio di file in base64 può essere limitato anche dall'interfaccia e dalla dimensione del contesto di Claude. Per file più grandi, caricali nella libreria Media e chiedi a Claude di importarli usando l'ID dell'allegato. I file nella libreria Media possono essere pubblicamente accessibili; la copia usata dall'hub è privata.

La creazione delle versioni richiede ZIP validi. Gli archivi 7z vanno convertiti in ZIP prima dell'importazione. Ogni pacchetto viene controllato, copiato e accompagnato da SHA-256; i download usano URL temporanei. `withdraw_*` ritira un contenuto o una versione senza cancellare automaticamente la cronologia. `update_asset_version` aggiorna compatibilità, piattaforme e registro modifiche oppure ripristina una versione con `deprecated=false`, senza sostituire il file.

Verifiche e limiti

Il connettore implementa MCP Streamable HTTP senza sessione, protocollo `2025-06-18`, con risposte JSON e autenticazione Bearer a ogni richiesta. Le funzioni richiamano le API del plugin e rispettano i loro controlli; il connettore non rende disponibili password WordPress, SQL arbitrario o URL arbitrari. La configurazione finale dell'account Claude deve essere eseguita nell'interfaccia di Claude: l'hub non può abilitarla al posto tuo.

Caricamento privato a blocchi

Per un client MCP che può inviare dati in modo programmatico, `start_package_upload` apre un trasferimento privato per `kind=asset`, `project` o `release`. Specifica la dimensione totale in byte, la versione SemVer e, facoltativamente, lo SHA-256 atteso; indica anche l'UUID asset, l'ID progetto o i dati identificativi della release secondo il tipo. Il client invia sequenzialmente `upload_package_chunk` con `upload_id`, `offset` e `data_base64`. Ogni blocco può contenere al massimo 512 KiB di dati decodificati. `package_upload_status` restituisce l'offset corrente; se una risposta si perde, riprendi da quell'offset. `finish_package_upload` verifica archivio e checksum e pubblica la versione; `cancel_package_upload` elimina i dati temporanei.

Il limite iniziale per pacchetto è 1 GiB, configurabile dal filtro `orangeengine_max_upload_bytes`; le richieste a blocchi sono indipendenti dal limite PHP di una singola richiesta. I blocchi sono privati, associati al client che ha iniziato il trasferimento e scadono dopo sei ore. La pulizia degli upload scaduti dipende da WP-Cron. La verifica finale e la copia sono sincrone: su file grandi possono richiedere tempo ed essere limitate dai timeout e dallo spazio disco. L'invio di dati base64 attraverso la normale interfaccia testuale di Claude può comunque essere limitato dalla dimensione del contesto: usare un client MCP programmatico quando disponibile, oppure caricare prima lo ZIP nei Media.