Integrazione MCP

Il tuo Agendly, dentro
il tuo agente AI.

Porta agenti, campagne e appuntamenti nel tuo ambiente AI. L’autenticazione MCP avviene tramite OAuth: accedi al tuo account Agendly e autorizza il client, senza copiare chiavi API.

Streamable HTTP · OAuth · MCP
● ● ●agendly / mcp
Il tuo agente AI

ChatGPT, Codex, Claude Code e altri client MCP

AgendlyModel Context Protocol
Mostrami gli appuntamenti di domani.
Leggere e analizzarePreparare modificheContinuare nella dashboard
01 / LE POSSIBILITÀ

Cosa puoi fare

Descrivi quello che ti serve. Il client usa gli strumenti Agendly per leggere i dati del tuo account o preparare una modifica da verificare.

Leggere e analizzare

Consulta campagne, storico chiamate, contatti e appuntamenti. Chiedi totali, elenchi e report per periodo.

Preparare modifiche

Crea o aggiorna agenti, campagne, servizi per appuntamenti e altre risorse supportate tramite proposta e approvazione.

Continuare nella dashboard

Usa i link alla dashboard per pagamenti, collegamento degli account, caricamento di file e altri passaggi che richiedono il sito.

02 / IL COLLEGAMENTO

Dal login alla prima richiesta.

Collega il tuo account Agendly tramite OAuth, controlla i permessi e inizia a usare i tuoi dati dal tuo agente AI.

1

Accedi con OAuth

Il collegamento parte dal tuo client AI. Nella pagina Agendly che si apre nel browser, accedi e controlla i permessi prima di autorizzare. Al termine, torna al client per usare gli strumenti.

Gestisci le applicazioni collegate
Endpoint Streamable HTTP
https://api.agendly.ai/mcp

L’accesso può essere di sola lettura o includere le modifiche. Per modificare i dati serve il permesso di scrittura, oltre all’approvazione delle singole proposte. Puoi revocare il collegamento da Integrazioni → Integrazione API.

OAuth

Collega ChatGPT con OAuth

Accedi con il tuo account Agendly e autorizza i permessi: non serve copiare una chiave API.

L’aggiunta di server MCP personalizzati dipende dalle funzionalità del tuo account e dalle impostazioni del workspace ChatGPT.

  1. Aggiungi un server MCP personalizzato in ChatGPT.
  2. Inserisci https://api.agendly.ai/mcp come URL del server e scegli OAuth.
  3. Avvia il collegamento, accedi ad Agendly e controlla i permessi richiesti.
  4. Autorizza il collegamento, torna a ChatGPT e prova una delle richieste qui sotto.
2

Configura il tuo agente

Aggiungi un server MCP remoto con l’endpoint qui sopra e il trasporto Streamable HTTP. Avvia l’autenticazione OAuth dal client: si apre il browser per accedere ad Agendly e autorizzare il collegamento.

Usi Codex o Claude Code? Ecco le configurazioni e i passaggi per accedere con OAuth.

OPENAI

Codex

Aggiungi questa voce a ~/.codex/config.toml, conservando gli altri server MCP già configurati. Per OAuth basta l’URL del server.

~/.codex/config.toml
[mcp_servers.agendly]
url = "https://api.agendly.ai/mcp"

Esegui il login OAuth dal terminale. Segui il collegamento nel browser, accedi ad Agendly e autorizza i permessi richiesti. Poi avvia Codex.

Terminale · macOS / Linux
codex mcp login agendly
codex

In Codex, apri /mcp e verifica che agendly sia collegato. Puoi quindi provare una delle richieste qui sotto. Se il collegamento scade o viene revocato, ripeti il login.

Documentazione ufficiale MCP di Codex
ANTHROPIC

Claude Code

Crea o aggiorna .mcp.json nella cartella del progetto con questa voce. Se mcpServers esiste già, aggiungi agendly e conserva gli altri server. L’autenticazione avviene tramite OAuth.

.mcp.json
{
  "mcpServers": {
    "agendly": {
      "type": "http",
      "url": "https://api.agendly.ai/mcp"
    }
  }
}

Avvia Claude Code nella cartella del progetto. Quando richiesto, approva la configurazione MCP del progetto.

Terminale · macOS / Linux
claude

Apri /mcp in Claude Code, seleziona agendly e avvia l’autenticazione. Accedi ad Agendly nel browser, autorizza i permessi e torna a Claude Code per verificare il collegamento.

Documentazione ufficiale MCP di Claude Code
03 / LA PRIMA CONVERSAZIONE

Prova queste richieste

Una domanda è tutto quello che serve per iniziare. Prova uno di questi esempi nel tuo client.

01

“Usa Agendly per elencare le mie campagne e il loro stato attuale.”

02

“Mostrami gli appuntamenti di domani.”

03

“Analizza le chiamate degli ultimi sette giorni.”

04

“Prepara un servizio di 30 minuti chiamato Consulenza e mostrami la proposta prima di applicarla.”

Verifica le modifiche prima di applicarle

Le letture possono essere eseguite subito. Per le modifiche, chiedi al client di mostrare la proposta completa, con i nuovi testi e i valori prima e dopo. Dopo la tua approvazione esplicita, applica la proposta salvata. Puoi anche chiedere di annullare una proposta in attesa.

Il client esterno è responsabile della richiesta di approvazione. Collega solo client a cui affideresti l’accesso al tuo account. Le proposte scadono e potrebbe essere necessario prepararle di nuovo.

DA SAPERE

Domande sul collegamento

Quali agenti AI posso collegare?

Usa un client MCP che supporti Streamable HTTP e OAuth. Aggiungi https://api.agendly.ai/mcp e autorizza l’accesso con il tuo account Agendly. SSE legacy e stdio non sono supportati.

Perché ricevo un errore di autenticazione?

Apri la gestione MCP del client e ripeti l’autenticazione OAuth. Verifica di accedere all’account Agendly corretto e di autorizzare i permessi richiesti. Se il collegamento è stato revocato, autorizzalo di nuovo. Per applicare modifiche serve anche il permesso di scrittura.

Come rimuovo l’accesso?

Apri Integrazioni → Integrazione API in Agendly e revoca l’applicazione collegata. Poi rimuovi il server MCP dalla configurazione del client.