What is MCP?
MCP, o Model Context Protocol, è uno standard che permette ai client AI di connettersi a prodotti esterni. Invece di chiedere all’assistente di indovinare come funziona Ocoya, colleghi l’assistente a Ocoya MCP e lui può scoprire strumenti tipizzati per le azioni supportate.
Ocoya MCP espone strumenti per brand, publishing, brand, Studio e workflow dopo che l’utente approva l’accesso OAuth.
AI client connects
Claude, ChatGPT, Codex, VS Code o un altro client compatibile con MCP si connette a https://mcp.ocoya.com tramite Streamable HTTP MCP.
User approves access
Ocoya apre un flusso di approvazione OAuth in cui l’utente effettua l’accesso, rivede i permessi e seleziona i brand a cui il client può accedere.
Ocoya tools become available
Il client approvato può creare e gestire post, programmare contenuti, applicare il contesto del brand ed eseguire workflow all’interno dei brand selezionati.
Why use MCP for Ocoya?
MCP è utile quando vuoi che un assistente AI esegua azioni di prodotto in modo diretto e sicuro:
- L’assistente può scoprire gli strumenti di Ocoya invece di inventare chiamate API.
- Gli utenti approvano l’accesso tramite OAuth invece di copiare API key.
- L’accesso ai brand è limitato ai brand selezionati durante l’approvazione.
- Le chiamate agli strumenti restituiscono dati strutturati che i client possono usare in azioni successive.
What Ocoya exposes
Ocoya MCP offre ai client approvati strumenti per:
| Area | Cosa può fare l’assistente |
|---|---|
| Account and brand | Identificare l’utente autorizzato ed elencare i brand approvati. |
| Social profiles | Elencare i canali collegati e avviare nuovi flussi di connessione social. |
| Posts | Creare, ispezionare, aggiornare, programmare, pubblicare ed eliminare gruppi di post. |
| AI drafts | Generare bozze di post modificabili a partire da prompt e contesto visivo opzionale. |
| Creative context | Elencare librerie di hashtag e template di Studio. |
| Workflows | Elencare, ispezionare, abilitare, disabilitare ed eseguire workflow. |
Authentication model
Ocoya MCP usa OAuth. Un client non può usare Ocoya MCP con una Ocoya API key.
Quando il client ha bisogno per la prima volta di uno strumento Ocoya, apre Ocoya nel browser. L’utente effettua l’accesso, rivede i permessi richiesti, seleziona i brand consentiti e approva il client.
Il client riceve un access token di breve durata e può rinnovare l’accesso secondo il flusso OAuth. Se un brand non è stato selezionato durante l’approvazione, gli strumenti non possono accedere a quel brand.
MCP vs REST API
Usa MCP quando un client AI deve agire per conto dell’utente tramite linguaggio naturale e chiamate a strumenti.
Usa la REST API quando stai creando un’integrazione backend, un job schedulato o un’applicazione che chiama direttamente gli endpoint di Ocoya.