Guida rapida

Ci sono due modalità di autenticazione: un flusso OAuth con un clic, consigliato, oppure una chiave API manuale.

1. Aggiungi Vibiz al tuo client

Punta il tuo client MCP all’URL del server Vibiz. È tutta l’informazione di cui ha bisogno qualsiasi client.

https://mcp.vibiz.ai/mcp

• In Claude, usa Settings → Connectors → Add custom connector.
• In Cursor, aggiungilo in Settings → MCP.
• In Claude Code, esegui npx @vibiz/vibiz. Installa il plugin ufficiale, con gli slash command, un subagent e un promemoria post-commit, e la connessione MCP in un solo passaggio. Vedi la pagina di Claude Code.

2. Accedi a Vibiz

Il tuo client apre una scheda del browser su vibiz.ai. Accedi con lo stesso account che usi per l’app. Approva la connessione e il browser restituisce la sessione al tuo client.

3. Verifica la connessione

Gli strumenti Vibiz ora dovrebbero comparire nel selettore di strumenti del tuo client. Prova un prompt come "genera un’immagine pubblicitaria per il nostro prodotto principale" per confermare.

Manuale: chiave API

Preferisci una credenziale statica? Genera un token dalla pagina Developer del tuo workspace: accedi a vibiz.ai, poi apri Developer → API keys e aggiungilo come header Bearer. Usa questa modalità per agenti headless, CI o client che non supportano OAuth.

{
  "mcpServers": {
    "vibiz": {
      "url": "https://mcp.vibiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VIBIZ_API_KEY"
      }
    }
  }
}

Verificalo direttamente con curl:

curl https://mcp.vibiz.ai/mcp \
  -H "Authorization: Bearer YOUR_VIBIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Toolset

Una nuova connessione carica il toolset core: creatività per annunci, growth report, configurazione del brand, fatturazione e le principali letture. Aggiungi altri strumenti aggiungendo ?toolsets= all’URL del server, oppure con l’header X-Vibiz-Toolsets nei client che supportano gli header:

https://mcp.vibiz.ai/mcp?toolsets=ads,social
https://mcp.vibiz.ai/mcp?toolsets=all

Toolset: core, ads, creatives, social, comms, crm, research, workspace, autonomy, sites. core già lancia o potenzia annunci, aggiunge annunci a un set di annunci esistente e ne imposta il budget; gli altri strumenti che spendono in annunci (riattivazione degli annunci, nuovi set di annunci, lanci in blocco, copie di campagne) si trovano in ads. Ognuno di questi chiede la tua approvazione prima di spendere. Aggiungi readonly=1 per un connettore che può solo leggere. Non sei sicuro di quale ti serva? Chiedilo all’assistant: lo strumento vibiz_find_capability trova qualsiasi strumento e indica il toolset che lo abilita.

Prossimi passi